Skip to main content
GET
Search companies that have at least one visible person in the authenticated organization’s graph. Matching is case-insensitive and checks the company name, FreshTalent company key, and LinkedIn URL. Results are ordered by the number of visible people and capped at 50; this endpoint has no pagination parameters.

Query

string
Optional company-name, key, or LinkedIn URL fragment. The Gateway trims the value. Omit it, or send an empty value, to browse all companies with visible people.
The search response uses the CompanySummary shape. For this endpoint, current_count is the number of distinct visible people linked to the company, while alum_count is 0 and role_mix is {}. Use Get company orbit for the calculated current/alumni counts, role mix, and people lists.

Response schema

Errors and recovery

  • 401 unauthorized: provide a valid API key in Authorization: Bearer ....
  • 402 payment_required: restore active organization access.
  • 5xx or a transient network failure: retry this read with bounded backoff, jitter, and a timeout.
  • 429: retry this idempotent GET with exponential backoff and jitter after slowing down. The shared Gateway limit is 300 requests per minute per client IP as the Gateway sees it. Honor Retry-After; see Rate limits.
An empty data array is a successful search with no visible company match, not a 404. See Errors for the common error envelope.

Next steps

Use the returned key with Get company orbit to retrieve the current team, leavers, role mix, and company metadata.