# Prospect enrichment - Veezee

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

## Recipe

1. 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](/upgrade) before running the full batch, checkout credits the same key.
2. `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.
3. `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.
4. `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](/docs). A ready-made agent setup prompt: [/agent-setup/prompt.md](/agent-setup/prompt.md).

Installable skill: the [prospect-enrich pack](https://github.com/veezeehq/veezee-skills/blob/main/skills/prospect-enrich/SKILL.md) teaches your agent this whole job. Install every pack with `npx skills add veezeehq/veezee-skills` ([/docs/skills](/docs/skills)).