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/v1/

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/v1/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 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/v1/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 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
email Business email or personal email
string
example@domain.com

Attributes

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" ] } }

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 1 credit.

The enrichment endpoint also charges credits if you pass the same information multiples times.

HTTP request

POST  https://api.arounddeal.com/v1/company/enrich

Parameters

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

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.

HTTP request

POST  https://api.arounddeal.com/v1/people/search

Parameters

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

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"
            }
        ]
    }
}
                                    

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/v1/people/lookup

Parameters

Parameter Description Example
ad_id AroundDeal ID
array of strings
n7imnyaaba

Attributes

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"
            }
        ]
    }
}
                                    

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/v1/account

Attributes

Attributes Description Example
name Name of the user Steph Zhang
email 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"
    }
}