Matching against a Person in our database allows the retrieval of data associated with said Person.

​
Person Object

The Person object represents a b2b contact, typically associated with a company. Here is a description of the Person object:

FieldTypeDescription
idstringID of the Person
linkedin_urlstringLinkedIn URL of the Person
namestringName of the Person
first_namestringFirst name of the Person
last_namestringLast name of the Person
titlestringTitle of the Person
headlinestringHeadline of the Person
logo_urlstringImage URL of the Person
locationstringLocation of the Person
location_detailsobjectLocation details of the Person
companyCompany objectCompany the Person currently works for

​
Company Object

Here is the description of the Company object:

FieldTypeDescription
idstringAmplemarket ID of the Company
namestringName of the Company
linkedin_urlstringLinkedIn URL of the Company
websitestringWebsite of the Company
overviewstringDescription of the Company
logo_urlstringLogo URL of the Company
founded_yearintegerYear the Company was founded
traffic_rankintegerTraffic rank of the Company
sic_codesarray of integersSIC codes of the Company
typestringType of the Company (Public Company, etc.)
total_fundingintegerTotal funding of the Company
latest_funding_stagestringLatest funding stage of the Company
latest_funding_datestringLatest funding date of the Company
keywordsarray of stringsKeywords of the Company
estimated_number_of_employeesintegerEstimated number of employees at the Company
followersintegerNumber of followers on LinkedIn
sizestringSelf reported size of the Company
industrystringIndustry of the Company
locationstringLocation of the Company
location_detailsobjectLocation details of the Company
is_b2bbooleantrue if the Company has a B2B component
is_b2cbooleantrue if the Company has a B2C component
technologiesarray of stringsTechnologies detected for the Company
department_headcountobjectHeadcount by department
job_function_headcountobjectHeadcount by job function
estimated_revenuestringThe estimated annual revenue of the company
revenueintegerThe annual revenue of the company

​
People Endpoints

​
Finding a Person

Request

The following endpoint can be used to find a Person on Amplemarket:

GET /people/find?linkedin_url=https://www.linkedin.com/in/person-1 HTTP/1.1
GET /people/find?email=person@example.com HTTP/1.1
GET /people/find?name=John%20Doe&title=CEO&company_name=Example HTTP/1.1
GET /people/find?name=John%20Doe&title=CEO&company_domain=example.com HTTP/1.1

Response

The response contains the Linkedin URL of the Person along with the other relevant data.

HTTP/1.1 200 OK
Content-Type: application/vnd.amp+json

{
  "id": "84d31ab0-bac0-46ea-9a8b-b8721126d3d6",
  "object": "person",
  "name": "Jonh Doe",
  "first_name": "Jonh",
  "last_name": "Doe",
  "linkedin_url": "https://www.linkedin.com/in/person-1",
  "title": "Founder and CEO",
  "headline": "CEO @ Company",
  "location": "San Francisco, California, United States",
  "company": {
    "id": "eec03d70-58aa-46e8-9d08-815a7072b687",
    "object": "company",
    "name": "A Company",
    "website": "https://company.com",
    "linkedin_url": "https://www.linkedin.com/company/company-1",
    "keywords": [
      "sales",
      "ai sales",
      "sales engagement"
    ],
    "estimated_number_of_employees": 500,
    "size": "201-500 employees",
    "industry": "Software Development",
    "location": "San Francisco, California, US",
    "is_b2b": true,
    "is_b2c": false,
    "technologies": ["Salesforce"]
  }
}

​
Searching for multiple People

The following endpoint can be used to search for multiple People on Amplemarket:

POST /people/search HTTP/1.1
Content-Type: application/json

{
  "person_name": "Jonh Doe",
  "person_titles": ["CEO"],
  "person_locations": ["San Francisco, California, United States"],
  "company_names": ["A Company"],
  "page": 1,
  "page_size": 10
}

Response

The response contains the Linkedin URL of the Person along with the other relevant data.

HTTP/1.1 200 OK
Content-Type: application/vnd.amp+json

{
  "object": "person_search_result",
  "results": [
    {
      "id": "84d31ab0-bac0-46ea-9a8b-b8721126d3d6",
      "object": "person",
      "name": "Jonh Doe",
      "first_name": "Jonh",
      "last_name": "Doe",
      "linkedin_url": "https://www.linkedin.com/in/person-1",
      "title": "Founder and CEO",
      "headline": "CEO @ Company",
      "location": "San Francisco, California, United States",
      "company": {
        "id": "eec03d70-58aa-46e8-9d08-815a7072b687",
        "object": "company",
        "name": "A Company",
        "website": "https://company.com",
        "linkedin_url": "https://www.linkedin.com/company/company-1",
        "keywords": [
          "sales",
          "ai sales",
          "sales engagement"
        ],
        "estimated_number_of_employees": 500,
        "size": "201-500 employees",
        "industry": "Software Development",
        "location": "San Francisco, California, US",
        "is_b2b": true,
        "is_b2c": false,
        "technologies": ["Salesforce"]
      }
    }
  ],
  "_pagination": {
    "page": 1,
    "page_size": 1,
    "total_pages": 1,
    "total": 1
  }
}

Was this page helpful?

Getting StartedCompanies Search