Prospect enrichment

Prospect enrichment turns a list of known profile identifiers into full profile data (role, current company, experience) for people you have already identified.

Recipe#

Try one lead free first: no signup, mint a key with POST /v1/keys/mint and call under a shared budget of 200 credits per IP per day. A batch of 100 leads needs more than that; buy a key at /upgrade before running the full batch, checkout credits the same key.
linkedin_resolve_url (optional): only for a dirty or ambiguous profile URL. A clean URL, slug, or URN goes straight to linkedin_get_profile. Cost: 2 credits.
linkedin_get_profile: one call per lead, with sections: ["experience"]. The first two sections are included in the base fetch; each section past two adds 2 credits, up to 4 sections total. Cost: 4 credits per lead.
get_usage: free, exempt from the rate limit, once you have a key. Check balance before a large batch instead of finding out mid-run.

Total cost#

400 credits for 100 leads at one section each, within the two included sections.

Limits worth knowing#

Realtime fetches need a paid key: a free key always serves cached (recent) data. On a paid key, freshness: "realtime" adds 2 credits per call, refunded automatically if the live fetch falls back to cached data.
Skip linkedin_resolve_url for identifiers you already trust; it spends 2 credits for nothing on a clean URL.
A profile flagged is_anonymous: true in a search result is private; linkedin_get_profile cannot dereference it.
Set max_credits on a call to cap its own spend; if the quote would exceed it, nothing is charged and the error carries credits_required (the exact quote) so you can decide with numbers, not prose. The cap survives into next_url, so paging stays capped.

Run it#

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

Installable skill: the prospect-enrich pack teaches your agent this whole job. Install every pack with npx skills add veezeehq/veezee-skills (/docs/skills).