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!
We would be happy to see if we can build it into our API.
API Endpoint
https://api.arounddeal.com/v1/
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/v1/account" -H "Authorization:Bearer {myapitoken}"
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 | 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. |
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.
POST https://api.arounddeal.com/v1/people/enrich
Parameter | Description | Example |
---|---|---|
first_name |
First name of the person
string |
Peter |
last_name | Last name of the person string |
Burrous |
full_name | Name of the person string |
Peter Burrous |
contact_linkedin_url | The LinkedIn url of the person string |
https://www.linkedin.com/in/******* |
company | 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 | Description | Example |
---|---|---|
first_name | First name of the person | Peter |
last_name | Last name of the person | Burrous |
full_name | Name of the person | Peter Burrous |
business_email | Business email of the person | example@domain.com |
personal_email | Personal email of the person | example@domain.com |
phone | Phone for this contact | +1 123-456-**** |
tel | Tel for this contact | +1 123-456-**** |
title | Title of the person | Chief Marketing Officer |
job_level | Person job level to filter by View all allowed values |
cxo |
function | Person job function to filter by View all allowed values |
marketing |
contact_country | Country of the person | United States |
contact_city | City of the person | New York City |
contact_location | Location of the person | United States |
contact_linkedin_url | The LinkedIn url of the person | https://www.linkedin.com/in/******* |
contact_twitter_url | The Twitter url of the person | https://twitter.com/xxxx |
company | Company of the person | Johnson & Johnson Insurance |
company_industry | Company Industry to filter by View all allowed values |
Insurance |
company_country | Country of the company | United States |
company_city | City of the company | Mount Pleasant |
company_location | Location of the company | Mount Pleasant, United States |
company_founded_in | Founded in of the company | 1930 |
company_employee | Employees of the company | 164 |
company_website | Domain of the company | http://www.jjins.com |
company_linkedin_url | Company Linkedin url of the company | https://www.linkedin.com/company/johnson-&-johnson-insurance |
company_phones | Phones of the company | +1 843-577-**** |
company_public_email | Public email of the company | marketing@jjins.com |
company_overview | An overview of the company | Founded in 1930, Johnson & Johnson, a family owned and operated business, has the experience of the past with a vision for the future. |
company_speciality | Speciality of the company | Insurance |
Response:
{
"data": {
"first_name": "Peter",
"last_name": "Burrous",
"full_name": "Peter Burrous",
"business_email": "example@domain.com",
"personal_email": "",
"phone": "",
"tel": "+1 843-577-****",
"title": "Chief Marketing Officer",
"job_level": "cxo",
"function": [
"marketing"
],
"contact_country": "United States",
"contact_city": "",
"contact_location": "United States",
"contact_linkedin_url": "https://www.linkedin.com/in/*******",
"contact_twitter_url": null,
"company": "Johnson & Johnson Insurance",
"company_industry": [
"Insurance"
],
"company_country": "United States",
"company_city": "Mount Pleasant",
"company_location": "Mount Pleasant, United States",
"company_founded_in": 1930,
"company_employee": 164,
"company_website": "http://www.jjins.com",
"company_linkedin_url": "https://www.linkedin.com/company/johnson-&-johnson-insurance",
"company_phones": "+1 843-577-****",
"company_public_email": "example@domain.com",
"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...",
"company_speciality": [
"Insurance",
"Professional",
"Commercial",
"Manufactured Homes",
"Recreational",
"Umbrella",
"Excess Flood",
"Standard",
"QBE",
"E&S Property & Casualty",
"Professional Liability",
"Worker's Compensation",
"Brokerage",
"Premium Financing",
"Claims",
"Agent",
"Agency",
"MGA",
"Quote",
"Rates"
]
}
}
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 1 credit.
The enrichment endpoint also charges credits if you pass the same information multiples times.
POST https://api.arounddeal.com/v1/company/enrich
Parameter | Description | Example |
---|---|---|
company_name | Name of the company string |
Apple |
company_website | Domain of the company string |
Apple.com |
linkedin_url | Company linkedin url string |
https://www.linkedin.com/company/apple/ |
Attributes | Description | Example |
---|---|---|
company_name | Name of the company | Johnson & Johnson Insurance |
company_country | Country of the company | United States |
company_city | City of the company | Mount Pleasant |
company_industry | Company Industry to filter by View all allowed values |
Insurance |
company_location | Location of the company | Mount Pleasant, United States |
company_founded_in | Founded in of the company | 1930 |
company_employee | Employees of the company | 164 |
company_website | Domain of the company | http://www.jjins.com |
company_linkedin_url | Company Linkedin url of the company | https://www.linkedin.com/company/johnson-&-johnson-insurance |
company_phones | Phones of the company | +1 843-577-**** |
company_public_email | Public email of the company | example@domain.com |
company_overview | An overview of the company | Founded in 1930, Johnson & Johnson, a family owned and operated business, has the experience of the past with a vision for the future. |
company_speciality | Speciality of the company | Insurance |
{
"data": {
"company_name": "AroundDeal",
"company_industry": [
"Computer Software",
"Internet"
],
"company_country": "Hong Kong SAR China",
"company_city": "Shanghai",
"company_location": "Shanghai, Hong Kong SAR China",
"company_founded_in": 2017,
"company_employee": 20,
"company_website": "https://www.arounddeal.com",
"company_linkedin_url": "https://www.linkedin.com/company/arounddeal",
"company_phones": "+852 2710 8200",
"company_public_email": "info@arounddeal.com",
"company_overview": "
AroundDeal is an Asia-focused lead generation platform that provides the most
comprehensive and accurate business contacts and companies info. Our technology and
services empower clients to build targeted lists, enrich CRM / Marketing ...",
"company_speciality": [
"Email Lookup",
"Email Lists",
"Email marketing",
"Find email",
"Lead generation",
"Business leads",
"Leads list",
"Find leads",
"B2B Marketing",
"Lookup Contacts",
"Manage and export lists",
"B2B Contact & Company Info",
"B2B Lead Generation",
"Sales Prospecting",
"Marketing",
"Asia Quality Prospects",
"Asia B2B Database"
]
}
}
Our prospector API lets you search and find contacts in the AroundDeal Database.
POST https://api.arounddeal.com/v1/people/search
Parameter | Description | Example |
---|---|---|
full_name | Name of the person string |
Peter Burrous |
contact_location | Contact country to filter by View all allowed values (Country name) array of strings |
United States |
function | Person job function to filter by View all allowed values array of strings |
marketing |
job_level | Person job level to filter by View all allowed values array of strings |
cxo |
job_title | Title of the person string |
Chief Marketing Officer |
contact_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_industry | Company Industry to filter by View all allowed values array of strings |
Insurance |
page | which results page to show (default is 1) integer |
1 |
per_page | number of results returned (default is 10, max is 100) integer |
10 |
Attributes | Description | Example |
---|---|---|
ad_id | AroundDeal id | n7imnyaaba |
name | Name of the person | Bill Ramos |
title | Title of the person | Director of Technical Product Management |
name_first | First name of the person | Bill |
name_last | Last name of the person | Ramos |
location | Location of the person | Seattle, Texas, United States |
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 |
email_business | Business email of the person | example@domain.com |
email_personal | Personal email of the person | example@domain.com |
phone_tel | Phone for this contact | +1 123-456-**** |
company_name | Name of the company | DB Best Technologies |
company_industry | Company Industry to filter by View all allowed values |
Information Technology & Services |
company_logo_url | Logo url of the company | - |
company_location | Location of the company | Mount Pleasant, United States |
company_emplyoee | Employees of the company | 164 |
company_website_url | Domain of the company | https://www.dbbest.com |
{
"data": {
"count": 460694,
"list": [
{
"ad_id": "n7imnyaaba",
"name": "Bill Ramos",
"title": "Director of Technical Product Management",
"name_first": "Bill",
"name_last": "Ramos",
"location": "Seattle, Texas, United States",
"linkedin_url": "https://www.linkedin.com/in/billramo",
"twitter_url": "https://twitter.com/billramo",
"email_business": "example@domain.com",
"email_personal": "example@domain.com",
"phone_tel": "+1 4*******",
"phone_mobile": "",
"company_name": "DB Best Technologies",
"company_logo_url": "",
"company_location": "Washington, United States",
"company_industry": [
"Information Technology & Services"
],
"company_emplyoee": 267,
"company_website_url": "https://www.dbbest.com"
}
]
}
}
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.
POST https://api.arounddeal.com/v1/people/lookup
Parameter | Description | Example |
---|---|---|
ad_id | AroundDeal ID array of strings |
n7imnyaaba |
Attributes | Description | Example |
---|---|---|
ad_id | AroundDeal ID | n7imnyaaba |
name | Name of the person | Bill Ramos |
title | Title of the person | Director of Technical Product Management |
name_first | First name of the person | Bill |
name_last | Last name of the person | Ramos |
location | Location of the person | Seattle, Texas, United States |
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 |
email_business | Business email of the person | example@domain.com |
email_personal | Personal email of the person | example@domain.com |
phone_tel | Phone for this contact | +1 123-456-**** |
company_name | Name of the company | DB Best Technologies |
company_industry | Company Industry to filter by View all allowed values |
Information Technology & Services |
company_logo_url | Logo url of the company | - |
company_location | Location of the company | Mount Pleasant, United States |
company_emplyoee | Employees of the company | 164 |
company_website_url | Domain of the company | https://www.dbbest.com |
Response:
{
"data": {
"success": 1,
"data": [
{
"ad_id": "n7imnyaaba",
"name": "Bill Ramos",
"title": "Director of Technical Product Management",
"name_first": "Bill",
"name_last": "Ramos",
"location": "Seattle, Texas, United States",
"linkedin_url": "https://www.linkedin.com/in/billramo",
"twitter_url": "https://twitter.com/billramo",
"email_business": "example@domain.com",
"email_personal": "example@domain.com",
"phone_tel": "+1 123-456-789",
"phone_mobile": "",
"company_name": "DB Best Technologies",
"company_logo_url": "",
"company_location": "Washington, United States",
"company_industry": [
"Information Technology & Services"
],
"company_emplyoee": 267,
"company_website_url": "https://www.dbbest.com"
}
]
}
}
The user account API allows you to retrieve your account information. The response will return your basic usage and profile information.
GET https://api.arounddeal.com/v1/account
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"
}
}