Tools LinkedIn Plans Docs FAQ
Login

Person and employee data APIs

Our immense database of close to half a billion people with their jobs, hobbies, jobs, education, job histories, email addresses and more is a great source for a large variety of activities.

From research and statistical use to HR or sales enablement, we are providing valuable service for a large range of companies and activities.

Public APIs vs private APIs

At this time we are careful releasing our person data APIs to the public, controlling who is using our technology before we make it available.
We can provide custom APIs tailored to your usage or make private functions available to you, please contact our helpdesk for more information.

This documentation only covers public available APIs.

Try our web based demo
Contact to email demo

API documentation
cURL

We use cURL and URL examples during most of the documentation.

Email to contact reversal

The email_to_contact API gives you an edge in finding highly detailed data profiles from people based on their email address.

This API will analyze the submitted email addresses into first and last name, the domain into the company profile and then look in our employee database for this employee.

The core feature of this API is that it can reverse email addresses that are not even present in our database of 100M business email addresses.

Cost

Each email lookup costs 0.5 Credits, each matched lookup costs an additional 0.8-1.0 Credits (1.3-1.5 Credits per full lookup) depending on export details chosen.

This is the license to use for smaller volumes, on large quantities (hundred thousands up to millions of contacts) we provide custom plans.

Demonstration and detailed description

Important parameters

  • export_format [json]
    json: export format is one JSON object
    csv: only on custom demand
  • country_name [string]
    Priorize records from given country by name if multiple records are available
  • human_readable
    pretty print the JSON data (not for machine parsing)
  • a) email_list
    Comma separated list of email addresses, up to 500 emails per API call
  • b) emaildata
    An array of email addresses, paired with optional first- and/or last- name to increase matching accuracy on short prefixes, up to 100 emails per API call
  • configuration[export_details]
    Choice of: MINIMAL, MEDIUM, FULL
    • MINIMAL: Fulfillment cost: 0.8 Credits
      Person data includes: name, job_title, company.company_name
    • MEDIUM: Fulfillment cost: 0.9 Credits
      Person data includes in addition: current location, current company in full details
    • FULL: Fulfillment cost: 1.0 Credits
      Person data includes: up to 40 years of job history, education, skills, linkedin profile URL
Request 1
URL
                            https://scraping.services/export?user=_USER@ACCOUNT_&credentials=_CREDENTIALS_&job_type=email_reverse_query&export_format=json&human_readable&configuration[export_details]=FULL&email_list=SatyaN@Microsoft.com,GatesB@Microsoft.com
# emails provided as comma separated list
API request 2
cURL
                            curl -X POST https://scraping.services/export \
