People Search

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:

Field	Type	Description
`id`	string	ID of the Person
`linkedin_url`	string	LinkedIn URL of the Person
`name`	string	Name of the Person
`first_name`	string	First name of the Person
`last_name`	string	Last name of the Person
`title`	string	Title of the Person
`headline`	string	Headline of the Person
`logo_url`	string	Image URL of the Person
`location`	string	Location of the Person
`location_details`	object	Location details of the Person
`company`	Company object	Company the Person currently works for

Company Object

Here is the description of the Company object:

Field	Type	Description
`id`	string	Amplemarket ID of the Company
`name`	string	Name of the Company
`linkedin_url`	string	LinkedIn URL of the Company
`website`	string	Website of the Company
`overview`	string	Description of the Company
`logo_url`	string	Logo URL of the Company
`founded_year`	integer	Year the Company was founded
`traffic_rank`	integer	Traffic rank of the Company
`sic_codes`	array of integers	SIC codes of the Company
`type`	string	Type of the Company (Public Company, etc.)
`total_funding`	integer	Total funding of the Company
`latest_funding_stage`	string	Latest funding stage of the Company
`latest_funding_date`	string	Latest funding date of the Company
`keywords`	array of strings	Keywords of the Company
`estimated_number_of_employees`	integer	Estimated number of employees at the Company
`followers`	integer	Number of followers on LinkedIn
`size`	string	Self reported size of the Company
`industry`	string	Industry of the Company
`location`	string	Location of the Company
`location_details`	object	Location details of the Company
`is_b2b`	boolean	`true` if the Company has a B2B component
`is_b2c`	boolean	`true` if the Company has a B2C component
`technologies`	array of strings	Technologies detected for the Company
`department_headcount`	object	Headcount by department
`job_function_headcount`	object	Headcount by job function
`estimated_revenue`	string	The estimated annual revenue of the company
`revenue`	integer	The 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/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"]
  }
}

Revealing an email address

GET /people/find?linkedin_url=https://www.linkedin.com/in/person-1&reveal_email=true HTTP/1.1

Response

The response contains the Linkedin URL of the Person along with the other relevant data and the revealed email address (if successful).

HTTP/1.1 200 OK
Content-Type: application/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"]
  },
  "email": "john.doe@company.com"
}

Response (Request Timeout)

It is possible for the request to time out when revealing an email address, in this case the response will look like this.

HTTP/1.1 408 Request Timeout
Content-Type: application/json
Retry-After: 60

{
  "object": "error",
  "_errors": [
    {
      "code": "request_timeout",
      "title": "Request timeout"
      "detail": "We are processing your request, try again later."
    }
  ]
}

In this case you are free to retry the request after the specified time in the Retry-After header.

Revealing phone numbers

GET /people/find?linkedin_url=https://www.linkedin.com/in/person-1&reveal_phone_numbers=true HTTP/1.1

Response

The response contains the Linkedin URL of the Person along with the other relevant data and the revealed phone numbers (if successful).

HTTP/1.1 200 OK
Content-Type: application/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"]
  },
  "phone_numbers": [
    {
      "object": "phone_number",
      "id": "84d31ab0-bac0-46ea-9a8b-b8721126d3d6",
      "number": "+1 123456789",
      "type": "mobile"
    }
  ]
}

Response (Request Timeout)

It is possible for the request to time out when revealing phone numbers, in this case the response will look like this.

HTTP/1.1 408 Request Timeout
Content-Type: application/json
Retry-After: 60

{
  "object": "error",
  "_errors": [
    {
      "code": "request_timeout",
      "title": "Request timeout"
      "detail": "We are processing your request, try again later."
    }
  ]
}

In this case you are free to retry the request after the specified time in the Retry-After header.

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/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
  }
}

Home

Guides

Person Object

Company Object

People Endpoints

Finding a Person

Revealing an email address

Revealing phone numbers

Searching for multiple People

Home

Guides

​Person Object

​Company Object

​People Endpoints

​Finding a Person

​Revealing an email address

​Revealing phone numbers

​Searching for multiple People

Person Object

Company Object

People Endpoints

Finding a Person

Revealing an email address

Revealing phone numbers

Searching for multiple People