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