Skip to main content
POST
Search people
Find people using company, role, location, or similar-profile criteria. Each returned person is saved to Jobin Contacts. Use their contactId to review the saved record. This action requires Scale or an eligible enterprise workspace. Each returned person costs 20 Jobin credits. Jobin reserves credits for your requested result limit, then charges for the people returned. Email and phone availability depends on your workspace’s access. Use contact enrichment when you need additional contact information.

Set your criteria

Use the structured company, people, locations, and similarTo fields. For a search around a city, use radiusAroundCity. limit defaults to 10 and accepts up to 20 people per request. Preferences rank results within each returned page.

Continue through results

For the next page, pass nextCursor from the response as cursor. Keep the same filters and limit. Leave out cursor on your first request. Each additional page is a new paid search. Rate limit: 10 requests/minute per endpoint and workgroup. Details.

Authorizations

x-api-key
string
header
required

Primary public authentication method. Create keys in Jobin.cloud under Workgroups > Integrations > Custom integration.

Body

application/json

People search request. Filters combine known profile data for precision with a broad people index for scale. Maximum 20 results per paid request. Strings are trimmed before validation.

company
object

Company filters for broad company matching and known profile evidence.

people
object

People filters. Rich evidence filters are verified against known profile data.

locations
object[]

Top-level person location filters. Each market has its own city, region, and country; radiusAroundCity resolves the in-radius locality catchment.

Maximum array length: 25
similarTo
object

Find more people like a supplied profile or example candidate.

cursor
string

Opaque nextCursor returned by a previous People Search page. Reuse the same filters and limit when continuing.

Maximum string length: 512
limit
integer
default:10

Maximum people to return. Defaults to 10; capped at 20. Each returned person costs 20 credits.

Required range: 1 <= x <= 20

Response

People search results.

One page of people search results.

items
object[]
count
integer

Number of results returned in this page.

nextCursor
string | null

Cursor for the next page, or null when no more results are available.

totalResults
integer | null

Total matching result count when available.

searchStrategy
object

Search execution and ranking information for the retrieved page.