-d user=_USER@ACCOUNT_ \
-d credentials=_CREDENTIALS_ \
-d job_type=email_reverse_query \
-d configuration[export_details]=MEDIUM \
--data-urlencode json='{ "emaildata": [ "SatyaN@Microsoft.com", "AlfredHitchcock@analyze.only", { "email": "GatesB@Microsoft.com", "first_name": "Bill" }, { "email": "bg@Microsoft.com", "name": "Bill Gates" } ] }' \
-d export_format=json \
-d human_readable
# emails provided as JSON encoded array
# SatyaN@Microsoft.com is without meta information
# AlfredHitchcock@analyze.only demonstrates our email prefix to name analysis
# GatesB@Microsoft.com specifies the first name (not required but increases statistical match rates)
# bg@Microsoft.com specifies the full name which demonstrates our full name analysis
# -X POST or -G will both work, POST is recommended
Response 1 (FULL details)
JSON
                            {
  "request": {
    "job_type": "email_reverse_query",
    "cost": {
      "type": "credit",
      "total": 3,
      "per_search": 0.5,
      "per_fulfillment": 1
    },
    "api_version_max": 2,
    "api_version": 1,
    "configuration": {
      "EXPORT_DETAILS": "FULL"
    },
    "statistic": {
      "located": 2,
      "unique": 0,
      "missed": 0
    }
  },
  "results": {
    "SatyaN@Microsoft.com": {
      "analysis": {
        "email_pattern": "{first}{l}",
        "name_from_email": {
          "{l}": "N",
          "{first}": "Satya",
          "pattern": "{first}{l}",
          "certainty": 0.882
        },
        "persons_matched": 3
      },
      "person": {
        "id": 113063,
        "scraping_services_id": 113063,
        "linkedin_id": "satya-nadella-3145136",
        "linkedin_profile_url": "https://www.linkedin.com/in/satya-nadella-3145136",
        "last_name": "Nadella",
        "first_name": "Satya",
        "num_jobs": 4,
        "location": {
          "country_name": "United States",
          "state_name": "Washington",
          "city_name": "Redmond"
        },
        "job_title": "CEO",
        "company": {
          "company_name": "Microsoft",
          "company_intern_id": "microsoft",
          "scraping_services_id": 8261458,
          "address_hq": "1 Microsoft Way Redmond, WA 98052 United States",
          "website": "http://www.microsoft.com",
          "size_min": 10001,
          "size_max": 10001,
          "summary": "At Microsoft, our mission is to empower every person and every organization on the planet to achieve more. Our mission is grounded in both the world in which we live and the future we strive to create. Today, we live in a mobile-first, cloud-first world, and the transformation we are driving across our businesses is designed to enable Microsoft and our customers to thrive in this world. \n\nWe do business in 170 countries and are made up of 114,000 passionate employees dedicated to fulfilling our mission of helping you and your organization achieve more.\n",
          "location": {
            "country_name": "United States",
            "state_name": "Washington",
            "city_name": "Redmond",
            "zip_code": "98052"
          },
          "founded_date": "1975",
          "industry": "Computer Software"
        },
        "job_history": [
          {
            "job_title": "CEO",
            "location": {
              "city_name": "Seattle",
              "country_name": "United States",
              "state_name": "Washington"
            },
            "company_name": "Microsoft",
            "company_intern_id": "microsoft",
            "start": "February 2014"
          }
        ],
        "job_history_extended": {
          "2018/3": {
            "company_name": "Microsoft",
            "job_title": "CEO"
          },
          "2018/5": {
            "company_name": "Microsoft",
            "job_title": "CEO",
            "location": {
              "country_name": "United States",
              "state_name": "Washington",
              "city_name": "Seattle"
            }
          },
          "2019/3": {
            "company_name": "Microsoft",
            "job_title": "CEO",
            "location": {
              "country_name": "United States",
              "state_name": "Washington",
              "city_name": "Redmond"
            }
          }
        },
        "interests": [
          "Technology",
          "cricket",
          "poetry and literature",
          "spending time with family"
        ],
        "education": [
          {
            "education_org": "The University of Chicago Booth School of Business",
            "end": "1996",
            "start": "1994"
          },
          {
            "education_org": "Mangalore University",
            "degrees": [
              "Bachelor’s Degree, Electrical Engineering"
            ]
          },
          {
            "education_org": "University of Wisconsin-Milwaukee",
            "degrees": [
              "Master’s Degree, Computer Science"
            ]
          }
        ],
        "also_viewed": [
          "satya-nadella-3145136",
          "rishic1",
          "mdell",
          "rsanghvi",
          "randizuckerberg",
          "gayathri-rajan-81b226",
          "punitsoni",
          "marissamayer",
          "saverin",
          "williamhgates"
        ],
        "updated": "2019-09-01",
        "certainty": 1,
        "is_unique": false
      },
      "email_company": {
        "scse_n_id": null,
        "linkedin_url": "https://www.linkedin.com/company/microsoft",
        "company_name": "Microsoft Corporation",
        "country_name": "United States",
        "state_name": "Washington",
        "city_name": "Redmond",
        "postal_code": "98052",
        "summary": "Microsoft Corporation develops, licenses, and supports software, services, devices, and solutions worldwide. Its company's Productivity and Business Processes segment offers Office 365 commercial products and services for businesses, such as Office, Exchange, SharePoint, Skype for Business, Microsoft Teams, and related Client Access Licenses (CALs); Office 365 consumer services, including Skype, Outlook.com, and OneDrive; LinkedIn online professional network; and Dynamics business solutions comprising financial management, enterprise resource planning, customer relationship management, supply chain management, and analytics applications for small and medium businesses, large organizations, and divisions of enterprises. The company's Intelligent Cloud segment licenses server products and cloud services, such as SQL Server, Windows Server, Visual Studio, System Center, and related CALs, as well as Azure, a cloud platform; enterprise services, including premier support and Microsoft consulting services to assist customers in developing, deploying, and managing Microsoft server and desktop solutions, as well as providing training and certification to developers and IT professionals on Microsoft products. Its More Personal Computing segment offers Windows OEM, volume, and other non-volume licensing of the Windows operating system; patent licensing, Windows Internet of Things, and MSN display advertising; devices comprising Surface, PC accessories, and other intelligent devices; Xbox hardware and software and services; and Bing and Bing Ads search advertising. The company markets and distributes its products through original equipment manufacturers, distributors, and resellers, as well as through online and Microsoft retail stores. Microsoft Corporation has collaboration with E.ON; a strategic alliance with Nielsen Holdings plc; and a strategic collaboration with Mastercard Incorporated. The company was founded in 1975 and is headquartered in Redmond, Washington.",
        "employee_count": 131000,
        "employee_count_span": "131000-131000",
        "employee_available": null,
        "phone": "425-882-8080",
        "address_hq": "One Microsoft Way",
        "website": "http://www.microsoft.com",
        "website_alt": null,
        "industry_linkedin": "Computer Software",
        "industry_alt": "Software - Infrastructure",
        "founded_date": "1975",
        "specialities": null,
        "stock_symbol": "MSFT",
        "stock_exchange": "NMS",
        "last_updated": 2019
      }
    },
    "GatesB@Microsoft.com": {
      "analysis": {
        "email_pattern": "{last}{f}",
        "name_from_email": {
          "{f}": "B",
          "{last}": "Gates",
          "pattern": "{last}{f}",
          "certainty": 0.882
        },
        "persons_matched": 4
      },
      "person": {
        "id": 171595885,
        "scraping_services_id": 171595885,
        "linkedin_id": "bill-gates-9a3782104",
        "linkedin_profile_url": "https://www.linkedin.com/in/bill-gates-9a3782104",
        "last_name": "Gates",
        "first_name": "Bill",
        "location": {
          "country_name": "United States",
          "state_name": "Georgia",
          "city_name": "Atlanta"
        },
        "industry": "Internet",
        "job_title": "CEO",
        "company": {
          "company_name": "Microsoft",
          "company_intern_id": "microsoft",
          "scraping_services_id": 8261458,
          "address_hq": "1 Microsoft Way Redmond, WA 98052 United States",
          "website": "http://www.microsoft.com",
          "size_min": 10001,
          "size_max": 10001,
          "summary": "At Microsoft, our mission is to empower every person and every organization on the planet to achieve more. Our mission is grounded in both the world in which we live and the future we strive to create. Today, we live in a mobile-first, cloud-first world, and the transformation we are driving across our businesses is designed to enable Microsoft and our customers to thrive in this world. \n\nWe do business in 170 countries and are made up of 114,000 passionate employees dedicated to fulfilling our mission of helping you and your organization achieve more.\n",
          "location": {
            "country_name": "United States",
            "state_name": "Washington",
            "city_name": "Redmond",
            "zip_code": "98052"
          },
          "founded_date": "1975",
          "industry": "Computer Software"
        },
        "job_history_extended": {
          "2018/1": {
            "company_name": "Microsoft",
            "job_title": "CEO",
            "location": {
              "country_name": "United States",
              "city_name": "Atlanta"
            }
          }
        },
        "also_viewed": [
          "mark-cuban-06a0755b",
          "bill-gates-b3038410",
          "emusk",
          "julia-golovina-05b74787",
          "isabella-amor-76291343",
          "walter-rolls-3459ba99",
          "rbranson",
          "billgatessrclarke",
          "bill-gates-b1a606b0",
          "williamhgates",
          "bill-n-melinda-gates-foundation-310737bb",
          "георгий-а-25208b81",
          "williamcgates",
          "donald-trump-a9887b55",
          "jan-hürlimann-05264610b"
        ],
        "updated": "2018-04-01",
        "certainty": 1,
        "is_unique": false
      },
      "email_company": {
        "scse_n_id": null,
        "linkedin_url": "https://www.linkedin.com/company/microsoft",
        "company_name": "Microsoft Corporation",
        "country_name": "United States",
        "state_name": "Washington",
        "city_name": "Redmond",
        "postal_code": "98052",
        "summary": "Microsoft Corporation develops, licenses, and supports software, services, devices, and solutions worldwide. Its company's Productivity and Business Processes segment offers Office 365 commercial products and services for businesses, such as Office, Exchange, SharePoint, Skype for Business, Microsoft Teams, and related Client Access Licenses (CALs); Office 365 consumer services, including Skype, Outlook.com, and OneDrive; LinkedIn online professional network; and Dynamics business solutions comprising financial management, enterprise resource planning, customer relationship management, supply chain management, and analytics applications for small and medium businesses, large organizations, and divisions of enterprises. The company's Intelligent Cloud segment licenses server products and cloud services, such as SQL Server, Windows Server, Visual Studio, System Center, and related CALs, as well as Azure, a cloud platform; enterprise services, including premier support and Microsoft consulting services to assist customers in developing, deploying, and managing Microsoft server and desktop solutions, as well as providing training and certification to developers and IT professionals on Microsoft products. Its More Personal Computing segment offers Windows OEM, volume, and other non-volume licensing of the Windows operating system; patent licensing, Windows Internet of Things, and MSN display advertising; devices comprising Surface, PC accessories, and other intelligent devices; Xbox hardware and software and services; and Bing and Bing Ads search advertising. The company markets and distributes its products through original equipment manufacturers, distributors, and resellers, as well as through online and Microsoft retail stores. Microsoft Corporation has collaboration with E.ON; a strategic alliance with Nielsen Holdings plc; and a strategic collaboration with Mastercard Incorporated. The company was founded in 1975 and is headquartered in Redmond, Washington.",
        "employee_count": 131000,
        "employee_count_span": "131000-131000",
        "employee_available": null,
        "phone": "425-882-8080",
        "address_hq": "One Microsoft Way",
        "website": "http://www.microsoft.com",
        "website_alt": null,
        "industry_linkedin": "Computer Software",
        "industry_alt": "Software - Infrastructure",
        "founded_date": "1975",
        "specialities": null,
        "stock_symbol": "MSFT",
        "stock_exchange": "NMS",
        "last_updated": 2019
      }
    }
  }
}
                        
