Search people

POST

people

curl --request POST \
  --url https://api.amplemarket.com/people/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "person_name": "<string>",
  "person_titles": [
    "<string>"
  ],
  "person_title_exact_match": true,
  "person_seniorities": [
    "Owner"
  ],
  "person_departments": [
    "<string>"
  ],
  "person_job_functions": [
    "<string>"
  ],
  "person_locations": [
    "<string>"
  ],
  "person_exclude_locations": [
    "<string>"
  ],
  "company_locations": [
    "<string>"
  ],
  "company_exclude_locations": [
    "<string>"
  ],
  "company_names": [
    "<string>"
  ],
  "company_exclude_names": [
    "<string>"
  ],
  "company_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "company_exclude_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "education_company_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "education_company_names": [
    "<string>"
  ],
  "company_domains": [
    "<string>"
  ],
  "company_exclude_domains": [
    "<string>"
  ],
  "company_linkedin_urls": [
    "<string>"
  ],
  "company_exclude_linkedin_urls": [
    "<string>"
  ],
  "company_domains_match_subsidiaries_and_affiliates": true,
  "company_focuses": [
    "b2b"
  ],
  "company_types": [
    "Public Company"
  ],
  "company_sizes": [
    "1-10 employees"
  ],
  "company_industries": [
    "<string>"
  ],
  "company_exclude_industries": [
    "<string>"
  ],
  "linkedin_networks": [
    "<string>"
  ],
  "exclude_linkedin_networks": [
    "<string>"
  ],
  "company_investors": [
    "<string>"
  ],
  "company_shares_investors_with": [
    "<string>"
  ],
  "page": 1,
  "page_size": 5
}'

{
  "object": "person_search_result",
  "results": [
    {
      "id": "0196352a-c51f-7497-8f2a-aba19059ced0",
      "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://hilpert.example/aurelia",
      "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-c4d4-7ed2-bc58-6a242f5ef1f8",
        "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-c4d4-7ed2-bc58-6a242f5ef1f8",
        "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": {
          "legal": 67
        },
        "job_function_headcount": {
          "marketing": {
            "brand_management": 19,
            "field_marketing": 95
          },
          "engineering_technical": {
            "chemical_engineering": 22
          },
          "medical_health": {
            "chiropractics": 78,
            "medical_education_training": 14
          },
          "legal": {
            "ethics": 69
          },
          "revenue": {
            "field_outside_sales": 73
          },
          "information_technology": {
            "help_desk_desktop_services": 27,
            "infrastructure": 78,
            "virtualization": 95
          },
          "finance": {
            "internal_audit_control": 56
          }
        },
        "estimated_revenue": "$1M-$10M"
      }
    }
  ],
  "_pagination": {
    "page": 1,
    "page_size": 30,
    "total_pages": 1,
    "total": 1
  }
}

Authorizations

Authorization

string

header

required

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

Body

application/json

Parameters to use for searching people.

person_name

string

person_titles

string[]

person_title_exact_match

boolean

person_seniorities

enum<string>[]

Available options:

Owner,

Founder,

C-Suite,

Partner,

VP,

Head,

Director,

Manager,

Senior,

Entry,

Intern,

Other,

Non-Manager,

Founder / Owner

person_departments

string[]

Available options: Supported departments

person_job_functions

string[]

Available options: Supported job functions

person_locations

string[]

person_exclude_locations

string[]

company_locations

string[]

company_exclude_locations

string[]

company_names

string[]

company_exclude_names

string[]

company_ids

string[]

company_exclude_ids

string[]

education_company_ids

string[]

education_company_names

string[]

company_domains

string[]

company_exclude_domains

string[]

company_linkedin_urls

string[]

company_exclude_linkedin_urls

string[]

company_domains_match_subsidiaries_and_affiliates

boolean

company_focuses

enum<string>[]

Available options:

b2b,

b2c

company_types

enum<string>[]

Available options:

Public Company,

Educational,

Self Employed,

Government Agency,

Non Profit,

Self Owned,

Privately Held,

Partnership

company_sizes

enum<string>[]

Available options:

1-10 employees,

11-50 employees,

51-200 employees,

201-500 employees,

501-1000 employees,

1001-5000 employees,

5001-10000 employees,

10001+ employees

company_industries

string[]

Available options: Supported industries

company_exclude_industries

string[]

Available options: Supported industries

linkedin_networks

string[]

Array of user email addresses. The LinkedIn networks of these users will be used for filtering results. Use the special string all_networks to include all LinkedIn networks associated with the account's users.

exclude_linkedin_networks

string[]

Array of user email addresses. The LinkedIn networks of these users will be excluded from the results. Use the special string all_networks to exclude all LinkedIn networks associated with the account's users.

company_investors

string[]

Array of investor names. Filter for companies that have received investment by any of the specified investors.

company_shares_investors_with

string[]

Array of company names. Filter for companies that share one or more common investors with the specified companies.

page

integer

default:1

page_size

integer

default:5

Required range: 1 <= x <= 100

Response

200

application/json

object

enum<string>

required

Available options:

person_search_result

results

object[]

required

results.id

string

required

results.object

enum<string>

required

Available options:

person

