# Company research - Veezee

Company research pulls a company's profile and its recent posts, for a single lookup or a repeating watchlist check.

## Recipe

1. A single check runs free: no signup, mint a key with `POST /v1/keys/mint` and call under a shared budget of 200 credits per IP per day. A recurring, scheduled watchlist needs more than that; buy a key at [/upgrade](/upgrade) first, checkout credits the same key.
2. `linkedin_get_company`: one call per company, by URL, slug, or numeric id. Returns name, size, industry, founding year, specialities, and the ids other tools use. Cost: 4 credits per company.
3. `linkedin_get_posts`: same identifier, one page per company. Returns recent posts with engagement counts. Cost: 4 credits per company; each further page is priced the same.
4. `get_usage`: free, exempt from the rate limit, once you have a key. Check balance before the next scheduled run.

## Total cost

40 credits for a 5-company check, one company fetch and one post page each.

## Limits worth knowing

- A paid key draws down the same balance each scheduled run, so budget across runs, not just within one.
- Realtime fetches need a paid key: a free key always serves cached (`recent`) data. On a paid key, `freshness: "realtime"` adds 2 credits to a call, refunded automatically on cached fallback. The default (`recent`) is free and usually a few hours old.
- A second page of posts costs the same as the first; pull only what you need.
- Set `max_credits` on a call to cap its own spend before it happens.

## Run it

Full reference: [/docs](/docs). A ready-made agent setup prompt: [/agent-setup/prompt.md](/agent-setup/prompt.md).

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