Sign in

v1

latestOpenAPI 3.1.02026-07-241640107.8 KB
People Data API

People Search API

Search People by Criteria

post/person/search

Request body

startinteger

Start index of the request results (counting from 1)

page_sizeinteger

Maximum number of results to return per page [1-100]

order_by'relevance' | 'popularity' | 'score'

Example request

{
  "query": {
    "all_skills": [
      "python",
      "sql",
      "machine learning"
    ],
    "company_competitors": [
      "homedepot.com"
    ],
    "company_country_code": [
      "US"
    ],
    "company_domain": [
      "rocketreach.co"
    ],
    "company_email": [
      "info@rocketreach.co"
    ],
    "company_funding_max": [
      "50000000"
    ],
    "company_funding_min": [
      "1000000"
    ],
    "company_id": [
      "123456"
    ],
    "company_industry": [
      "Software Engineering"
    ],
    "company_industry_keywords": [
      "SaaS",
      "B2B"
    ],
    "company_intent": [
      "hiring"
    ],
    "company_job_posting_signal": [
      "Accounting Roles::one_month"
    ],
    "company_list": [
      "Example Company List"
    ],
    "company_list_id": [
      "12345"
    ],
    "company_naics_code": [
      "541330",
      "541512"
    ],
    "company_name": [
      "RocketReach"
    ],
    "company_news_signal": [
      "Funding::one_month"
    ],
    "company_news_timestamp": [
      "mergers & acquisitions::one_month"
    ],
    "company_publicly_traded": [
      "true"
    ],
    "company_revenue": [
      "10000000-50000000"
    ],
    "company_sic_code": [
      "7372"
    ],
    "company_size": [
      "51-200"
    ],
    "company_tag": [
      "unicorn"
    ],
    "company_website_url": [
      "rocketreach.co"
    ],
    "connections": [
      "500+"
    ],
    "contact_method": [
      "work email"
    ],
    "current_or_previous_title": [
      "VP of Sales"
    ],
    "current_title": [
      "Product Manager"
    ],
    "degree": [
      "Bachelors"
    ],
    "department": [
      "Product Management"
    ],
    "description": [
      "Experienced software engineer with a focus on backend development"
    ],
    "domain": [
      "rocketreach.co"
    ],
    "email": [
      "john.doe@rocketreach.co"
    ],
    "email_grade": "A-",
    "employer": [
      "RocketReach"
    ],
    "geo": [
      "North America"
    ],
    "growth": [
      "5-30::Engineering,six_months"
    ],
    "handle": [
      "johndoe"
    ],
    "health_credentials": [
      "MD",
      "RN",
      "PhD"
    ],
    "health_license": [
      "MA12345"
    ],
    "health_npi": [
      "1234567890"
    ],
    "health_specialization": [
      "Cardiology"
    ],
    "id": [
      "123456"
    ],
    "job_change_range_days": [
      "30"
    ],
    "job_change_signal": [
      "Company Change::one_month"
    ],
    "link": [
      "https://linkedin.com/in/johndoe"
    ],
    "major": [
      "Computer Science",
      "Biology"
    ],
    "management_levels": [
      "Director"
    ],
    "name": [
      "John Doe"
    ],
    "phone": [
      "+15555555555"
    ],
    "previous_company_id": [
      "123456"
    ],
    "previous_employer": [
      "Google"
    ],
    "previous_title": [
      "Software Engineer"
    ],
    "school": [
      "Stanford University"
    ],
    "skills": [
      "Python",
      "SQL"
    ],
    "state": [
      "MA"
    ],
    "update_time": [
      "2025-01-01"
    ],
    "years_experience": [
      "10"
    ]
  }
}

Response

Success. People search request accepted

idinteger

RocketReach internal unique profile ID

status'complete' | 'progress' | 'searching' | 'not queued'
namestring nullable

Name of the profile

profile_picstring nullable

URL containing this profile's picture (if available).

linksobject

Social media links for the profile

linkedin_urlstring nullable

LinkedIn URL of the profile

connectionsinteger

Number of LinkedIn connections for this profile

locationstring nullable

Location of the profile

citystring nullable

City of the profile

regionstring nullable

Region of the profile

countrystring

Country code of the profile

country_codestring nullable

Country code of the profile

current_titlestring nullable

Current job title of the profile

current_employerstring nullable

Current employer of the profile

current_employer_domainstring nullable

Domain for the employer of the profile

current_employer_websitestring nullable

Website for the employer of the profile

birth_yearinteger

Year of birth of the profile

current_employer_idinteger

RocketReach internal unique company ID

current_employer_linkedin_urlstring nullable

LinkedIn URL for the employer of the profile

region_latitudenumber double nullable

Latitude of the region of the profile

region_longitudenumber double nullable

Longitude of the region of the profile

suppressedstring

Returns True if this profile is blocked by a suppression list filter

update_timestring date-time

Timestamp of the last update for the profile

Example response

[
  {
    "update_time": "2023-10-01T12:00:00Z"
  }
]