Candidate sourcing

Candidate sourcing finds people who match a role at a target company, then fetches full profiles for the top matches.

Recipe

1. provision: get an API key. No signup, no card. Grants 500 credits to start.
2. get_company: resolve the target company once, by URL, slug, or numeric id. Returns the company's numeric id and URN for the search filter. Cost: 4 credits.
3. search_people: filter by title and current_company (the numeric id from step 2), limit: 30. Returns matches, each flagged is_anonymous if private. Cost: 12 credits.
4. get_profile: for the top 10 non-anonymous results, fetch with sections: ["experience", "education"]. Cost: 4 credits per call, 40 credits for 10.

Skip any result with is_anonymous: true; get_profile cannot dereference a private profile. Treat the search match itself as confirmation and move on.

Total cost

56 credits for one company lookup, one search at limit 30, and 10 profile fetches.

Limits worth knowing

• A trial key starts with 500 credits and caps search at 10 results per call; the limit: 30 step needs a claimed, upgraded account.
• Pass the company's numeric id (from get_company) when you want limit: 30; a company NAME filter with limit 30 is rejected.
• One search at a higher limit costs less than several at a low limit; a cursor page is priced fresh by its own limit, so paging does not save credits.
• Call get_usage (free, exempt from the rate limit) before a large batch to check balance.

Run it

Full reference: /docs. A ready-made agent setup prompt: /agent-setup/prompt.md.