NAV Navbar
Python Shell
  • Introduction
  • Authentication
  • Request
  • Errors
  • Introduction

    Welcome to the Dropcontact API!

    Among other things, you can use our API to:

    Emails

    Verify any email address, and find business email addresses.

    Company

    Find information about companies.

    Person

    Correct first names and find the gender.


    In the dark area on the right, you can see code examples. You can switch the programming language in the upper right menu.

    Feel free to contact us if you have any question!

    Some requests may take up to 45 seconds

    Authentication

    Example of a request with the access token:

    import requests
    
    r = requests.post("https://api.dropcontact.io/clean",
                     headers={'X-Access-Token': apiKey})
    
    
    
    curl -X POST -H "X-Access-Token: apiKey" https://api.dropcontact.io/clean
    
    

    Make sure to replace apikey with your access token.

    Dropcontact uses access tokens to allow access to the API. Subscribe here to get your access token.

    Our API authenticates requests with an access token that must be passed on the request's header.

    Include 'X-Access-Token': apiKey in your header for authentification.

    Request

    Basic request

    import requests
    import json
    
    r = requests.post("https://api.dropcontact.io/clean",
                     data=json.dumps({'email': 'example_email@email.com'}),
                     headers={
                     'Content-Type': 'application/json',
                     'X-Access-Token': apiKey
                     })
    
    
    curl -X POST
      -H "Content-Type: application/json"
      -H "X-Access-Token: apiKey"
      -d '{"email": "example_email@email.com"}'
      'https://api.dropcontact.io/clean'
    

    This request returns a JSON structured like this with a valid email:

    {
      "civility": "M",
      "company": "COMPANY",
      "email": "example_email@email.com",
      "first_name": "Denis",
      "full_name": "Dupont",
      "website": "www.example.com"
    }
    

    This request returns a JSON structured like this with an invalid email:

    {
      "civility": "M",
      "email": "example_email@email.com",
      "email qualification":"invalid",
      "first_name": "Denis",
      "full_name": "Dupont"
    }
    

    This request retrieves the civility, the company, the validity of the email, the first name, the full name and a lot of information.

    Some requests may take up to 45 seconds

    HTTP Request

    POST https://api.dropcontact.io/clean

    URL Optionnal Parameters

    Parameter Type Description
    email string The email you want to verify

    Request with siren

    import requests
    import json
    
    r = requests.post("https://api.dropcontact.io/clean",
                     data=json.dumps({
                     'email': 'example_email@email.com',
                     'siren': true
                     }),
                     headers={
                     'Content-Type': 'application/json',
                     'X-Access-Token': apiKey
                     })
    
    curl -X POST
      -H "Content-Type: application/json"
      -H "X-Access-Token: apiKey"
      -d '{
        "email": "example_email@email.com",
        "siren": true}'
      'https://api.dropcontact.io/clean'
    

    This request returns a JSON structured like this with a valid email:

    {
      "civility": "M",
      "company": "COMPANY",
      "email": "example_email@email.com",
      "first_name": "Denis",
      "full_name": "Dupont",
      "website": "www.example.com",
      "siren": "500 500 500"
    }
    

    This request returns a JSON structured like this with an invalid email:

    {
      "civility": "M",
      "email": "example_email@email.com",
      "email qualification":"invalid",
      "first_name": "Denis",
      "full_name": "Dupont"
    }
    

    This request retrieves the same information as the previous one + the SIREN number.

    Some requests may take up to 45 seconds

    Only French companies have SIREN numbers..

    HTTP Request

    POST https://api.dropcontact.io/clean

    URL Optionnal Parameters

    Parameter Type Description
    email string The email that you want to verify
    siren boolean true if you want the SIREN number

    Request with all parameters

    import requests
    import json
    
    r = requests.post("https://api.dropcontact.io/clean",
                     data=json.dumps({
                     'email': 'example_email@email.com',
                     'siren': true
                     'first_name': 'Denis',
                     'last_name': 'Dupont',
                     'full_name': 'Denis Dupont',
                     'phone': 0707070707,
                     'company': 'Dropcontact',
                     'webite': 'https://dropcontact.io'
                     }),
                     headers={
                     'Content-Type': 'application/json',
                     'X-Access-Token': apiKey
                     })
    
    curl -X POST
      -H "Content-Type: application/json"
      -H "X-Access-Token: apiKey"
      -d '{
        "email": "example_email@email.com",
        "siren": true,
        "first_name": "Denis",
        "last_name": "Dupont",
        "full_name": "Denis Dupont",
        "phone": 0707070707,
        "company": "Dropcontact",
        "webite": "https://dropcontact.io"}'
      'https://api.dropcontact.io/clean'
    

    This request returns a JSON structured like this with a valid email:

    {
      "civility": "M",
      "company": "COMPANY",
      "email": "example_email@email.com",
      "first_name": "Denis",
      "last_name": "Dupont",
      "full_name": "Denis Dupont",
      "website": "www.example.com",
      "siren": "500 500 500"
    }
    

    This request returns a JSON structured like this with an invalid email:

    {
      "civility": "M",
      "email": "example_email@email.com",
      "email qualification":"invalid",
      "first_name": "Denis",
      "last_name": "Dupont",
      "full_name": "Denis Dupont",
      "website": "www.example.com",
      "siren": "500 500 500"
    }
    

    HTTP Request

    POST https://api.dropcontact.io/clean

    URL Optionnal Parameters

    Parameter Type Description
    email string The email that you want to verify
    first_name string first name
    last_name string last name
    full_name string full name
    phone string phone number
    company string company's name
    website string website URL of a company
    siren boolean True if you want the SIREN number

    Return

    This request returns a JSON structured like this:

    {
      "civility": "M",
      "first_name": "Denis",
      "last_name": "Dupont",
      "full_name": "Denis Dupont",
      "email": "denis.dupont@example.com",
      "phone": 0707070707,
      "company": "companyTest",
      "website": "www.companyTest.fr",
      "siren": "500 500 500",
      "siret": "222 222 222 00022",
      "vat": "79",
      "nb_employees": "202",
      "linkedin": "https://fr.linkedin.com/in/denis.dupont",
      "facebook": "https://www.facebook.com/denis.dupont",
      "twitter": "https://twitter.com/denis.dupont",
      "googleplus": "https://plus.google.com/552255220810040710122",
      "github": "https://github.com/DenisDupont",
      "generate_id": "prénom généré automatiquement",
      "naf5_code": "01.22E",
      "naf5_des":"Culture de la vigne"
    }
    

    The following fields can be returned by our API:

    Information Type
    civility string
    first_name string
    last_name string
    full_name string
    email string
    phone string
    company string
    website string
    siren string
    siret string
    vat string
    nb_employees string
    linkedin string
    facebook string
    twitter string
    googleplus string
    github string
    generate_id string
    naf5_code string
    naf5_des string

    Rate Limits

    If you hit the API with too many requests in a given amount of time, subsequent requests will temporarily fail. If your client gets rate-limited, you will start receiving 429 Too Many Requests HTTP errors in response to your requests.

    Errors

    Http Status codes

    Error Code Title Description
    400 Bad Request Your request is invalid.
    401 Unauthorized Your access token is wrong.
    403 Unauthorized API call Token exceeded quota.
    404 Not Found The specified resource could not be found.
    429 Too Many Requests Too many requests in a given slot of time.
    500 Internal Server Error We have been informed of this and will solve it as soon as possible.
    503 Service Unavailable We're temporarily offline for maintenance. Please try again later.
    504 Service Unavailable Gateway timeout. Please try again later.
    524 Timeout A timeout occured.

    Error type

    Type Value Desctiption
    email qualificiation 'invalid' The email you provide to the API is invalid