NAV Navbar
shell
  • Introduction
  • Authentication
  • Methods
  • Errors
  • Introduction

    Welcome to the Enrichdata™ API! You can use our API to access the Enrichdata™ API endpoints, where you can enrich emails or domains.

    You can view code examples in the dark area to the right.

    If you need an API key go on Enrichdata, then generate an API key in the API section.

    Authentication

    Main endpoint, use this url:

    var endpoint = 'https://api.enrichdata.com/v1/' + {METHOD}
    

    Make sure to replace {METHOD} with one of the methods listed below.

    Enrichdata™ uses API keys to allow access to the API. You can register a new Enrichdata™ API key at our developer portal.

    Methods

    Enrich an email

    Example request to enrich an email

    curl -X "POST" "https://api.enrichdata.com/v1/enrich-email" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d $'{
      "api_key": "6af2b19950de365a83837ahea1cf9d9383d28",
      "email": "elon.musk@tesla.com"
    }'
    

    The above command returns JSON structured like this:

    {
        "load_in": 0.0906,
        "query": "elon.musk@tesla.com",
        "state": true,
        "person": {
            "first_name": "Elon",
            "middle_name": null,
            "last_name": "Musk",
            "description": "Chief executive officer Tesla, Spacex, serial entrepreneur, investor",
            "url": "https://linkedin.com/in/elon-musk-3938",
            "keywords": [
                "marketing",
                "sales",
                "digital",
                "cars",
                "tesla"
                ...
            ],
            "current_job": "Chief executive officer Tesla",
            "connections_count": "95000",
            "email_primary": "e.musk@tesla.com",
            "email_found": true,
            "picture": "https://media.licdn.com/dms/image/C5103AQGmIFlYhIYavw/profile-displa....NUARmbo_0ugPTA_E",
            "source": "linkedin",
            "city": "Los Angeles",
            "linkedin_id": 240948053,
            "skills": [
                "powerpoint",
                "sales",
                "technology",
                ...
            ],
            "past_company": [
                "elon musk",
                "tesla",
                "spacex"
            ],
            "rewards": [
                "technology certification"
            ],
            "linkedin_id_url": "elon-musk-3938",
            "industry": "Automotive",
            "company_name": "Tesla",
            "company_domain": "tesla.com",
            "updated": 1549678505
        },
        "company": {
            "name": "Tesla",
            "linkedin_id": "11097668",
            "founded": "2003",
            "size": "10,001+ employees",
            "type": "Public Company",
            "website": "http://www.tesla.com",
            "updated": 1549678505,
            "address": "Palo Alto, CA",
            "url": "https://www.linkedin.com/company/tesla-motors/",
            "country": "United states",
            "industry": "Automotive",
            "domain": "tesla.com",
            "revenue" :"1000000000",
            "raised" : "30000000",
            "tags" : [
                "automotive",
                "cars"
            ],
            "technologies" : [
                "Google Analytics",
                "Salesforce"
            ]
        },
        "company_meta": {
            "title": "Electric Cars, Solar Panels & Clean Energy Storage  | Tesla",
            "description": "Tesla is accelerating the world's transition to sustainable energy with electric cars, solar panels and integrated renewable energy solutions for homes and businesses.",
            "keywords": "Tesla, Electric vehicles, EV, Electric cars, Elon Musk, Tesla news , Sustainable energy, Autopilot, Supercharger , Model S, Model X, Model 3",
            "phones": [
                "(650) 681-5100"
            ],
            "twitter_url": "https://twitter.com/tesla",
            "twitter_username": "tesla",
            "facebook_url": "https://www.facebook.com/TeslaMoto/",
            "facebook_username": "teslamoto",
            "google_plus_url": "https://plus.google.com/+TeslaMotors",
            "google_plus_username": "TeslaMotors",
            "youtube_url": "https://www.youtube.com/channel/UC5WjFrtBdufl6CZojX3D8dQ",
            "youtube_username": "UC5WjFrtBdufl6CZojX3D8dQ",
            "instagram_url": "https://www.instagram.com/teslamotors",
            "instagram_username": "teslamotors",
            "linkedin_url": "https://www.linkedin.com/company/elon-musk-news",
            "linkedin_username": "elon-musk-news",
            "github_url": "https://github.com/teslamotors",
            "github_username": "teslamotors",
            "company_email": [
                "contact@tesla.com",
                "jobs@tesla.com",
                "support@tesla.com"
            ]
        },
        "employees": {
            "email_format": "{fi}.{ln}",
            "employees_count": 30000,
            "employees": [
                {
                    "first_name": "elon",
                    "last_name": "musk",
                    "headline": "Chief executive officer Tesla",
                    "job_title": "CEO",
                    "location": "Los Angles",
                    "business_email": "e.musk@tesla.com",
                    "personal_email": "elon.musk@gmail.com",
                    "social_url": "https://linkedin.com/in/elon-musk-3938",
                    "description": "Chief executive officer Tesla, Spacex, serial entrepreneur, investor",
                    "company_name": "Tesla",
                    "keywords": [
                        "marketing",
                        "sales",
                        "digital",
                        "cars",
                        "tesla"
                    ],
                    "connections_count": "95000",
                    "picture": "https://media.licdn.com/dms/image/C5103AQGmIFlYhIYavw/profile-displa....NUARmbo_0ugPTA_E",
                    "city": "Los Angeles, CA",
                    "linkedin_id": 240948053,
                    "skills": [
                        "powerpoint",
                        "sales",
                        "technology",
                        ...
                    ],
                    "past_company": [
                        "elon musk",
                        "tesla",
                        "spacex"
                    ],
                    "rewards": [
                        "technology certification"
                    ],
                    "industry": "Automotive",
                    "company_domain": "tesla.com"
                },
                ... and more results
            ]
        }
    }
    

    This endpoint retrieves all contacts from your account. Max contacts returned is 100. You will have to use the pagination to get all your contacts.

    HTTP Request

    POST https://api.enrichdata.com/v1/enrich-email

    Query Parameters

    Parameter Required Description
    api_key true Your API key
    email true The email to enrich

    Enrich a domain or a name

    Example request to enrich a domain or company name:

    curl -X "POST" "https://api.enrichdata.com/v1/enrich-domain" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d $'{
      "api_key": "6af2b19950de365a83837ahea1cf9d9383d28",
      "domain": "tesla.com"
    }'
    

    The above command returns JSON structured like this:

    {
        "load_in": 0.0906,
        "query": "tesla.com",
        "state": true,
        "company": {
            "name": "Tesla",
            "linkedin_id": "11097668",
            "founded": "2003",
            "size": "10,001+ employees",
            "type": "Public Company",
            "website": "http://www.tesla.com",
            "updated": 1549678505,
            "address": "Palo Alto, CA",
            "url": "https://www.linkedin.com/company/tesla-motors/",
            "country": "United states",
            "industry": "Automotive",
            "domain": "tesla.com",
            "revenue" :"1000000000",
            "raised" : "30000000",
            "tags" : [
                "automotive",
                "cars"
            ],
            "technologies" : [
                "Google Analytics",
                "Salesforce"
            ]
        },
        "company_meta": {
            "title": "Electric Cars, Solar Panels & Clean Energy Storage  | Tesla",
            "description": "Tesla is accelerating the world's transition to sustainable energy with electric cars, solar panels and integrated renewable energy solutions for homes and businesses.",
            "keywords": "Tesla, Electric vehicles, EV, Electric cars, Elon Musk, Tesla news , Sustainable energy, Autopilot, Supercharger , Model S, Model X, Model 3",
            "phones": [
                "(650) 681-5100"
            ],
            "twitter_url": "https://twitter.com/tesla",
            "twitter_username": "tesla",
            "facebook_url": "https://www.facebook.com/TeslaMoto/",
            "facebook_username": "teslamoto",
            "google_plus_url": "https://plus.google.com/+TeslaMotors",
            "google_plus_username": "TeslaMotors",
            "youtube_url": "https://www.youtube.com/channel/UC5WjFrtBdufl6CZojX3D8dQ",
            "youtube_username": "UC5WjFrtBdufl6CZojX3D8dQ",
            "instagram_url": "https://www.instagram.com/teslamotors",
            "instagram_username": "teslamotors",
            "linkedin_url": "https://www.linkedin.com/company/elon-musk-news",
            "linkedin_username": "elon-musk-news",
            "github_url": "https://github.com/teslamotors",
            "github_username": "teslamotors",
            "company_email": [
                "contact@tesla.com",
                "jobs@tesla.com",
                "support@tesla.com"
            ]
        },
        "employees": {
            "email_format": "{fi}.{ln}",
            "employees_count": 30000,
            "employees": [
                {
                    "first_name": "elon",
                    "last_name": "musk",
                    "headline": "Chief executive officer Tesla",
                    "job_title": "CEO",
                    "location": "Los Angles",
                    "business_email": "e.musk@tesla.com",
                    "personal_email": "elon.musk@gmail.com",
                    "social_url": "https://linkedin.com/in/elon-musk-3938",
                    "description": "Chief executive officer Tesla, Spacex, serial entrepreneur, investor",
                    "company_name": "Tesla",
                    "keywords": [
                        "marketing",
                        "sales",
                        "digital",
                        "cars",
                        "tesla"
                    ],
                    "connections_count": "95000",
                    "picture": "https://media.licdn.com/dms/image/C5103AQGmIFlYhIYavw/profile-displa....NUARmbo_0ugPTA_E",
                    "city": "Los Angeles, CA",
                    "linkedin_id": 240948053,
                    "skills": [
                        "powerpoint",
                        "sales",
                        "technology",
                        ...
                    ],
                    "past_company": [
                        "elon musk",
                        "tesla",
                        "spacex"
                    ],
                    "rewards": [
                        "technology certification"
                    ],
                    "industry": "Automotive",
                    "company_domain": "tesla.com"
                },
                ... and more results
            ]
        }
    }
    

    This endpoint display all information we have for a specific domain or company name

    HTTP Request

    POST https://api.enrichdata.com/v1/enrich-domain

    Query Parameters

    Parameter Required Description
    api_key true Your API key
    domain true Use the company domain or company name

    Fast enrich email

    Example request to enrich an email

    curl -X "POST" "https://api.enrichdata.com/v1/fast-enrich-email" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d $'{
      "api_key": "6af2b19950de365a83837ahea1cf9d9383d28",
      "email": "elon.musk@tesla.com"
    }'
    

    The above command returns JSON structured like this:

    {
        "state": true,
        "data": {
            "person":{
                "avatar" : "https://enrichdatastorageweb.s3-us-west-1.amazonaws.com/1083-S3X1L3V5T1X3.png",
                "name":"Elon Musk",
                "first_name" : "Elon",
                "last_name" : "Musk",
                "utc_offset":-8,
                "location":"Palo Alto, CA, US",
                "role":"ceo",
                "seniority":"executive",
                "bio":"Entrepreneur, cars lover"
            },
            "company":{
                "logo" : "https://enrichdatastorageweb.s3-us-west-1.amazonaws.com/93837-S3X1L3V5T1X3.png",
                "name":"Tesla",
                "city":"Palo Alto",
                "stateCode":"CA",
                "countryCode":"US",
                "employeesRange":"10K-50K",
                "revenue":11758751000,
                "raised":"100000000",
                "tags":[
                    "Automotive",
                    "B2C"
                ],
                "tech":[
                    "qualtrics",
                    "zendesk",
                    "microsoft_exchange_online",
                    "outlook",
                    "microsoft_office_365",
                    "akamai_dns",
                    "google_analytics",
                    "amazon_ses",
                    "google_tag_manager",
                    "salesforce",
                    "mailgun",
                    "vimeo",
                    "adobe_experience_manager",
                    "apache",
                    "drupal"
                ]
            }
        }
    }
    

    This endpoint display all information we have for a specific email. This endpoint resolve faster than the other methods.

    HTTP Request

    POST https://api.enrichdata.com/v1/fast-enrich-email

    Query Parameters

    Parameter Required Description
    api_key true Your API key
    email true The email you want to enrich

    Errors

    The Anyleads™ API uses the following error codes:

    Key State Meaning
    state false -- Error during your request.
    state true -- The request is successful.
    event error -- Error during your request.
    event success -- The request is successful.