--- title: "⭐ Universal People Search API" method: POST path: "/universal/person/search" tags: ["People Data API"] --- # ⭐ Universal People Search API `POST /universal/person/search` Search People by Criteria ## Request body - APIUniversalCreditsSearchInput - `start` integer — Paginate through search results by returning results starting from this value (counting from 1). - `page_size` integer — Maximum number of search results to return per page. - `query` PersonQuery - `all_skills` string[] — Include profiles with all of these skills (Uses `AND` logic). - Example: `['python', 'sql', 'machine learning']` - `company_competitors` string[] — Include profiles with employers who have these competitors - Example: `['homedepot.com']` - `company_country_code` string[] — Include profiles with employers located in these country codes - Example: `['US']` - `company_domain` string[] — Include profiles with employers who have these company domains - Example: `['rocketreach.co']` - `company_email` string[] — Include profiles with employers who have these company emails - Example: `['info@rocketreach.co']` - `company_funding_max` string[] — Include profiles with employers below this amount of funding - Example: `['50000000']` - `company_funding_min` string[] — Include profiles with employers above this amount of funding - Example: `['1000000']` - `company_geo` string[] — Include results matching company_geo. - `company_id` string[] — Include profiles with employed by these company IDs - Example: `['123456']` - `company_industry` string[] — Include profiles with employers in these industries. See the full list of industries [here](https://docs.google.com/spreadsheets/d/1cYz3FwtNEWW7z9otNNZRIILQ63_hM1LQ9SgsXWayaaI/edit?gid=0#gid=0). - Example: `['Software Engineering']` - `company_industry_keywords` string[] — Include profiles with employers with these industry keywords - Example: `['SaaS', 'B2B']` - `company_intent` string[] — Search across 37,000 intent topics found [here](https://docs.google.com/spreadsheets/d/1nnk8ZOLr9GUzrPNy1pG_N_gVIhDpkc5XjE3Hh4J8M00/edit?gid=761283207#gid=761283207). Intent is only available on certain plans. Please reach out to our team to learn more.. - Example: `['hiring']` - `company_job_posting_signal` string[] — Hiring signals that identify companies that are actively building out specific departments. Full list of categories [here](https://docs.google.com/spreadsheets/d/1EZPVnOftbHNwDm0aXjiJ79dSpqcZ4JLnrNJPZxKXi5Q/edit?gid=2100271042#gid=2100271042). - Example: `['Accounting Roles::one_month']` - `company_list` string[] — Transforms [ company_list ] search terms into a list of [ company_id ] search terms. - Example: `['Example Company List']` - `company_list_id` string[] — Include results matching company_list_id. - Example: `['12345']` - `company_naics_code` string[] — Include profiles with employers with these NAICS codes - Example: `['541330', '541512']` - `company_name` string[] — Include profiles employed by these company names - Example: `['RocketReach']` - `company_news_signal` string[] — Search on news events within the 25 categories listed [here](https://docs.google.com/spreadsheets/d/1EZPVnOftbHNwDm0aXjiJ79dSpqcZ4JLnrNJPZxKXi5Q/edit?gid=577464958#gid=577464958"). - Example: `['Funding::one_month']` - `company_news_timestamp` string[] — company_news_timestamp deprecated, please use `company_news_signal` - `company_publicly_traded` string[] — Include results matching company_publicly_traded. - Example: `['true']` - `company_revenue` string[] — Include profiles with employers with these revenue values. - Example: `['10000000-50000000']` - `company_sic_code` string[] — Include profiles with employers with these SIC codes. - Example: `['7372']` - `company_size` string[] — Include profiles with employers with these sizes. - Example: `['51-200']` - `company_tag` string[] — Include profiles with employers with these company tags. - Example: `['unicorn']` - `company_website_url` string[] — Include profiles with employers with these website URLs. - Example: `['rocketreach.co']` - `connections` string[] — Include profiles with these connections. - Example: `['500+']` - `contact_method` string[] — Include profiles with these contact methods Options are: `mobile`, `phone`, `personal email`, and `work email`. Available with both AND and OR logic. - Example: `["work email OR personal email"]` or `["mobile AND personal email"]` - `current_or_previous_title` string[] — Include results matching current or previous job titles. - Example: `['VP of Sales']` - `current_title` string[] — Include profiles with these current job titles. - Example: `['Product Manager']` - `degree` string[] — Include profiles with these degrees. - Example: `['Bachelors']` - `department` string[] — Include profiles in these company departments. See the full list of departments [here](https://docs.google.com/spreadsheets/d/1EZPVnOftbHNwDm0aXjiJ79dSpqcZ4JLnrNJPZxKXi5Q/edit?gid=0#gid=0). - Example: `['Product Management']` - `description` string[] — Include profiles with these descriptions. - Example: `['Experienced software engineer with a focus on backend development']` - `domain` string[] — Include profiles with these domains. - Example: `['rocketreach.co']` - `email` string[] — Include profiles with these emails. - Example: `['john.doe@rocketreach.co']` - `email_grade` string, nullable — Specifies the minimum email confidence grade that a profile must have. Note: Email grades may be revalidated during lookup. As a result, you may occasionally see profiles whose email grade no longer matches the grade filter used in your search. Use the following format to specify personal or professional email grades: `::` - Allowed Grades: A, A-, or B. - Allowed Modifiers: professional only, personal only - Example: `'A-'` or `'A-::professional only'` - `employer` string[] — Include profiles employed by these companies. - Example: `['RocketReach']` - `geo` string[] — Include profiles located in these geographies. - Example: `['North America']` - `growth` string[] — Include growth numbers for specific departments and time ranges. Format: `min_percentage_growth-max_percentage_growth::Department,TimeRange` * min_percentage_growth: Minimum growth percentage to filter profiles * max_percentage_growth: Maximum growth percentage to filter profiles * Department: Name of the company department (e.g., Engineering, Sales) * TimeRange: Duration for the growth metric (e.g., six_months, one_year) - Example: `['5-30::Engineering,six_months']` - Example: `['-10--20::Sales,one_year']` - `handle` string[] — Include results matching handle. - Example: `['johndoe']` - `health_credentials` string[] — Include profiles with these health credentials. Only available on certain plans. Please reach out to our team to learn more. - Example: `['MD', 'RN', 'PhD']` - `health_license` string[] — Include profiles with these health licenses. Only available on certain plans. Please reach out to our team to learn more. - Example: `['MA12345']` - `health_npi` string[] — Include profiles with these health NPIs. Only available on certain plans. Please reach out to our team to learn more. - Example: `['1234567890']` - `health_specialization` string[] — Include profiles with these health specializations. Only available on certain plans. Please reach out to our team to learn more. - Example: `['Cardiology']` - `id` string[] — Include profiles with these RocketReach Profile IDs. - Example: `['123456']` - `job_change_range_days` string[] — job_change_range_days deprecated, please use `job_change_signal` - `job_change_signal` string[] — Detect when a contact changes companies or gets promoted (Time window options: one_week, one_month, three_months) - Example: `['Company Change::one_month']` - Example: `['Promotion::one_week']` - Example: `['Company Change AND Promotion::three_months']` - `keyword` string, nullable — Include results matching keyword. - Example: `['data enrichment']` - `keywords` string, nullable — Include results matching keywords. - Example: `['sales prospecting', 'data enrichment']` - `link` string[] — Include results matching link. - Example: `['https://linkedin.com/in/johndoe']` - `major` string[] — Include profiles with these majors. - Example: `['Computer Science', 'Biology']` - `management_levels` string[] — Include profiles at these management levels. See the full list of management levels [here](https://docs.google.com/spreadsheets/d/1EZPVnOftbHNwDm0aXjiJ79dSpqcZ4JLnrNJPZxKXi5Q/edit?gid=0#gid=0). - Example: `['Director']` - `name` string[] — Include profiles with these names. - Example: `['John Doe']` - `phone` string[] — Include profiles with these phone numbers. - Example: `['+15555555555']` - `previous_company_id` string[] — Include profiles who were previously employed at these RocketReach company IDs. - Example: `['123456']` - `previous_employer` string[] — Include profiles who were previously employed at these companies. - Example: `['Google']` - `previous_title` string[] — Include results matching previous_title. - Example: `['Software Engineer']` - `school` string[] — Include profiles who attended these schools. - Example: `['Stanford University']` - `skills` string[] — Include profiles listed with any of these skills (Uses `OR` logic). - Example: `['Python', 'SQL']` - `state` string[] — Include profiles located in these states. - Example: `['MA']` - `update_time` string[] — Include results that have been updated since the specified date. - Example: `['2025-01-01']` - `years_experience` string[] — Include profiles with this many years of experience. - Example: `['10']` - `order_by` 'relevance' | 'popularity' | 'score' ## Response `201` Success. People search request accepted - UniversalCreditPersonSearchOutput[] - `id` integer — RocketReach internal unique profile ID - `name` string, nullable — Name of the profile - `profile_pic` string, nullable — URL containing this profile's picture (if available). - `linkedin_url` string, nullable — LinkedIn URL of the profile - `connections` integer — Number of LinkedIn connections for this profile - `location` string, nullable — Location of the profile - `city` string, nullable — City of the profile - `region` string, nullable — Region of the profile - `country` string — Country code of the profile - `country_code` string, nullable — Country code of the profile - `current_title` string, nullable — Current job title of the profile - `current_employer` string, nullable — Current employer of the profile - `current_employer_domain` string, nullable — TDomain for the employer of the profile - `current_employer_website` string, nullable — Website for the employer of the profile - `teaser` object, nullable - `emails` string[] - `phones` object[] - `number` string, required - `is_premium` boolean, required - `office_phones` string[] - `preview` string[] - `is_premium_phone_available` boolean - `personal_emails` string[] - `professional_emails` string[] - `birth_year` integer — Year of birth of the profile - `current_employer_id` integer — RocketReach internal unique company ID - `current_employer_linkedin_url` string, nullable — LinkedIn URL for the employer of the profile - `region_latitude` number, double, nullable — Latitude of the region of the profile - `region_longitude` number, double, nullable — Longitude of the region of the profile - `suppressed` string — Returns True if this profile is blocked by a suppression list filter - `update_time` string, date-time — Timestamp of the last update for the profile ## Other responses - `400` — Bad Request. The request is malformed or missing required parameters. - `401` — Unauthorized. API Key is missing or invalid. - `403` — Forbidden. API Key lacks permission to perform this action. - `404` — Not Found. The requested resource (e.g., profile) does not exist. - `429` — Too Many Requests. API request limit reached -- slow down requests. - `500` — Internal Server Error. Unexpected error on RocketReach servers. Try again later. --- [API](https://skmtc.dev/rocketreach/apis/rocketreach-api.md) · [All operations](https://skmtc.dev/rocketreach/apis/rocketreach-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rocketreach/rocketreach-api/revisions/68b5a27dfb6d/schema)