Sign in
OpenAPI 3.0.3AGPL-3.0 license2026-08-2011401.7 MB

9217eedacbb8

public

Find people from public data

Search for people through an anonymous public web search; no connected account is needed. Results are public data, never signed-in LinkedIn details (connection degree, who engaged with a post, whether someone is reachable by message). Found profiles are saved as contacts and render as a people list; narrate a one-line count. limit (1-300, default 15) is how many profiles ONE call targets: a specific number sets it, a volume word with no ceiling raises it toward 100-300. Pass every plausible title, seniority, or city as an array on the SAME filter field in ONE call. more:true continues the SAME filters past people already found. exhaustion:"axes-exhausted" means every angle was tried: suggest a real change, do not call more:true again. exhaustion:"batch-failed" is a temporary vendor hiccup. A signal that would show in a headline (years in role, a school, a tool, freelance) belongs in filters.keywords, not a visit-first pass.

post/public/search

Request body

limitinteger

Target number of new profiles to return.

saveboolean

When true, found profiles are saved to your contacts.

moreboolean

Continue past the people an earlier search on these same filters already returned, instead of returning them again.

Response

Found and enriched people

source'public' required
providerstring required

The search provider that answered.

querystring required

The exact query sent, so a thin result set can be read rather than guessed at.

existingCountinteger

People this search matched who were ALREADY in your contacts. They are linked into the target pool but not re-listed in contacts, because they were not re-fetched. Absent when there were none. Without it a caller reads a matched contact as a missed one.

urlsFoundinteger required

Total profile URLs found.

newUrlsinteger required

URLs not already in your contacts.

hydratedinteger required

Profiles fetched and enriched in this call.

searchesinteger

How many searches it took to find these people.

searchesFailedinteger

Searches that did not reach the provider. When this is high the result says nothing about the market.

moreAvailableboolean

Whether asking again with more can still reach people you have not seen.

exhaustion'more-available' | 'axes-exhausted' | 'batch-failed'

Finer than moreAvailable: 'axes-exhausted' means every search angle for this audience has genuinely been tried, calling again with more will not find anybody new. 'batch-failed' means this attempt could not reach the search provider, worth retrying. 'more-available' is the ordinary case.

rateLimitedinteger

Profiles found but deferred because the scraping pool is busy.

notestring

Explanation when part of the result set was deferred.