results.linkedin_url

string

required

results.name

string | null

results.email

string | null

results.first_name

string | null

results.last_name

string | null

results.title

string | null

results.headline

string | null

results.about

string | null

results.current_position_start_date

string | null

results.current_position_description

string | null

results.location

string | null

results.image_url

string

results.location_details

object

results.experiences

object[] | null

results.educations

object[] | null

results.phone_numbers

object[] | null

results.company

object

results.company.id

string

required

results.company.object

enum<string>

required

Available options:

company

results.company.linkedin_url

string

required

results.company.name

string | null

results.company.overview

string | null

results.company.website

string | null

results.company.keywords

string[] | null

results.company.followers

integer | null

results.company.estimated_number_of_employees

integer | null

results.company.size

enum<string> | null

Available options:

10001+ employees,

201-500 employees,

51-200 employees,

11-50 employees,

1-10 employees

results.company.location

string | null

results.company.location_details

object

results.company.logo_url

string

results.company.founded_year

integer | null

results.company.traffic_rank

integer | null

results.company.sic_codes

integer[] | null

results.company.naics_codes

integer[] | null

results.company.type

enum<string> | null

Available options:

Public Company,

Educational,

Self Employed,

Government Agency,

Non Profit,

Self Owned,

Privately Held,

Partnership

results.company.total_funding

integer | null

results.company.latest_funding_stage

enum<string> | null

Available options:

seed,

angel,

venture_round_unknown_series,

series_a,

series_b,

series_c,

series_d,

series_e,

series_f,

series_g,

series_h,

series_i,

series_j,

debt,

equity_crowdfunding,

convertible_note,

ico,

private_equity,

other

results.company.latest_funding_date

string | null

results.company.is_b2b

boolean | null

results.company.is_b2c

boolean | null

results.company.technologies

string[] | null

results.company.department_headcount

object

results.company.job_function_headcount

object

results.company.estimated_revenue

enum<string> | null

Available options:

$0-$1M,

$1M-$10M,

$10M-$100M,

$100M-$1B,

$1B+

results.company.revenue

integer | null

_pagination

object

required

_errors

object[]

Was this page helpful?

Single company enrichment Start batch of email validations

curl --request POST \
  --url https://api.amplemarket.com/people/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "person_name": "<string>",
  "person_titles": [
    "<string>"
  ],
  "person_title_exact_match": true,
  "person_seniorities": [
    "Owner"
  ],
  "person_departments": [
    "<string>"
  ],
  "person_job_functions": [
    "<string>"
  ],
  "person_locations": [
    "<string>"
  ],
  "person_exclude_locations": [
    "<string>"
  ],
  "company_locations": [
    "<string>"
  ],
  "company_exclude_locations": [
    "<string>"
  ],
  "company_names": [
    "<string>"
  ],
  "company_exclude_names": [
    "<string>"
  ],
  "company_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "company_exclude_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "education_company_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "education_company_names": [
    "<string>"
  ],
  "company_domains": [
    "<string>"
  ],
  "company_exclude_domains": [
    "<string>"
  ],
  "company_linkedin_urls": [
    "<string>"
  ],
  "company_exclude_linkedin_urls": [
    "<string>"
  ],
  "company_domains_match_subsidiaries_and_affiliates": true,
  "company_focuses": [
    "b2b"
  ],
  "company_types": [
    "Public Company"
  ],
  "company_sizes": [
    "1-10 employees"
  ],
  "company_industries": [
    "<string>"
  ],
  "company_exclude_industries": [
    "<string>"
  ],
  "linkedin_networks": [
    "<string>"
  ],
  "exclude_linkedin_networks": [
    "<string>"
  ],
  "company_investors": [
    "<string>"
  ],
  "company_shares_investors_with": [
    "<string>"
  ],
  "page": 1,
  "page_size": 5
}'

{
  "object": "person_search_result",
  "results": [
    {
      "id": "0196352a-c51f-7497-8f2a-aba19059ced0",
      "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://hilpert.example/aurelia",
      "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-c4d4-7ed2-bc58-6a242f5ef1f8",
        "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-c4d4-7ed2-bc58-6a242f5ef1f8",
        "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": {
          "legal": 67
        },
        "job_function_headcount": {
          "marketing": {
            "brand_management": 19,
            "field_marketing": 95
          },
          "engineering_technical": {
            "chemical_engineering": 22
          },
          "medical_health": {
            "chiropractics": 78,
            "medical_education_training": 14
          },
          "legal": {
            "ethics": 69
          },
          "revenue": {
            "field_outside_sales": 73
          },
          "information_technology": {
            "help_desk_desktop_services": 27,
            "infrastructure": 78,
            "virtualization": 95
          },
          "finance": {
            "internal_audit_control": 56
          }
        },
        "estimated_revenue": "$1M-$10M"
      }
    }
  ],
  "_pagination": {
    "page": 1,
    "page_size": 30,
    "total_pages": 1,
    "total": 1
  }
}

API Reference

Account Details

Users

Lead List

People Enrichment

Companies Enrichment

Searcher

Email Validation

Exclusion lists

Sequences

Calls

Contacts

Tasks

Phone numbers

Authorizations

Body

Response