AroundDeal API Documentation
Introduction
Welcome to AroundDeal’s API! You can use this API to access all our API endpoints.
Our API is still under active development. It is subject to change without prior notice from AroundDeal. If you have any suggestions for API methods you'd like to see, please let us know!
Our main calls are:
We would be happy to see if we can build it into our API.
API Endpoint
https://api.arounddeal.com/v2/
Authentication
AroundDeal uses API keys to allow access to the API. You may request an API key here.
You will have to add your API Key to every call you make to our API. This parameter is always required. We'll return an error if the key is either missing or invalid.
Note that your API key is what identifies you and your usage, so please don’t share it with anyone outside of your organization.
Authorization: Bearer {myapitoken}
To authorize, use this code:
$ curl "https://api.arounddeal.com/v2/account" -H "Authorization:Bearer {myapitoken}"
Error
Our API uses conventional HTTP response codes to indicate the success or failure of an API request.
In case of an error, we will return the correspondent error code.
Code | Name | Description |
---|---|---|
400 | Bad request | You are trying too often. Please try again later. |
400 | Bad request | Your parameters are invalid. |
401 | Unauthorized | The API key is invalid. |
403 | Unauthorized | Your account is not active. Please contact support. |
404 | Not found | The requested endpoint was not found. |
People Enrichment API
The person API allows you to lookup a person based on their email or LinkedIn Link or domain + name or company name + name. For precise results it’s recommended to use an email or LinkedIn Link.
You get a full overview of the person including name, job title, email, phone number, social links and more.
The enrichment API charges you credits for its usage. If a verified email is successfully returned, it will cost you 1 credit.
The enrichment endpoint also charges credits if you pass the same information multiples times.
HTTP request
POST https://api.arounddeal.com/v2/people/enrich
Parameters
Parameter | Description | Example |
---|---|---|
first_name | First name of the person string | Peter |
last_name | Last name of the person string | Burrous |
full_name | Full name of the person string | Peter Burrous |
linkedin_url | The LinkedIn url of the person string | https://www.linkedin.com/in/******* |
company_name | Name of the company string | Johnson & Johnson Insurance |
company_website | Domain of the company string | http://www.jjins.com |
Business email or personal email string | example@domain.com |
Attributes
Attributes | Description | Example |
---|---|---|
arounddeal_id | AroundDeal ID | n7imnyaaba |
name_first | First name of the person | Peter |
name_last | Last name of the person | Burrous |
name_full | Full name of the person | Peter Burrous |
email_business | Business email of the person | example@domain.com |
email_direct | Direct email of the person | example@domain.com |
phone | Phone for this contact | +1 123-456-**** |
mobile | Mobile for this contact | +1 123-456-**** |
job_title | Job title of the person | Chief Marketing Officer |
function_code | Function Code of the person | marketing |
function_name | Function Name of the person | Marketing |
seniority_level_code | Seniority level code of the person | cxo |
seniority_level_name | Seniority level of the person | CXO |
country_code | Country code of the person | United States |
country_name | Country name of the person | United States |
state | State of the person | New York |
city | City of the person | New York |
linkedin_url | The LinkedIn url of the person | https://www.linkedin.com/in/******* |
twitter_url | The Twitter url of the person | https://twitter.com/xxxx |
arounddeal_company_id | AroundDeal company id | t5yllbiqxl |
company_name | Name of the company | Johnson & Johnson Insurance |
company_logo_url | Name of the company | https://******* |
company_industry_id | Industry id of the company | Insurance |
company_industry_name | Industry name of the company | Insurance |
company_country_code | Country code of the company | us |
company_country_name | Country name of the company | United States |
company_state | State of the company | New York |
company_city | City of the company | New York |
company_founded_year | Founded year of the company | 1930 |
company_headcount_code | Headcount code of the company | d |
company_headcount_name | Headcount name of the company | 51-200 |
company_website | Website of the company | http://jjins.com |
company_linkedin_url | The LinkedIn url of the company | https://www.linkedin.com/company/***** |
company_phone | Phone of the company | +12 345 ****** |
company_overview | Overview of the company | Founded in 1930, Johnson & Johnson, a family owned and operated business... |
Response:
{
"data": {
"arounddeal_id": "q6nmhywykk",
"name_first": "Peter",
"name_last": "Burrous",
"name_full": "Peter Burrous",
"email_business": "*******@jjins.com",
"email_direct": "",
"phone": "+1 843-*******",
"mobile": "",
"job_title": "Chief Marketing Officer",
"function_code": "",
"function_name": "",
"seniority_level_code": "cxo",
"seniority_level_name": "CXO",
"country_code": "us",
"country_name": "United States",
"state": "",
"city": "",
"linkedin_url": "https://www.linkedin.com/in/peter-burrous-89740129",
"twitter_url": "",
"arounddeal_company_id": "w7tahcnbga",
"company_name": "Johnson & Johnson Insurance",
"company_logo_url": "",
"company_industry_id": [
42
],
"company_industry_name": [
"Insurance"
],
"company_country_code": "us",
"company_country_name": "United States",
"company_state": "Texas",
"company_city": "Mount Pleasant",
"company_founded_year": 1930,
"company_headcount_code": "d",
"company_headcount_name": "51 - 200",
"company_website": "http://jjins.com",
"company_linkedin_url": "https://www.linkedin.com/company/johnson-&-johnson-insurance",
"company_phone": "",
"company_overview": "Founded in 1930, Johnson & Johnson, a family owned and operated business, has the experience of the past with a vision for the future. Our business is built on a foundation of long-term relationships with our agents and companies. We are a technology and service driven sales organization committed to writing business with our agency partners. We are embedded in your community with state and territory managers allowing us to better understand your needs and to help grow your business.
Our people, service promise, products, and long-term committed agency partnerships, provide us with a vision for the future and enable us to find solutions to grow your business."
}
}
Company Enrichment API
The company API allows you to lookup a company profile based on their company name or LinkedIn Link or domain. For precise results it’s recommended to use a domain name.
You get a full overview of the company including industry, HQ, employee, overview, social links and more.
The enrichment API charges you credits for its usage. If a company profile is successfully returned, it will cost you 0.5 credit.
The enrichment endpoint also charges credits if you pass the same information multiples times.
HTTP request
POST https://api.arounddeal.com/v2/company/enrich
Parameters
Parameter | Description | Example |
---|---|---|
name | Name of the company string | Apple |
website | Website of the company string | Apple.com |
linkedin_url | Company linkedin url string | https://www.linkedin.com/company/apple/ |
Attributes
Attributes | Description | Example |
---|---|---|
arounddeal_id | AroundDeal id | t5yllbiqxl |
name | Name of the company | AroundDeal |
logo_url | The logo url of the company | https://****** |
industry_id | Industry of the company | 27 |
industry_name | Industry name of the company | Computer Software、Internet |
country_code | Country code of the company | cn |
country_name | Country name of the company | China |
state | State of the company | Shanghai |
city | City of the company | Shanghai |
founded_year | Founded year of the company | 2017 |
headcount_code | Headcount code of the company | c |
headcount_name | Headcount name of the company | 11-50 |
website | Website of the company | https://www.arounddeal.com |
linkedin_url | Company Linkedin url of the company | https://www.linkedin.com/company/arounddeal |
phone | Phone of the company | +1 843-577-**** |
overview | An overview of the company | AroundDeal is an Asia leading sales and marketing intelligence platform that provides comprehensive and accurate data about business contacts and companies info.... |
{
"data": {
"arounddeal_id": "t5yllbiqxl",
"name": "AroundDeal",
"logo_url": "https://assets.arounddeal.com/ms/img/others/ad-logo-docs.png",
"industry_id": [
4,
6
],
"industry_name": [
"Computer Software",
"Internet"
],
"country_code": "cn",
"country_name": "China",
"state": "Shanghai",
"city": "Shanghai",
"founded_year": 2017,
"headcount_code": "c",
"headcount_name": "11 - 50",
"website": "https://www.arounddeal.com",
"linkedin_url": "https://www.linkedin.com/company/arounddeal",
"phone": "",
"overview": "AroundDeal is an Asia leading sales and marketing intelligence platform that provides comprehensive and accurate data about business contacts and companies info. We currently have 110M+ contacts worldwide. Through targeted filters, customers are able to find leads in 1 click.
Our mission is to help our customers identify more sales opportunities, close more deals and accelerate growth.
Quick ways to find targeted accurate contacts directly with AroundDeal:
1. Chrome Extension: Install AroundDeal and find targeted contact & company info on LinkedIn and web domains in 1 click.
2. Prospector: Get 110M+ contacts and easily build targeted contacts lists to turn more prospects into customers.
3. Bulk Finder: Upload your targeted company names or domain names list, you will get you results of the targeted list with verified contacts.
5. Team Management: AroundDeal brings your team together to work, track, and collaborate on prospecting — all in one place.
6. Visitors: Find out what companies are visiting your website and engage them the right way at the right time.
7. Prospect Update Alert: Receive alerts when designated contacts change contacts or jobs.
8. Integration: Save contact lists directly to your CRM platform and enrich it instantly.
9. API: AroundDeal's API makes it easy to build targeted contact lists or enrich any system with our B2B database.
If you are looking for a tailor-made list of B2B prospects collected specifically according to your ideal customer profile, we offer a Prospector Service.
Who can Benefit from AroundDeal?
1. Marketing
2. Sales
3. Recruiting
Most Comprehensive Asia B2B Database
Our database has the highest coverage across all industries and countries in Asia! You can access 110M+ contacts worldwide and 20 million contacts in Asia.
1. 1M+ C-level execs in Asia
2. 6M+ execs in India
3. 700K+ execs in Indonesia
Contact Us:
1. Website: https://www.arounddeal.com
2. Email: support@arounddeal.com"
}
}
People Search
Our prospector API lets you search and find contacts in the AroundDeal Database.
HTTP request
POST https://api.arounddeal.com/v2/people/search
Parameters
Parameter | Description | Example |
---|---|---|
name | Name of the person array of strings | Peter Burrous |
country_code | Country code to filter by View all allowed values(Country Code) array of strings | United States |
function_code | Person job function code to filter by View all allowed values(Function Code) array of strings | Marketing |
seniority_level_code | Seniority level code to filter by View all allowed values(Seniority Level Code) array of strings | CXO |
contact_must_contain | Contact must contain of the person array of strings | email 、phone |
job_title | Job title of the person array of strings | Chief Marketing Officer |
linkedin_url | The LinkedIn url of the person array of strings | https://www.linkedin.com/in/******* |
skill | Skill of the person array of strings | coffee |
arounddeal_company_id | Company id of the person array of strings | w7tahcnbga |
company_name | Company name of the person array of strings | Johnson & Johnson |
company_industry_id | Company industry id to filter by View all allowed values(Industry ID) array of strings | Insurance |
company_country_code | Company country code to filter by View all allowed values (Country Code) array of strings | United States |
company_website | The domain of the company array of strings | http://jjins.com |
company_headcount_code | Company headcount code to filter by View all allowed values (Headcount Code) array of strings | 51-200 |
company_type_code | Company type code to filter by View all allowed values (Company type Code) array of strings | Public Company |
page | which results page to show (default is 1, max is 1000) integer | 1 |
per_page | number of results returned (default is 10, max is 100) integer | 10 |
Attributes
Attributes | Description | Example |
---|---|---|
arounddeal_id | AroundDeal ID | n7imnyaaba |
name_first | First name of the person | Peter |
name_last | Last name of the person | Burrous |
name_full | Full name of the person | Peter Burrous |
email_business | Business email of the person | example@domain.com |
email_direct | Direct email of the person | example@domain.com |
phone | Phone for this contact | +1 123-456-**** |
mobile | Mobile for this contact | +1 123-456-**** |
job_title | Job title of the person | Chief Marketing Officer |
function_code | Function Code of the person | marketing |
function_name | Function Name of the person | Marketing |
seniority_level_code | Seniority level code of the person | cxo |
seniority_level_name | Seniority level of the person | CXO |
country_code | Country code of the person | United States |
country_name | Country name of the person | United States |
state | State of the person | New York |
city | City of the person | New York |
linkedin_url | The LinkedIn url of the person | https://www.linkedin.com/in/******* |
twitter_url | The Twitter url of the person | https://twitter.com/xxxx |
arounddeal_company_id | AroundDeal company id | t5yllbiqxl |
company_name | Name of the company | Johnson & Johnson Insurance |
company_logo_url | Name of the company | https://******* |
company_industry_id | Industry id of the company | Insurance |
company_industry_name | Industry name of the company | Insurance |
company_country_code | Country code of the company | us |
company_country_name | Country name of the company | United States |
company_state | State of the company | New York |
company_city | City of the company | New York |
company_founded_year | Founded year of the company | 1930 |
company_headcount_code | Headcount code of the company | d |
company_headcount_name | Headcount name of the company | 51-200 |
company_website | Website of the company | http://jjins.com |
company_linkedin_url | The LinkedIn url of the company | https://www.linkedin.com/company/***** |
company_phone | Phone of the company | +12 345 ****** |
company_overview | Overview of the company | Founded in 1930, Johnson & Johnson, a family owned and operated business... |
{
"data": {
"count": 460694,
"list": [
{
"arounddeal_id": "q6nmhywykk",
"name_first": "Peter",
"name_last": "Burrous",
"name_full": "Peter Burrous",
"email_business": "*******@jjins.com",
"email_direct": "",
"phone": "+1 843-*******",
"mobile": "",
"job_title": "Chief Marketing Officer",
"function_code": "",
"function_name": "",
"seniority_level_code": "cxo",
"seniority_level_name": "CXO",
"country_code": "us",
"country_name": "United States",
"state": "",
"city": "",
"linkedin_url": "https://www.linkedin.com/in/peter-burrous-89740129",
"twitter_url": "",
"arounddeal_company_id": "w7tahcnbga",
"company_name": "Johnson & Johnson Insurance",
"company_logo_url": "",
"company_industry_id": [
42
],
"company_industry_name": [
"Insurance"
],
"company_country_code": "us",
"company_country_name": "United States",
"company_state": "Texas",
"company_city": "Mount Pleasant",
"company_founded_year": 1930,
"company_headcount_code": "d",
"company_headcount_name": "51 - 200",
"company_website": "http://jjins.com",
"company_linkedin_url": "https://www.linkedin.com/company/johnson-&-johnson-insurance",
"company_phone": "",
"company_overview": "Founded in 1930, Johnson & Johnson, a family owned and operated business, has the experience of the past with a vision for the future. Our business is built on a foundation of long-term relationships with our agents and companies. We are a technology and service driven sales organization committed to writing business with our agency partners. We are embedded in your community with state and territory managers allowing us to better understand your needs and to help grow your business.
Our people, service promise, products, and long-term committed agency partnerships, provide us with a vision for the future and enable us to find solutions to grow your business."
}
]
}
}
Company Search
Our prospector API lets you search and find contacts in the AroundDeal Database.
HTTP request
POST https://api.arounddeal.com/v2/company/search
Parameters
Parameter | Description | Example |
---|---|---|
name | Name of the company array of strings | AroundDeal |
industry_id | Company industry id to filter by View all allowed values(Industry ID) array of strings | Information Technology & Services |
country_code | Company country code to filter by View all allowed values (Country Code) array of strings | United States |
type_code | Company type code to filter by View all allowed values (Coampany type Code) array of strings | Public Company |
headcount_code | Headcount code to filter by View all allowed values (Headcount Code) array of strings | 51-200 |
website | The website of the company array of strings | https://www.arounddeal.com |
linkedin_url | The LinkedIn url of the company string | https://www.linkedin.com/in/******* |
page | which results page to show (default is 1, max is 1000) integer | 1 |
per_page | number of results returned (default is 10, max is 100) integer | 10 |
Attributes
Attributes | Description | Example |
---|---|---|
arounddeal_id | AroundDeal id | t5yllbiqxl |
name | Name of the company | AroundDeal |
logo_url | The logo url of the company | https://****** |
industry_id | Industry of the company | 27 |
industry_name | Industry name of the company | Computer Software、Internet |
country_code | Country code of the company | cn |
country_name | Country name of the company | China |
state | State of the company | Shanghai |
city | City of the company | Shanghai |
founded_year | Founded year of the company | 2017 |
headcount_code | Headcount code of the company | c |
headcount_name | Headcount name of the company | 11-50 |
website | Website of the company | https://www.arounddeal.com |
linkedin_url | Company Linkedin url of the company | https://www.linkedin.com/company/arounddeal |
phone | Phone of the company | +1 843-577-**** |
overview | An overview of the company | AroundDeal is an Asia leading sales and marketing intelligence platform that provides comprehensive and accurate data about business contacts and companies info.... |
{
"data": {
"count": 1,
"list": [
{
"arounddeal_id": "t5yllbiqxl",
"name": "AroundDeal",
"logo_url": "https://assets.arounddeal.com/ms/img/others/ad-logo-docs.png",
"industry_id": [
4,
6
],
"industry_name": [
"Computer Software",
"Internet"
],
"country_code": "cn",
"country_name": "China",
"state": "Shanghai",
"city": "Shanghai",
"founded_year": 2017,
"headcount_code": "c",
"headcount_name": "11 - 50",
"website": "https://www.arounddeal.com",
"linkedin_url": "https://www.linkedin.com/company/arounddeal",
"phone": "",
"overview": "AroundDeal is an Asia leading sales and marketing intelligence platform that provides comprehensive and accurate data about business contacts and companies info. We currently have 110M+ contacts worldwide. Through targeted filters, customers are able to find leads in 1 click.
Our mission is to help our customers identify more sales opportunities, close more deals and accelerate growth.
Quick ways to find targeted accurate contacts directly with AroundDeal:
1. Chrome Extension: Install AroundDeal and find targeted contact & company info on LinkedIn and web domains in 1 click.
2. Prospector: Get 110M+ contacts and easily build targeted contacts lists to turn more prospects into customers.
3. Bulk Finder: Upload your targeted company names or domain names list, you will get you results of the targeted list with verified contacts.
5. Team Management: AroundDeal brings your team together to work, track, and collaborate on prospecting — all in one place.
6. Visitors: Find out what companies are visiting your website and engage them the right way at the right time.
7. Prospect Update Alert: Receive alerts when designated contacts change contacts or jobs.
8. Integration: Save contact lists directly to your CRM platform and enrich it instantly.
9. API: AroundDeal's API makes it easy to build targeted contact lists or enrich any system with our B2B database.
If you are looking for a tailor-made list of B2B prospects collected specifically according to your ideal customer profile, we offer a Prospector Service.
Who can Benefit from AroundDeal?
1. Marketing
2. Sales
3. Recruiting
Most Comprehensive Asia B2B Database
Our database has the highest coverage across all industries and countries in Asia! You can access 110M+ contacts worldwide and 20 million contacts in Asia.
1. 1M+ C-level execs in Asia
2. 6M+ execs in India
3. 700K+ execs in Indonesia
Contact Us:
1. Website: https://www.arounddeal.com
2. Email: support@arounddeal.com"
}
]
}
}
Lookup Profile
The lookup profile API is used to lookup contact information for a prospect(profile). You can identify the profile using parameters like name, company name, title, or profile id (returned from search API).
The lookup profile API charges you credits for its usage. If a verified email is successfully returned, it will cost you 1 credit.
The prospector endpoint also charges credits if you pass the same information multiples times.
HTTP request
POST https://api.arounddeal.com/v2/people/lookup
Parameters
Parameter | Description | Example |
---|---|---|
arounddeal_id | AroundDeal ID array of strings | q6nmhywykk |
Attributes
Attributes | Description | Example |
---|---|---|
arounddeal_id | AroundDeal ID | n7imnyaaba |
name_first | First name of the person | Peter |
name_last | Last name of the person | Burrous |
name_full | Full name of the person | Peter Burrous |
email_business | Business email of the person | example@domain.com |
email_direct | Direct email of the person | example@domain.com |
phone | Phone for this contact | +1 123-456-**** |
mobile | Mobile for this contact | +1 123-456-**** |
job_title | Job title of the person | Chief Marketing Officer |
function_code | Function Code of the person | marketing |
function_name | Function Name of the person | Marketing |
seniority_level_code | Seniority level code of the person | cxo |
seniority_level_name | Seniority level of the person | CXO |
country_code | Country code of the person | United States |
country_name | Country name of the person | United States |
state | State of the person | New York |
city | City of the person | New York |
linkedin_url | The LinkedIn url of the person | https://www.linkedin.com/in/******* |
twitter_url | The Twitter url of the person | https://twitter.com/xxxx |
arounddeal_company_id | AroundDeal company id | t5yllbiqxl |
company_name | Name of the company | Johnson & Johnson Insurance |
company_logo_url | Name of the company | https://******* |
company_industry_id | Industry id of the company | Insurance |
company_industry_name | Industry name of the company | Insurance |
company_country_code | Country code of the company | us |
company_country_name | Country name of the company | United States |
company_state | State of the company | New York |
company_city | City of the company | New York |
company_founded_year | Founded year of the company | 1930 |
company_headcount_code | Headcount code of the company | d |
company_headcount_name | Headcount name of the company | 51-200 |
company_website | Website of the company | http://jjins.com |
company_linkedin_url | The LinkedIn url of the company | https://www.linkedin.com/company/***** |
company_phone | Phone of the company | +12 345 ****** |
company_overview | Overview of the company | Founded in 1930, Johnson & Johnson, a family owned and operated business... |
Response:
{
"data": {
"success": 1,
"data": [
{
"arounddeal_id": "q6nmhywykk",
"name_first": "Peter",
"name_last": "Burrous",
"name_full": "Peter Burrous",
"email_business": "*******@jjins.com",
"email_direct": "",
"phone": "+1 843-*******",
"mobile": "",
"job_title": "Chief Marketing Officer",
"function_code": "",
"function_name": "",
"seniority_level_code": "cxo",
"seniority_level_name": "CXO",
"country_code": "us",
"country_name": "United States",
"state": "",
"city": "",
"linkedin_url": "https://www.linkedin.com/in/peter-burrous-89740129",
"twitter_url": "",
"arounddeal_company_id": "w7tahcnbga",
"company_name": "Johnson & Johnson Insurance",
"company_logo_url": "",
"company_industry_id": [
42
],
"company_industry_name": [
"Insurance"
],
"company_country_code": "us",
"company_country_name": "United States",
"company_state": "Texas",
"company_city": "Mount Pleasant",
"company_founded_year": 1930,
"company_headcount_code": "d",
"company_headcount_name": "51 - 200",
"company_website": "http://jjins.com",
"company_linkedin_url": "https://www.linkedin.com/company/johnson-&-johnson-insurance",
"company_phone": "",
"company_overview": "Founded in 1930, Johnson & Johnson, a family owned and operated business, has the experience of the past with a vision for the future. Our business is built on a foundation of long-term relationships with our agents and companies. We are a technology and service driven sales organization committed to writing business with our agency partners. We are embedded in your community with state and territory managers allowing us to better understand your needs and to help grow your business.
Our people, service promise, products, and long-term committed agency partnerships, provide us with a vision for the future and enable us to find solutions to grow your business."
}
]
}
}
User Account API
The user account API allows you to retrieve your account information. The response will return your basic usage and profile information.
HTTP request
GET https://api.arounddeal.com/v2/account
Attributes
Attributes | Description | Example |
---|---|---|
name | Name of the user | Steph Zhang |
Email of the user | example@domain.com | |
level | Plan of the user | Enterprise |
credits | User's current balance in credits | 2315 |
level_time_expired | Days till the end of subscription | 2022-08-02 23:59:59 |
Response:
{
"data": {
"name": "Steph",
"email": "example@domain.com",
"level": "Enterprise",
"credits": 2315,
"level_time_expired": "2022-08-02 23:59:59"
}
}