Search

Search people

Search the Reverse Contact database for people matching filters (AND-combined) and return full profiles. Pass metadata.nextCursor back as cursor for the next page. perPage defaults to 25 and is capped at 100. Results are at data.data and cursor metadata at data.metadata. Filters are strictly validated: unknown fields, blank values and values outside a closed vocabulary return 422 with the offending field and suggestions, and cost 0 credits. Credits: 1 per profile delivered after privacy filtering. Zero results are free.

post/v2/search/people

Request

  • Base URL
    https://api.reversecontact.com
  • Auth
    HTTP bearer

Request body

firstNamestring

Filter by first name

lastNamestring

Filter by last name

headlinestring

Match text in the profile headline

isOpenToWorkboolean

Restrict to profiles flagged open to work

isCurrentlyEmployedboolean

Filter by whether a profile has a current employer

isPremiumboolean

Restrict to Social Premium members

isVerifiedboolean

Restrict to profiles with a verification badge

currentCompanyNamestring

Current employer name

excludeCurrentCompanyNamestring

Current employer name to exclude

keywordsstring

Words searched across the whole profile. Every word must appear, in any field; whole words only

changedJobsWithinDays30 | 60 | 90 | 120

Current position started within the last N days

maxDataAgeDatestring date-time

Only return profiles refreshed after this date

cursorstring

Opaque cursor returned in metadata.nextCursor

perPageinteger

Results per page (1-100, default 25)

Example request

{
  "currentFunction": "Sales",
  "currentSeniority": [
    "Director",
    "VP"
  ],
  "location": {
    "countryCode": "FR"
  },
  "perPage": 25
}

Response

People search results

successtrue required
errorunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.