GET
/
people
/
find
curl --request GET \
  --url https://api.amplemarket.com/people/find \
  --header 'Authorization: Bearer <token>'
{
  "id": "0196352a-b48a-7b88-a6f2-0b5503b7bffd",
  "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",
  "about": null,
  "current_position_start_date": "2022-05-01",
  "current_position_description": null,
  "image_url": "http://botsford-koss.example/thomasina",
  "location": "San Francisco, California, United States",
  "location_details": {
    "city": "San Francisco",
    "state": "California",
    "country": "United States",
    "lat": 37.7749,
    "long": -122.4194
  },
  "experiences": [
    {
      "object": "experience",
      "title": "CEO",
      "company_name": "A Company",
      "company_linkedin_url": "https://www.linkedin.com/company/company-1",
      "start_date": "2023-04-01",
      "end_date": null
    }
  ],
  "educations": [
    {
      "object": "education",
      "degree": "BSc",
      "field_of_study": "Computer Science",
      "school_name": "MIT",
      "school_linkedin_url": "https://www.linkedin.com/school/mit",
      "start_date": "2019-04-01",
      "end_date": "2023-04-01"
    }
  ],
  "company": {
    "id": "0196352a-b439-75ff-ba1f-fd60657c4df6",
    "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",
    "logo_url": "https://assets.amplemarket.com/avatars/company/0196352a-b439-75ff-ba1f-fd60657c4df6",
    "location": "San Francisco, California, United States",
    "location_details": {
      "city": "San Francisco",
      "state": "California",
      "country": "United States",
      "postal_code": "94103",
      "lat": 37.7749,
      "long": -122.4194
    },
    "overview": "Circle Health is a group of hospitals in the UK",
    "followers": 0,
    "founded_year": 1995,
    "traffic_rank": 50,
    "sic_codes": [
      1,
      2,
      3
    ],
    "naics_codes": [
      5112,
      511,
      51
    ],
    "type": "Privately Held",
    "total_funding": 40000000,
    "latest_funding_stage": "series_b",
    "latest_funding_date": "2019-11-02",
    "is_b2b": true,
    "is_b2c": false,
    "technologies": [],
    "department_headcount": {
      "human_resources": 88
    },
    "job_function_headcount": {
      "revenue": {
        "business_development": 13
      },
      "information_technology": {
        "business_service_management_itsm": 91,
        "collaboration_web_app": 63
      },
      "engineering_technical": {
        "emerging_technology_innovation": 72,
        "technician": 35
      },
      "human_resources": {
        "employee_labor_relations": 60
      },
      "operations": {
        "facilities_management": 81
      },
      "senior_leadership": {
        "finance_executive": 95
      },
      "design": {
        "graphic_visual_brand_design": 80
      },
      "legal": {
        "intellectual_property_patent": 88
      },
      "medical_health": {
        "optometry": 69
      }
    },
    "estimated_revenue": "$1M-$10M"
  }
}

Credit consumption:

  • 0.5 email credits when a person is found, charged at most once per 24 hours
  • 1 email credit when an email is revealed, only charged once
  • 1 phone credit when a phone number is revealed, only charged once

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
email
string

Email to use for matching

​
linkedin_url
string

LinkedIn URL to use for matching

​
name
string

Person name to use for matching

​
title
string

Person title to use for matching

​
company_name
string

Company name to use for matching

​
company_domain
string

Company domain to use for matching

​
reveal_email
boolean

Triggers email reveal for the matching person

​
reveal_phone_numbers
boolean

Triggers phone number reveal for the matching person

Response

200
application/json
Ok
​
id
string
required
​
object
enum<string>
required
Available options:
person
​
linkedin_url
string
required
​
name
string | null
​
email
string | null
​
first_name
string | null
​
last_name
string | null
​
title
string | null
​
headline
string | null
​
about
string | null
​
current_position_start_date
string | null
​
current_position_description
string | null
​
location
string | null
​
image_url
string
​
location_details
object
​
experiences
object[] | null
​
educations
object[] | null
​
phone_numbers
object[] | null
​
company
object

Was this page helpful?