Response 2 (MINIMAL details)
CSV
                            {
    "request": {
        "job_type": "email_reverse_query",
        "cost": {
            "type": "credit",
            "total": 4.4,
            "per_search": 0.5,
            "per_fulfillment": 0.8
        },
        "api_version_max": 2,
        "api_version": 1,
        "configuration": {
            "EXPORT_DETAILS": "MINIMAL"
        },
        "statistic": {
            "located": 3,
            "unique": 2,
            "missed": 1
        }
    },
    "results": {
        "SatyaN@Microsoft.com": {
            "analysis": {
                "email_pattern": "{first}{l}",
                "name_from_email": {
                    "{l}": "N",
                    "{first}": "Satya",
                    "pattern": "{first}{l}",
                    "certainty": 0.882
                },
                "persons_matched": 3
            },
            "person": {
                "scraping_services_id": 113063,
                "last_name": "Nadella",
                "first_name": "Satya",
                "job_title": "CEO",
                "company": {
                    "company_name": "Microsoft"
                },
                "certainty": 1,
                "is_unique": false
            },
            "email_company": {
                "company_name": "Microsoft Corporation"
            }
        },
        "MorganF@analyze.only": {
            "analysis": {
                "email_pattern": "{last}{f}",
                "name_from_email": {
                    "{f}": "F",
                    "{last}": "Morgan",
                    "pattern": "{last}{f}",
                    "certainty": 0.9
                },
                "persons_matched": 0
            },
            "person": false,
            "email_company": {
                "company_name": null
            }
        },
        "GatesB@Microsoft.com": {
            "analysis": {
                "email_pattern": "{last}{f}",
                "name_from_email": {
                    "{f}": "B",
                    "{last}": "Gates",
                    "pattern": "{last}{f}",
                    "certainty": 0.882
                },
                "persons_matched": 1
            },
            "person": {
                "scraping_services_id": 171595885,
                "last_name": "Gates",
                "first_name": "Bill",
                "job_title": "CEO",
                "company": {
                    "company_name": "Microsoft"
                },
                "certainty": 1,
                "is_unique": true
            },
            "email_company": {
                "company_name": "Microsoft Corporation"
            }
        },
        "bg@Microsoft.com": {
            "analysis": {
                "provided_full_name": {
                    "{first}": "Bill",
                    "{middle}": "",
                    "{last}": "Gates",
                    "certainty": 1
                },
                "email_pattern": null,
                "name_from_email": null,
                "persons_matched": 1
            },
            "person": {
                "scraping_services_id": 171595885,
                "last_name": "Gates",
                "first_name": "Bill",
                "job_title": "CEO",
                "company": {
                    "company_name": "Microsoft"
                },
                "certainty": 1,
                "is_unique": true
            },
            "email_company": {
                "company_name": "Microsoft Corporation"
            }
        }
    }
}