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}
You must replace {myapitoken} with your personal API key.

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.

CodeNameDescription
400Bad requestYou are trying too often. Please try again later.
400Bad requestYour parameters are invalid.
401UnauthorizedThe API key is invalid.
403UnauthorizedYour account is not active. Please contact support.
404Not foundThe 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

ParameterDescriptionExample
first_name First name of the person
string
Peter
last_nameLast name of the person
string
Burrous
full_nameFull name of the person
string
Peter Burrous
linkedin_urlThe LinkedIn url of the person
string
https://www.linkedin.com/in/*******
company_nameName of the company
string
Johnson & Johnson Insurance
company_websiteDomain of the company
string
http://www.jjins.com
emailBusiness email or personal email
string
example@domain.com

Attributes

AttributesDescriptionExample
arounddeal_idAroundDeal IDn7imnyaaba
name_firstFirst name of the personPeter
name_lastLast name of the personBurrous
name_fullFull name of the personPeter Burrous
email_businessBusiness email of the personexample@domain.com
email_directDirect email of the personexample@domain.com
phonePhone for this contact+1 123-456-****
mobileMobile for this contact+1 123-456-****
job_titleJob title of the personChief Marketing Officer
function_codeFunction Code of the personmarketing
function_nameFunction Name of the personMarketing
seniority_level_codeSeniority level code of the personcxo
seniority_level_nameSeniority level of the personCXO
country_codeCountry code of the personUnited States
country_nameCountry name of the personUnited States
stateState of the personNew York
cityCity of the personNew York
linkedin_urlThe LinkedIn url of the personhttps://www.linkedin.com/in/*******
twitter_urlThe Twitter url of the personhttps://twitter.com/xxxx
arounddeal_company_idAroundDeal company idt5yllbiqxl
company_nameName of the companyJohnson & Johnson Insurance
company_logo_urlName of the companyhttps://*******
company_industry_idIndustry id of the companyInsurance
company_industry_nameIndustry name of the companyInsurance
company_country_codeCountry code of the companyus
company_country_nameCountry name of the companyUnited States
company_stateState of the companyNew York
company_cityCity of the companyNew York
company_founded_yearFounded year of the company1930
company_headcount_codeHeadcount code of the companyd
company_headcount_nameHeadcount name of the company51-200
company_websiteWebsite of the companyhttp://jjins.com
company_linkedin_urlThe LinkedIn url of the companyhttps://www.linkedin.com/company/*****
company_phonePhone of the company+12 345 ******
company_overviewOverview of the companyFounded 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

ParameterDescriptionExample
nameName of the company
string
Apple
websiteWebsite of the company
string
Apple.com
linkedin_urlCompany linkedin url
string
https://www.linkedin.com/company/apple/

Attributes

AttributesDescriptionExample
arounddeal_idAroundDeal idt5yllbiqxl
nameName of the companyAroundDeal
logo_urlThe logo url of the companyhttps://******
industry_idIndustry of the company27
industry_nameIndustry name of the companyComputer Software、Internet
country_codeCountry code of the companycn
country_nameCountry name of the companyChina
stateState of the companyShanghai
cityCity of the companyShanghai
founded_yearFounded year of the company2017
headcount_codeHeadcount code of the companyc
headcount_nameHeadcount name of the company11-50
websiteWebsite of the companyhttps://www.arounddeal.com
linkedin_urlCompany Linkedin url of the companyhttps://www.linkedin.com/company/arounddeal
phonePhone of the company+1 843-577-****
overviewAn overview of the companyAroundDeal 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"
        }
    }
{
        "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."
                }
            ]
        }
    }
{
        "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

ParameterDescriptionExample
arounddeal_idAroundDeal ID
array of strings
q6nmhywykk

Attributes

AttributesDescriptionExample
arounddeal_idAroundDeal IDn7imnyaaba
name_firstFirst name of the personPeter
name_lastLast name of the personBurrous
name_fullFull name of the personPeter Burrous
email_businessBusiness email of the personexample@domain.com
email_directDirect email of the personexample@domain.com
phonePhone for this contact+1 123-456-****
mobileMobile for this contact+1 123-456-****
job_titleJob title of the personChief Marketing Officer
function_codeFunction Code of the personmarketing
function_nameFunction Name of the personMarketing
seniority_level_codeSeniority level code of the personcxo
seniority_level_nameSeniority level of the personCXO
country_codeCountry code of the personUnited States
country_nameCountry name of the personUnited States
stateState of the personNew York
cityCity of the personNew York
linkedin_urlThe LinkedIn url of the personhttps://www.linkedin.com/in/*******
twitter_urlThe Twitter url of the personhttps://twitter.com/xxxx
arounddeal_company_idAroundDeal company idt5yllbiqxl
company_nameName of the companyJohnson & Johnson Insurance
company_logo_urlName of the companyhttps://*******
company_industry_idIndustry id of the companyInsurance
company_industry_nameIndustry name of the companyInsurance
company_country_codeCountry code of the companyus
company_country_nameCountry name of the companyUnited States
company_stateState of the companyNew York
company_cityCity of the companyNew York
company_founded_yearFounded year of the company1930
company_headcount_codeHeadcount code of the companyd
company_headcount_nameHeadcount name of the company51-200
company_websiteWebsite of the companyhttp://jjins.com
company_linkedin_urlThe LinkedIn url of the companyhttps://www.linkedin.com/company/*****
company_phonePhone of the company+12 345 ******
company_overviewOverview of the companyFounded 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

AttributesDescriptionExample
nameName of the userSteph Zhang
emailEmail of the userexample@domain.com
levelPlan of the userEnterprise
creditsUser's current balance in credits2315
level_time_expiredDays till the end of subscription2022-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"
        }
    }