# Veezee full docs

LinkedIn, Reddit, and X (formerly Twitter) data for AI agents. No signup: your agent mints its own free key in one call (POST https://api.veezee.io/v1/keys/mint, no body), then the first data call returns data. An un-keyed call returns a machine-readable KEY_REQUIRED error carrying that same recipe. Paying is the only human step in the product.

---

## Error reference

Every tool below returns this same set of error codes. REST returns `application/problem+json`; MCP returns the same content as an error result. `message` is written as the next-turn instruction.

| Code | HTTP status | Retriable | Meaning |
| --- | --- | --- | --- |
| `INVALID_INPUT` | 400 | no | A parameter failed validation. Check param and message for what to fix. |
| `NOT_FOUND` | 404 | no | Nothing matches the given identifier or URL. |
| `UNAUTHORIZED` | 401 | no | Invalid, revoked, or unusable API key. |
| `NOT_ENTITLED` | 403 | no | This account is not enabled for the platform you called. |
| `INSUFFICIENT_CREDITS` | 402 | no | Your balance can't cover this call's quote. Check get_usage or add credits. |
| `QUOTE_EXCEEDS_MAX_CREDITS` | 402 | no | The call's quote is higher than the max_credits you set. Nothing was charged. |
| `IDEMPOTENCY_KEY_REQUIRED` | 400 | no | This is a metered call; send an Idempotency-Key header. |
| `IDEMPOTENCY_KEY_REUSED` | 409 | no | That Idempotency-Key was already used with different arguments. Use a new key for a new call. |
| `CONCURRENCY_LIMIT` | 429 | yes | Too many calls in flight for this key's plan. Wait for one to finish. |
| `RATE_LIMITED` | 429 | yes | Too many calls per minute for this key's plan. Back off and retry. |
| `TRIAL_CAP_EXCEEDED` | 403 | no | A trial-only limit was hit (concurrency, rate, search size, or realtime fetches). |
| `BUDGET_EXHAUSTED` | 503 | no | A configured spend budget has been used up. |
| `UPSTREAM_UNAVAILABLE` | 502 | yes | LinkedIn data wasn't reachable. Safe to retry. |
| `PAYLOAD_TOO_LARGE` | 413 | no | The request or response exceeded the size limit. |
| `INTERNAL` | 500 | yes | Something failed on our side. Safe to retry. |
| `AUTH_REQUIRED` | 401 | no |  |
| `KEY_REQUIRED` | 401 | no | No API key was sent. Mint one free at POST /v1/keys/mint and retry. |

Errors a payment can fix add fields to this shape. INSUFFICIENT_CREDITS, TRIAL_CAP_EXCEEDED, and BUDGET_EXHAUSTED carry `upgrade_url` (give it to your human) and `offer`, its machine-readable twin; RATE_LIMITED and CONCURRENCY_LIMIT carry both on trial accounts only, where a paid plan raises the limit. `offer` holds `offer_version` (1), `reason` (the error code), `currency` ("usd"), `recommended` (which pack to lead with, currently `flex`), `packs` (pack, mode, price_usd_cents, credits or credits_per_month, and `when`, a short label for when that pack fits), `rails` (currently `stripe_checkout`), `checkout_url` (the same account-bound link as `upgrade_url`), `resume`, and `refund_policy`. Follow `offer.resume` after payment: INSUFFICIENT_CREDITS retries the same call with the same Idempotency-Key; TRIAL_CAP_EXCEEDED and BUDGET_EXHAUSTED retry with a fresh key; the two limit codes clear on their own with back-off, payment only raises the limit. INSUFFICIENT_CREDITS also sets `credits_required`: the credits the failed call needed. The failed attempt charged nothing.

---

## MCP call shape

Every MCP tool call takes this envelope; only `name` and `arguments` change per tool:

```json
{ "method": "tools/call", "params": { "name": "<tool_name>", "arguments": { ... } } }
```

---

# Docs - Veezee

Everything to call Veezee's LinkedIn, Reddit, and X tools over MCP or REST.

## Index

- Connect your client (verified install snippets per MCP host): https://veezee.io/docs/clients
- Platforms: https://veezee.io/docs/linkedin, https://veezee.io/docs/reddit, https://veezee.io/docs/x
- Field reference: https://veezee.io/docs/fields
- Auth reference: https://veezee.io/auth.md
- Error reference: https://veezee.io/docs/errors
- OpenAPI: https://veezee.io/openapi.json
- SDK: https://veezee.io/docs/sdk
- CLI: https://veezee.io/docs/cli
- Agent skills: https://veezee.io/docs/skills
- Pricing: https://veezee.io/pricing
- AGENTS.md: https://veezee.io/AGENTS.md

## Getting started

Fastest path: fetch https://veezee.io/agent-setup/prompt.md and follow the setup instructions. The steps below are the same setup inline.

### 1. Mint a free key

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

No signup, no card, no human: one call returns a key, shown once, plus ready-made setup snippets. The CLI does this for you (`npx @veezee/sdk init`) and stores the key in `~/.veezee/config`.

### 2. Call the API

```
curl "https://api.veezee.io/v1/linkedin/profiles?identifier=williamhgates" \
  -H "Authorization: Bearer $VEEZEE_API_KEY"
```

The free key runs under a shared budget of 200 credits per IP per day, recent data only, no realtime, no `Idempotency-Key` needed. Call without a key and the response is a machine-readable `KEY_REQUIRED` error carrying this exact recipe, so any agent self-heals in one round-trip.

### 3. Or connect over MCP

```
https://mcp.veezee.io/linkedin
```

transport: streamable-http, same free budget as REST. Claude Code, claude.ai, and other clients that support the MCP authorization spec open a browser sign-in automatically (email code, no password, no card, no key to copy). Other clients: put the key from step 1 in your MCP client's connection headers.

### 4. Hit the daily cap? Buy credits

The error names `upgrade_url`: https://veezee.io/upgrade. Pick a pack and pay: checkout credits the same key, nothing to reconfigure. Send it as `Authorization: Bearer <api_key>` on every REST call (plus an `Idempotency-Key` header on metered routes), or in your MCP client's connection headers. That checkout is the only human step in the product.

Default path: use MCP when your host supports it, the SDK otherwise, REST as the fallback; the CLI and skills are conveniences layered on top of those.

## Platforms

- [LinkedIn](https://veezee.io/docs/linkedin): Structured people and company data for outreach, recruiting, and research.
- [Reddit](https://veezee.io/docs/reddit): Discussions and comment-level sentiment: what people actually say about a product, problem, or brand, straight from the comments.
- [X (formerly Twitter)](https://veezee.io/docs/x): Volume and recency: a deep chronological sweep across the whole platform, not just one community.

## Tools

- **linkedin_resolve_url** (2 credits): Identify a LinkedIn URL. [/docs/tools/linkedin_resolve_url](https://veezee.io/docs/tools/linkedin_resolve_url)
- **linkedin_get_profile** (4 credits): Get a LinkedIn person profile. [/docs/tools/linkedin_get_profile](https://veezee.io/docs/tools/linkedin_get_profile)
- **linkedin_search_people** (10 credits): Search people on LinkedIn. [/docs/tools/linkedin_search_people](https://veezee.io/docs/tools/linkedin_search_people)
- **linkedin_get_company** (4 credits): Get a LinkedIn company. [/docs/tools/linkedin_get_company](https://veezee.io/docs/tools/linkedin_get_company)
- **linkedin_get_posts** (4 credits): Get recent posts by a person or company. [/docs/tools/linkedin_get_posts](https://veezee.io/docs/tools/linkedin_get_posts)
- **reddit_search** (6 credits): Search Reddit posts, comments, subreddits, or users. [/docs/tools/reddit_search](https://veezee.io/docs/tools/reddit_search)
- **reddit_get_subreddit** (4 credits): Get subreddit details. [/docs/tools/reddit_get_subreddit](https://veezee.io/docs/tools/reddit_get_subreddit)
- **reddit_get_subreddit_posts** (4 credits): Get a subreddit's posts. [/docs/tools/reddit_get_subreddit_posts](https://veezee.io/docs/tools/reddit_get_subreddit_posts)
- **reddit_get_user** (4 credits): Get a Reddit user. [/docs/tools/reddit_get_user](https://veezee.io/docs/tools/reddit_get_user)
- **reddit_get_post** (4 credits): Get Reddit posts by id, with optional discussion thread. [/docs/tools/reddit_get_post](https://veezee.io/docs/tools/reddit_get_post)
- **reddit_resolve_url** (2 credits): Identify a Reddit URL. [/docs/tools/reddit_resolve_url](https://veezee.io/docs/tools/reddit_resolve_url)
- **x_search** (6 credits): Search X (formerly Twitter). [/docs/tools/x_search](https://veezee.io/docs/tools/x_search)
- **x_get_profile** (4 credits): Get an X profile. [/docs/tools/x_get_profile](https://veezee.io/docs/tools/x_get_profile)
- **x_get_tweets** (4 credits): Get an account's tweets. [/docs/tools/x_get_tweets](https://veezee.io/docs/tools/x_get_tweets)
- **x_get_tweet** (4 credits): Get one tweet with full metrics. [/docs/tools/x_get_tweet](https://veezee.io/docs/tools/x_get_tweet)
- **x_resolve_url** (2 credits): Identify an X URL. [/docs/tools/x_resolve_url](https://veezee.io/docs/tools/x_resolve_url)
- **get_usage** (0 credits): Check credits and recent charges. [/docs/tools/get_usage](https://veezee.io/docs/tools/get_usage)

## Reference

- Connect your client (verified install snippets per MCP host): https://veezee.io/docs/clients
- Use cases (candidate sourcing, outreach list building, prospect enrichment, account research, company research, brand monitoring, launch sentiment sweep, market research, post/voice research): https://veezee.io/use-cases/candidate-sourcing
- Field reference (every field Veezee actually serves, by entity): https://veezee.io/docs/fields
- Auth reference (every REST or CLI call needs a key, minted free; MCP clients that support the authorization spec sign in over the browser instead): https://veezee.io/auth.md
- Error reference (every error code, when it happens, and how to recover): https://veezee.io/docs/errors
- OpenAPI (the machine-readable REST contract): https://veezee.io/openapi.json
- SDK (npm install @veezee/sdk, typed TypeScript client): https://veezee.io/docs/sdk
- CLI (the veezee command, every tool as a subcommand): https://veezee.io/docs/cli
- Agent skills (installable SKILL.md packs for recurring jobs): https://veezee.io/docs/skills
- Pricing + cost examples: https://veezee.io/pricing
- AGENTS.md (non-obvious rules for agents calling Veezee): https://veezee.io/AGENTS.md

---

# LinkedIn - Veezee docs

Structured people and company data for outreach, recruiting, and research.

## Tools

- **linkedin_resolve_url** (2 credits): Identify a LinkedIn URL. [/docs/tools/linkedin_resolve_url](https://veezee.io/docs/tools/linkedin_resolve_url)
- **linkedin_get_profile** (4 credits): Get a LinkedIn person profile. [/docs/tools/linkedin_get_profile](https://veezee.io/docs/tools/linkedin_get_profile)
- **linkedin_search_people** (10 credits): Search people on LinkedIn. [/docs/tools/linkedin_search_people](https://veezee.io/docs/tools/linkedin_search_people)
- **linkedin_get_company** (4 credits): Get a LinkedIn company. [/docs/tools/linkedin_get_company](https://veezee.io/docs/tools/linkedin_get_company)
- **linkedin_get_posts** (4 credits): Get recent posts by a person or company. [/docs/tools/linkedin_get_posts](https://veezee.io/docs/tools/linkedin_get_posts)

`get_usage` checks balance and works the same way across every platform: free, 0 credits. https://veezee.io/docs/tools/get_usage

## Quickstart

### 1. Mint a free key

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

No signup, no card, no human: one call returns a key, shown once, plus ready-made setup snippets. The CLI does this for you (`npx @veezee/sdk init`) and stores the key in `~/.veezee/config`.

### 2. Call the API

```
curl "https://api.veezee.io/v1/linkedin/profiles?identifier=williamhgates" \
  -H "Authorization: Bearer $VEEZEE_API_KEY"
```

The free key runs under a shared budget of 200 credits per IP per day, recent data only, no realtime, no `Idempotency-Key` needed. Call without a key and the response is a machine-readable `KEY_REQUIRED` error carrying this exact recipe, so any agent self-heals in one round-trip.

### 3. Or connect over MCP

```
https://mcp.veezee.io/linkedin
```

transport: streamable-http, same free budget as REST. Claude Code, claude.ai, and other clients that support the MCP authorization spec open a browser sign-in automatically (email code, no password, no card, no key to copy). Other clients: put the key from step 1 in your MCP client's connection headers.

### 4. Hit the daily cap? Buy credits

The error names `upgrade_url`: https://veezee.io/upgrade. Pick a pack and pay: checkout credits the same key, nothing to reconfigure. Send it as `Authorization: Bearer <api_key>` on every REST call (plus an `Idempotency-Key` header on metered routes), or in your MCP client's connection headers. That checkout is the only human step in the product.

## What comes back

[url_resolution](https://veezee.io/docs/fields#url_resolution), [person](https://veezee.io/docs/fields#person), [people_search](https://veezee.io/docs/fields#people_search), [company](https://veezee.io/docs/fields#company), [posts](https://veezee.io/docs/fields#posts). Full field lists: https://veezee.io/docs/fields

## Limits

- Every tool is read-only: no posting, commenting, or messaging.
- No contact details: no email addresses or phone numbers.
- No company search by name: linkedin_get_company takes a URL, slug, or domain; resolve a name with linkedin_search_people's current_company filter instead.
- No keyword search across LinkedIn posts: linkedin_get_posts returns one entity's recent posts, not a search.

Other platforms: [Reddit](https://veezee.io/docs/reddit), [X (formerly Twitter)](https://veezee.io/docs/x).

LinkedIn API for AI agents: https://veezee.io/linkedin-api-for-ai-agents

Full tool reference: https://veezee.io/docs

---

# Reddit - Veezee docs

Discussions and comment-level sentiment: what people actually say about a product, problem, or brand, straight from the comments.

## Tools

- **reddit_search** (6 credits): Search Reddit posts, comments, subreddits, or users. [/docs/tools/reddit_search](https://veezee.io/docs/tools/reddit_search)
- **reddit_get_subreddit** (4 credits): Get subreddit details. [/docs/tools/reddit_get_subreddit](https://veezee.io/docs/tools/reddit_get_subreddit)
- **reddit_get_subreddit_posts** (4 credits): Get a subreddit's posts. [/docs/tools/reddit_get_subreddit_posts](https://veezee.io/docs/tools/reddit_get_subreddit_posts)
- **reddit_get_user** (4 credits): Get a Reddit user. [/docs/tools/reddit_get_user](https://veezee.io/docs/tools/reddit_get_user)
- **reddit_get_post** (4 credits): Get Reddit posts by id, with optional discussion thread. [/docs/tools/reddit_get_post](https://veezee.io/docs/tools/reddit_get_post)
- **reddit_resolve_url** (2 credits): Identify a Reddit URL. [/docs/tools/reddit_resolve_url](https://veezee.io/docs/tools/reddit_resolve_url)

`get_usage` checks balance and works the same way across every platform: free, 0 credits. https://veezee.io/docs/tools/get_usage

## Quickstart

### 1. Mint a free key

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

No signup, no card, no human: one call returns a key, shown once, plus ready-made setup snippets. The CLI does this for you (`npx @veezee/sdk init`) and stores the key in `~/.veezee/config`.

### 2. Call the API

```
curl "https://api.veezee.io/v1/reddit/subreddits?subreddit_name=selfhosted" \
  -H "Authorization: Bearer $VEEZEE_API_KEY"
```

The free key runs under a shared budget of 200 credits per IP per day, recent data only, no realtime, no `Idempotency-Key` needed. Call without a key and the response is a machine-readable `KEY_REQUIRED` error carrying this exact recipe, so any agent self-heals in one round-trip.

### 3. Or connect over MCP

```
https://mcp.veezee.io/reddit
```

transport: streamable-http, same free budget as REST. Claude Code, claude.ai, and other clients that support the MCP authorization spec open a browser sign-in automatically (email code, no password, no card, no key to copy). Other clients: put the key from step 1 in your MCP client's connection headers.

### 4. Hit the daily cap? Buy credits

The error names `upgrade_url`: https://veezee.io/upgrade. Pick a pack and pay: checkout credits the same key, nothing to reconfigure. Send it as `Authorization: Bearer <api_key>` on every REST call (plus an `Idempotency-Key` header on metered routes), or in your MCP client's connection headers. That checkout is the only human step in the product.

## What comes back

[reddit_search](https://veezee.io/docs/fields#reddit_search), [subreddit](https://veezee.io/docs/fields#subreddit), [reddit_posts](https://veezee.io/docs/fields#reddit_posts), [reddit_user](https://veezee.io/docs/fields#reddit_user), [reddit_thread](https://veezee.io/docs/fields#reddit_thread), [url_resolution](https://veezee.io/docs/fields#url_resolution). Full field lists: https://veezee.io/docs/fields

## Limits

- No server-side time window on comment search: filter results on created_at yourself, and poll with sort=new for monitoring.
- Discover result depth caps around a few hundred results per query; decompose a broad topic into several narrower queries instead of one wide one.
- Cached search results refresh on a 20-minute cycle: polling faster than that just replays the same page.

Other platforms: [LinkedIn](https://veezee.io/docs/linkedin), [X (formerly Twitter)](https://veezee.io/docs/x).

Reddit API for AI agents: https://veezee.io/reddit-api-for-ai-agents

Full tool reference: https://veezee.io/docs

---

# X (formerly Twitter) - Veezee docs

Volume and recency: a deep chronological sweep across the whole platform, not just one community.

## Tools

- **x_search** (6 credits): Search X (formerly Twitter). [/docs/tools/x_search](https://veezee.io/docs/tools/x_search)
- **x_get_profile** (4 credits): Get an X profile. [/docs/tools/x_get_profile](https://veezee.io/docs/tools/x_get_profile)
- **x_get_tweets** (4 credits): Get an account's tweets. [/docs/tools/x_get_tweets](https://veezee.io/docs/tools/x_get_tweets)
- **x_get_tweet** (4 credits): Get one tweet with full metrics. [/docs/tools/x_get_tweet](https://veezee.io/docs/tools/x_get_tweet)
- **x_resolve_url** (2 credits): Identify an X URL. [/docs/tools/x_resolve_url](https://veezee.io/docs/tools/x_resolve_url)

`get_usage` checks balance and works the same way across every platform: free, 0 credits. https://veezee.io/docs/tools/get_usage

## Quickstart

### 1. Mint a free key

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

No signup, no card, no human: one call returns a key, shown once, plus ready-made setup snippets. The CLI does this for you (`npx @veezee/sdk init`) and stores the key in `~/.veezee/config`.

### 2. Call the API

```
curl "https://api.veezee.io/v1/x/profiles?identifier=nasa" \
  -H "Authorization: Bearer $VEEZEE_API_KEY"
```

The free key runs under a shared budget of 200 credits per IP per day, recent data only, no realtime, no `Idempotency-Key` needed. Call without a key and the response is a machine-readable `KEY_REQUIRED` error carrying this exact recipe, so any agent self-heals in one round-trip.

### 3. Or connect over MCP

```
https://mcp.veezee.io/x
```

transport: streamable-http, same free budget as REST. Claude Code, claude.ai, and other clients that support the MCP authorization spec open a browser sign-in automatically (email code, no password, no card, no key to copy). Other clients: put the key from step 1 in your MCP client's connection headers.

### 4. Hit the daily cap? Buy credits

The error names `upgrade_url`: https://veezee.io/upgrade. Pick a pack and pay: checkout credits the same key, nothing to reconfigure. Send it as `Authorization: Bearer <api_key>` on every REST call (plus an `Idempotency-Key` header on metered routes), or in your MCP client's connection headers. That checkout is the only human step in the product.

## What comes back

[x_search](https://veezee.io/docs/fields#x_search), [x_profile](https://veezee.io/docs/fields#x_profile), [x_tweets](https://veezee.io/docs/fields#x_tweets), [x_tweet](https://veezee.io/docs/fields#x_tweet), [url_resolution](https://veezee.io/docs/fields#url_resolution). Full field lists: https://veezee.io/docs/fields

## Limits

- No batch tweet lookup: x_get_tweet fetches one tweet at a time.
- t.co links cannot be resolved offline: x_resolve_url returns INVALID_INPUT for them; expand them in a browser step first.
- People search returns a single page: x_search type=people has no cursor.

Other platforms: [LinkedIn](https://veezee.io/docs/linkedin), [Reddit](https://veezee.io/docs/reddit).

X (formerly Twitter) API for AI agents: https://veezee.io/x-api-for-ai-agents

Full tool reference: https://veezee.io/docs

---

## linkedin_resolve_url

Identify what a LinkedIn URL points at before fetching it. Give any LinkedIn profile, company, or post URL (utm params, www/m subdomains, trailing slashes are fine); get back {type: person|company|post, id, handle, canonical_url}. For profile URLs, id is the stable person URN; for company URLs, id is the stable company URN; for post URLs, id is the activity URN extracted from the URL. For people, use the returned handle or id with linkedin_get_profile or linkedin_get_posts. For companies, use the returned HANDLE with linkedin_get_company or linkedin_get_posts; the company URN/id is a linkedin_search_people filter input, not a fetch identifier. Costs 2 credits. Skip this tool when you already have a slug, URN, or clean URL: linkedin_get_profile and linkedin_get_company accept those directly, so resolving first would waste 2 credits. Not for non-LinkedIn URLs; it returns INVALID_INPUT for those.

Credits: 2. REST: `GET /v1/linkedin/resolve-url` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `url` | yes | `string` | A LinkedIn URL, e.g. https://www.linkedin.com/in/williamhgates or .../company/microsoft. |

### Example

```json
{
  "url": "https://www.linkedin.com/in/williamhgates?utm_source=share"
}
```

Output: returns a `url_resolution` envelope. Full field list: https://veezee.io/docs/fields#url_resolution

---

## linkedin_get_profile

Fetch one person's LinkedIn profile. identifier accepts a profile URL, the slug after /in/ (e.g. 'williamhgates'), or a urn:li:fsd_profile URN; URLs are cleaned automatically. Always returns the overview (name, headline, location, current position, follower counts) plus up to 2 requested sections from about|experience|education|skills at no extra cost; each section beyond 2 adds 2 credits (max 4 sections). Costs 4 credits base. If you only have a name, use linkedin_search_people first; this tool does not search. Results from linkedin_search_people with is_anonymous=true cannot be fetched here; treat them as 'someone matching this exists' and stop. Companies belong to linkedin_get_company.

Credits: 4. REST: `GET /v1/linkedin/profiles` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `identifier` | yes | `string` | Profile URL, slug (after /in/), or urn:li:fsd_profile URN. |
| `sections` | no | `array` | Extra profile sections. First 2 are included in the base price. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

### Example

```json
{
  "identifier": "williamhgates"
}
```

Output: returns a `person` envelope. Full field list: https://veezee.io/docs/fields#person

---

## linkedin_search_people

Find people on LinkedIn by keywords and filters. The right tool when you have a name, role, or 'who is the X at Y' question without a profile URL. Pass keywords (free text: name, title, or both) and any of first_name, last_name, title, school, current_company, past_company. If keywords is omitted it is derived from the name or title filters; school or company filters alone are rejected with INVALID_INPUT, so include keywords with those. Company filters accept a company name, slug, numeric id, or URN. current_company names are matched by LinkedIn's own company search: typo-tolerant and fuzzy, so results can include people whose headline merely mentions the company; when you need exact filtering, pass the numeric id or URN (linkedin_get_company returns both). past_company names are resolved to an id for you. Costs 10 credits including the first 10 results; each further 10 results add 1 credit (limit max 30; trial keys max 10). A cursor page is a NEW call priced the same way by its own limit, so one limit=30 call is much cheaper than three limit=10 pages; prefer a larger limit over paginating. Do NOT combine a past_company NAME or a company-URL filter with limit=30: resolving those spends one of the call's three internal fetches, so that combination is rejected; keep limit<=20 with them or pass the numeric id. current_company names never spend a fetch, so they combine with any limit. Returns name, position, location, urn, public_identifier per result, a cursor for the next page, and total_matches. Results with is_anonymous=true are private profiles; do not pass them to linkedin_get_profile. For one known person with a URL/slug, call linkedin_get_profile directly instead.

Credits: 10. REST: `GET /v1/linkedin/search` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `keywords` | no | `string` | Free-text query: a name, a title, or both. |
| `first_name` | no | `string` | First-name filter, exact match. |
| `last_name` | no | `string` | Last-name filter, exact match. |
| `title` | no | `string` | Current job title filter. |
| `school` | no | `string` | School or university name filter. |
| `current_company` | no | `string` | Company name, slug, numeric id, or urn:li:fsd_company URN. Names are fuzzy-matched by LinkedIn; ids and URNs filter exactly. |
| `past_company` | no | `string` | Same accepted forms as current_company; names are resolved to an id server-side. |
| `limit` | no | `integer` | How many results to return. |
| `cursor` | no | `string` | Cursor from a previous page. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

### Example

```json
{
  "keywords": "CTO",
  "current_company": "anthropic"
}
```

Output: returns a `people_search` envelope. Full field list: https://veezee.io/docs/fields#people_search

---

## linkedin_get_company

Fetch one company's LinkedIn page: name, description, industry, employee count, headquarters, website, founding year, specialities, and the URN/numeric id you need for linkedin_search_people company filters. identifier accepts a company URL, the slug after /company/ (e.g. 'microsoft'), or a website domain like 'microsoft.com'; numeric ids and URNs are search-filter inputs, not fetch identifiers. Domains are resolved to a company and verified against that company's website: a domain identifier always QUOTES base+4 credits (set max_credits accordingly), and the 4-credit resolution surcharge is refunded at settlement when the domain was resolved before, so known domains settle at the base price. A domain that cannot be verified to a company returns INVALID_INPUT with the closest matches instead of a guessed company. Costs 4 credits base. Do not guess a slug from a brand name: slugs are vanity strings and a famous name can belong to an unrelated company's page (linkedin.com/company/anthropic is a small investment fund, not the AI lab). When you only know the company's name, pass its website domain instead -- the verified form -- and sanity-check the returned industry and description against what you expected. This tool does not search by name: if you only have an approximate company name, use linkedin_search_people's current_company filter with keywords (names are matched natively there) or give the exact slug. For the company's posts, use linkedin_get_posts with the same identifier (URL, slug, or website domain all work there too).

Credits: 4. REST: `GET /v1/linkedin/companies` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `identifier` | yes | `string` | Company URL, slug (after /company/), or website domain (e.g. 'microsoft.com'). Numeric ids/URNs are not fetchable; use them only in linkedin_search_people company filters. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

### Example

```json
{
  "identifier": "microsoft"
}
```

Output: returns a `company` envelope. Full field list: https://veezee.io/docs/fields#company

---

## linkedin_get_posts

Fetch the recent LinkedIn posts of one person or one company. identifier accepts a profile or company URL, a slug, a person URN, or a company website domain like 'microsoft.com'; the entity type is detected automatically. A domain resolves to its verified company first, exactly like linkedin_get_company: it QUOTES base+4 credits (set max_credits accordingly) and the surcharge is refunded at settlement for already-known domains, so they settle at the base price. Company URNs and numeric company ids are search-filter inputs, not fetch identifiers: use the company slug, URL, or domain here. Returns one page of posts (text, created_at, author, likes, comments_count, shares, is_repost, url) with a cursor for older posts. Costs 4 credits per page. Use this for 'what has X been posting', voice-of-company research, or activity checks before outreach. Not for reading one specific post you already have a URL for, and not for keyword search across LinkedIn; neither is supported in v1.

Credits: 4. REST: `GET /v1/linkedin/posts` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `identifier` | yes | `string` | Person or company URL, slug, URN, or company website domain. |
| `cursor` | no | `string` | Cursor from a previous page for older posts. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

### Example

```json
{
  "identifier": "https://www.linkedin.com/company/microsoft/"
}
```

Output: returns a `posts` envelope. Full field list: https://veezee.io/docs/fields#posts

---

## reddit_search

Search all of Reddit by keywords. type picks the target: posts (default), comments (what people actually say about a product, problem, or brand -- unique to Reddit search), subreddits (find communities), users. Pass query as free text up to 256 characters; decompose broad topics into several narrower queries, since result depth per query is capped upstream around a few hundred results. sort applies to posts (relevance|top|new|hot|comment_count) and comments (relevance|top|new); range (past_hour..all_time) applies to posts only; both are rejected with INVALID_INPUT elsewhere. Costs 6 credits per page; a cursor page is a NEW call priced the same way. Returns one page of summaries (author, title or comment text, upvotes, comment_count, created_at, permalink, id) with a cursor; there is no server-side time window on comment search, so for monitoring filter on created_at yourself and poll with sort=new. Fetch full post bodies and discussion threads with reddit_get_post; read one community's feed with reddit_get_subreddit_posts. For high-volume recency sweeps across X instead, use x_search.

Credits: 6. REST: `GET /v1/reddit/search` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `query` | yes | `string` | Free-text keywords, e.g. 'self hosted photo backup'. Not a URL; use reddit_resolve_url for URLs. |
| `type` | no | `string` | What to search. 'comments' finds mentions inside discussions; 'subreddits' finds communities. |
| `sort` | no | `string` | posts: any value; comments: relevance|top|new; invalid for subreddits and users. |
| `range` | no | `string` | Time window. posts only. |
| `cursor` | no | `string` | Cursor from a previous page. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

### Example

```json
{
  "query": "notion alternative",
  "type": "comments"
}
```

Output: returns a `reddit_search` envelope. Full field list: https://veezee.io/docs/fields#reddit_search

---

## reddit_get_subreddit

Fetch one subreddit's profile: title, description, subscriber and active-user counts, age, NSFW flag, and topics. subreddit_name is the name without the r/ prefix, e.g. 'selfhosted'; a full reddit.com URL also works. Set include_settings to also get the community rules and moderator list for +2 credits (useful before posting or judging moderation culture). Costs 4 credits base. Subscriber counts here are the standard sizing signal for market research. This tool does not return posts: read the feed with reddit_get_subreddit_posts, and discover subreddits you don't know by name with reddit_search type=subreddits.

Credits: 4. REST: `GET /v1/reddit/subreddits` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `subreddit_name` | yes | `string` | Subreddit name without the r/ prefix, e.g. 'selfhosted'. Full URLs are accepted and cleaned. |
| `include_settings` | no | `boolean` | Also return rules and moderators for +2 credits. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

### Example

```json
{
  "subreddit_name": "selfhosted"
}
```

Output: returns a `subreddit` envelope. Full field list: https://veezee.io/docs/fields#subreddit

---

## reddit_get_subreddit_posts

Fetch one page of posts from a single subreddit, the community-monitoring primitive. subreddit_name is the name without the r/ prefix. sort defaults to the subreddit's own front-page order (best); use sort=new for monitoring. sort=top and controversial need a range, but the window is currently not applied upstream on this feed: top returns the subreddit's all-time top posts whatever range says (time-windowed tops are a known gap here; reddit_search's range DOES work for keyword queries). Costs 4 credits per page; a cursor page is a NEW call priced the same way. Reddit splices about one promoted ad into every feed page; these are dropped by default, so set include_promoted=true only when ads ARE the data you want (ad intelligence, who targets this community) -- kept ads carry is_promoted=true. Returns post summaries (title, author, upvotes, comment_count, created_at, permalink, id) with a cursor for older posts; bodies and discussions come from reddit_get_post with the returned ids. For keyword search across all of Reddit use reddit_search; this tool takes no query.

Credits: 4. REST: `GET /v1/reddit/subreddit-posts` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `subreddit_name` | yes | `string` | Subreddit name without the r/ prefix, e.g. 'selfhosted'. |
| `sort` | no | `string` | Defaults to the subreddit's front-page order. |
| `range` | no | `string` | Required with sort=top or controversial, but currently not applied upstream on this feed (results are all-time). |
| `include_promoted` | no | `boolean` | Keep the promoted ads Reddit splices into the feed (marked is_promoted). Default drops them. |
| `cursor` | no | `string` | Cursor from a previous page for older posts. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

### Example

```json
{
  "subreddit_name": "selfhosted",
  "sort": "new"
}
```

Output: returns a `reddit_posts` envelope. Full field list: https://veezee.io/docs/fields#reddit_posts

---

## reddit_get_user

Fetch one Reddit user's public profile: username, account age, karma, follower count, and description. username is the name without the u/ prefix, e.g. 'spez'; a full profile URL also works. Add up to 2 sections from comments|posts|subreddits at 2 credits each: comments and posts return that user's recent activity (first page), subreddits returns where they are active. Costs 4 credits base. Use this to profile loud voices found via reddit_search before quoting or engaging them. To find users by topic, use reddit_search type=users; this tool needs an exact username.

Credits: 4. REST: `GET /v1/reddit/users` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `username` | yes | `string` | Reddit username without the u/ prefix, e.g. 'spez'. Full profile URLs are accepted and cleaned. |
| `sections` | no | `array` | Extra activity sections, 2 credits each (max 2 per call). |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

### Example

```json
{
  "username": "spez"
}
```

Output: returns a `reddit_user` envelope. Full field list: https://veezee.io/docs/fields#reddit_user

---

## reddit_get_post

Fetch full post content for up to 100 Reddit posts by their t3_ ids in one call -- the follow-up loop after reddit_search or reddit_get_subreddit_posts. Costs 4 credits for up to 10 ids, +1 credit per further 10 ids; every post comes back with its full body text. With exactly ONE id you may set detail to 'full' for +4 credits to also get the discussion tree (comments flattened in tree order with depth, about 200 per page, with a comments_cursor to continue), or pass comment_id (a t1_ id, also +4 credits) to fetch one specific comment in its post context. Post ids come from the other Reddit tools or from reddit_resolve_url on a post URL. Not for discovering posts; search first, then batch-fetch here.

Credits: 4. REST: `GET /v1/reddit/posts` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `post_ids` | yes | `array` | 1 to 100 post ids with the t3_ prefix, e.g. ["t3_1tbups6"]. |
| `detail` | no | `string` | 'full' adds the discussion tree; only valid with exactly one id, +4 credits. |
| `comment_id` | no | `string` | A t1_ comment id to fetch in context; only valid with exactly one post id, +4 credits like detail 'full'. |
| `sort` | no | `string` | Discussion-tree order; only with detail 'full'. |
| `cursor` | no | `string` | comments_cursor from a previous detail='full' page. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

### Example

```json
{
  "post_ids": [
    "t3_1tbups6",
    "t3_1tbuneg"
  ]
}
```

Output: returns a `reddit_thread` envelope. Full field list: https://veezee.io/docs/fields#reddit_thread

---

## reddit_resolve_url

Identify what a Reddit URL points at before fetching it. Give any reddit.com or redd.it URL (share links, old.reddit.com, trailing params are fine); get back {type: subreddit|user|post|comment, id, handle, canonical_url}. Post URLs yield the t3_ id for reddit_get_post; comment permalinks yield the t1_ id; subreddit and user URLs yield the name for reddit_get_subreddit or reddit_get_user. Costs 2 credits and parses offline without fetching the page. Skip this tool when you already have a t3_/t1_ id, subreddit name, or username: the other Reddit tools accept those directly. Not for non-Reddit URLs; it returns INVALID_INPUT for those.

Credits: 2. REST: `GET /v1/reddit/resolve-url` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `url` | yes | `string` | A Reddit URL, e.g. https://www.reddit.com/r/selfhosted/comments/1tbups6/... or https://redd.it/1tbups6. |

### Example

```json
{
  "url": "https://redd.it/1tbups6"
}
```

Output: returns a `url_resolution` envelope. Full field list: https://veezee.io/docs/fields#url_resolution

---

## x_search

Search X by keywords. type picks the mode: recent (default) is the deep chronological sweep and keeps paginating as far as you follow the cursor; popular returns the highest-engagement tweets for the query; people finds accounts and returns a single page (no cursor). Advanced query operators pass through verbatim, e.g. "from:nasa", "min_faves:100", exact phrases in quotes -- there is no separate date parameter, so use since:/until: operators for time windows. Costs 6 credits per page; a cursor page is a NEW call priced the same way, so a deep sweep costs linearly in pages. Returns tweet summaries (text, author with follower count, views, likes, retweets, replies, created_at, url, id) with a cursor. Fetch one tweet's full detail with x_get_tweet and an account's timeline with x_get_tweets. For comment-level sentiment inside topic communities, reddit_search type=comments is usually the sharper instrument.

Credits: 6. REST: `GET /v1/x/search` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `query` | yes | `string` | Free-text keywords; X advanced operators work, e.g. 'claude code from:AnthropicAI since:2026-06-01'. |
| `type` | no | `string` | recent = chronological deep sweep; popular = top engagement; people = account search (single page). |
| `cursor` | no | `string` | Cursor from a previous page. Not valid with type 'people'. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

### Example

```json
{
  "query": "veezee api"
}
```

Output: returns a `x_search` envelope. Full field list: https://veezee.io/docs/fields#x_search

---

## x_get_profile

Fetch one X account's profile: name, bio, location, website, follower/following counts, tweet and media counts, verification state, and join date. identifier accepts a screen name without the @ (e.g. 'nasa'), a full x.com or twitter.com profile URL, or the numeric account id; numeric strings are treated as ids, and the rare all-digit handle can be forced with by='screen_name'. Costs 4 credits. The returned platform_fields.id is stable across handle changes; store it for repeat lookups. To find accounts by topic use x_search type=people, and to read what an account posts use x_get_tweets; this tool returns no tweets.

Credits: 4. REST: `GET /v1/x/profiles` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `identifier` | yes | `string` | Screen name without the @ (e.g. 'nasa'), profile URL, or numeric account id. |
| `by` | no | `string` | Force how identifier is interpreted; auto-detected when omitted. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

### Example

```json
{
  "identifier": "nasa"
}
```

Output: returns a `x_profile` envelope. Full field list: https://veezee.io/docs/fields#x_profile

---

## x_get_tweets

Fetch one page of an X account's timeline. identifier is a screen name, profile URL, or numeric id (auto-detected). mode picks the view: posts (default) is the account's own tweets, posts_and_replies includes their replies, highlights is the account's pinned highlights tab. include_retweets (default true) filters retweets out when false. Costs 4 credits per page; a cursor page is a NEW call priced the same way. Returns tweet summaries with engagement counts and a cursor for older tweets. Use this for 'what has X been posting', voice checks before outreach, or drafting replies in an account's register. For keyword search across all of X use x_search; for one specific tweet you already have, x_get_tweet.

Credits: 4. REST: `GET /v1/x/tweets` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `identifier` | yes | `string` | Screen name without the @, profile URL, or numeric account id. |
| `mode` | no | `string` | Which timeline view to read. |
| `include_retweets` | no | `boolean` | Set false to drop retweets from the page. |
| `cursor` | no | `string` | Cursor from a previous page for older tweets. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

### Example

```json
{
  "identifier": "nasa"
}
```

Output: returns a `x_tweets` envelope. Full field list: https://veezee.io/docs/fields#x_tweets

---

## x_get_tweet

Fetch one tweet by id with full engagement metrics: views, likes, retweets, quotes, replies, bookmarks, language, and the quoted tweet inline when there is one. tweet_id is the numeric id from a tweet URL (the digits after /status/) or from any other X tool's results; full tweet URLs are accepted too. Costs 4 credits. Use this to verify engagement before citing a tweet or to read a quoted thread hop by hop. It returns a single tweet, not the conversation around it: for the author's other tweets use x_get_tweets, and to find tweets by topic use x_search.

Credits: 4. REST: `GET /v1/x/tweet` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `tweet_id` | yes | `string` | Numeric tweet id, e.g. '2054497961162478079', or a full tweet URL. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

### Example

```json
{
  "tweet_id": "2054497961162478079"
}
```

Output: returns a `x_tweet` envelope. Full field list: https://veezee.io/docs/fields#x_tweet

---

## x_resolve_url

Identify what an X (formerly Twitter) URL points at before fetching it. Give any x.com or twitter.com URL (mobile links, query params, /i/web/status forms are fine); get back {type: profile|tweet, id, handle, canonical_url}. Tweet URLs yield the numeric id for x_get_tweet; profile URLs yield the handle for x_get_profile or x_get_tweets. Costs 2 credits and parses offline without fetching the page. t.co short links cannot be expanded offline and return INVALID_INPUT telling you so; expand them in your own browser step first. Skip this tool when you already have a handle or tweet id: the other X tools accept those directly.

Credits: 2. REST: `GET /v1/x/resolve-url` (auth: `required`, metered: `true`).

### Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `url` | yes | `string` | An X URL, e.g. https://x.com/nasa/status/2054497961162478079 or https://twitter.com/nasa. |

### Example

```json
{
  "url": "https://x.com/nasa/status/2054497961162478079"
}
```

Output: returns a `url_resolution` envelope. Full field list: https://veezee.io/docs/fields#url_resolution

---

## get_usage

Check your balance, plan, limits, and the last 10 charges (receipt ids included). Costs 0 credits and is exempt from the per-minute rate limit, so call it first to check your budget before running data tools, and any time after. Works the same on a trial key, a paid key, or an OAuth-connected account. The response includes upgrade_url (give it to your human when credits or plan limits block you; purchases credit this account directly with no login) and manage_url (give it to your human to change or cancel a paid plan in the Stripe billing portal). Trial accounts also get a claim_url that attaches an email so the account can be recovered if the key is lost. Not for fetching platform data.

Credits: 0. REST: `GET /v1/usage` (auth: `required`, metered: `false`).

### Parameters

No parameters.

### Example

```json
{}
```

Output: returns a `usage` envelope. Full field list: https://veezee.io/docs/fields#usage

---

# Connect your client - Veezee docs

One MCP server, many hosts. Endpoint: `https://mcp.veezee.io/all` (streamable-http, all three platforms on one connection; per-platform mounts `/linkedin`, `/reddit`, `/x`). Clients that support the MCP authorization spec (Claude Code, claude.ai, ChatGPT developer-mode connectors) open a Veezee sign-in in your browser on connect: email code, no password, no card, zero keys to copy. Other clients: mint a free key with `POST https://api.veezee.io/v1/keys/mint` and every host below connects under a shared per-IP daily budget; buy a key at https://veezee.io/upgrade for more. Snippets verified against each client's official docs on 2026-07-11; "tested" marks what was actually exercised against production.

## Claude Code

```
claude mcp add --transport http veezee "https://mcp.veezee.io/all?src=docs-clients"
```

Terminal; persists to ~/.claude.json (or project .mcp.json with --scope). Opens a Veezee sign-in in your browser (email code, no password, no card); approving it connects the account, zero keys involved. Headless or CI: mint a free key over REST instead and put it in the client's connection headers.. Status: tested end to end (real binary, 2026-07-11: linkedin_get_company at 4 credits, zero errors). Official docs: https://code.claude.com/docs/en/mcp

## claude.ai (web)

```
Settings > Connectors > Add custom connector > https://mcp.veezee.io/all?src=docs-clients
```

claude.ai settings UI, no config file. Team/Enterprise: Organization settings > Connectors. Enable per-chat from the + menu. Leave the optional client id/secret fields blank. Connecting opens a Veezee sign-in (email code, no password, no card); approving it connects the account, zero keys involved.. Status: config path verified against official docs; not app-tested. Official docs: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp

## ChatGPT

```
Settings > Security and login > Developer mode (on)
chatgpt.com/plugins > + > MCP server URL: https://mcp.veezee.io/all?src=docs-clients
```

ChatGPT settings UI, no config file; workspace plans may need admin approval for Developer mode. Adding the connector opens a Veezee sign-in (email code, no password, no card); approving it connects the account, zero keys involved.. Status: UI path verified against official docs 2026-07-19; not app-tested. Official docs: https://developers.openai.com/apps-sdk/deploy/connect-chatgpt

## Cursor

```
{
  "mcpServers": {
    "veezee": { "url": "https://mcp.veezee.io/all?src=docs-clients" }
  }
}
```

.cursor/mcp.json (project) or ~/.cursor/mcp.json (global). Status: config verified against official docs; desktop flow pending a human run (BLOCKERS.md). Official docs: https://cursor.com/docs/context/mcp

## Windsurf

```
{
  "mcpServers": {
    "veezee": { "serverUrl": "https://mcp.veezee.io/all?src=docs-clients" }
  }
}
```

~/.codeium/windsurf/mcp_config.json (note the serverUrl key, not url). Status: config verified against official docs; not app-tested. Official docs: https://docs.devin.ai/desktop/cascade/mcp

## VS Code (Copilot agent mode)

```
{
  "servers": {
    "veezee": { "type": "http", "url": "https://mcp.veezee.io/all?src=docs-clients" }
  }
}
```

.vscode/mcp.json (top-level key is "servers", and "type": "http" is required). Status: config verified against official docs; not app-tested. Official docs: https://code.visualstudio.com/docs/copilot/chat/mcp-servers

## Codex CLI

```
codex mcp add veezee --url "https://mcp.veezee.io/all?src=docs-clients"
codex mcp login veezee
codex mcp list   # verify: veezee listed with its tools

# or in ~/.codex/config.toml:
[mcp_servers.veezee]
url = "https://mcp.veezee.io/all?src=docs-clients"
```

~/.codex/config.toml. Known issue: some Codex builds complete the OAuth sign-in but never attach the server's tools (openai/codex issue 20009). If login succeeds and the Veezee tools still never appear, update Codex, or skip OAuth: mint a free key and set it via bearer_token_env_var (key path on /docs/cli). Status: tested end to end (real binary, headless codex exec, 2026-07-11: linkedin_get_company, error-recovery flow); commands re-verified against official docs 2026-07-19. Official docs: https://learn.chatgpt.com/docs/extend/mcp?surface=cli

## Cline

```
{
  "mcpServers": {
    "veezee": { "type": "streamableHttp", "url": "https://mcp.veezee.io/all?src=docs-clients" }
  }
}
```

Cline panel > MCP Servers > Remote Servers, or cline_mcp_settings.json. Set "type": "streamableHttp" explicitly.. Status: config verified against official docs; not app-tested. Official docs: https://docs.cline.bot/mcp/configuring-mcp-servers

## Zed

```
{
  "context_servers": {
    "veezee": { "url": "https://mcp.veezee.io/all?src=docs-clients" }
  }
}
```

Zed settings.json under "context_servers", or Settings > AI > MCP Servers > Add Remote Server. Status: config verified against official docs; not app-tested. Official docs: https://zed.dev/docs/ai/mcp

## Plain REST (curl)

```
curl -s -X POST https://api.veezee.io/v1/keys/mint | jq -r .key > ~/.veezee/key

curl "https://api.veezee.io/v1/linkedin/companies?identifier=microsoft" \
  -H "Authorization: Bearer $(cat ~/.veezee/key)"

# hit the daily cap? buy a key at https://veezee.io/upgrade, then:
curl "https://api.veezee.io/v1/linkedin/companies?identifier=microsoft" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

Any HTTP client. Contract: https://veezee.io/openapi.json. Metered calls need an Idempotency-Key header, even on GET (free-tier calls do not).. Status: tested end to end (the e2e suite runs this against production on every deploy). Official docs: https://veezee.io/openapi.json

## SDK

`npm install @veezee/sdk` (Node 20+): typed client for every tool, retries and Idempotency-Keys built in. `npm install -g @veezee/sdk` also gives the `veezee` CLI. Docs: https://veezee.io/docs/sdk and https://veezee.io/docs/cli.

All three servers are listed in the official MCP Registry: MCP Registry: io.veezee servers (https://registry.modelcontextprotocol.io/v0/servers?search=io.veezee).

---

# Field reference - Veezee docs

Every field Veezee serves, generated from https://veezee.io/openapi.json. Only served fields appear here; nothing upstream-only.

## url_resolution

| Field | Type | Description |
| --- | --- | --- |
| `entity` | `"url_resolution"` |  |
| `platform` | `linkedin | reddit | x | null` |  |
| `canonical_url` | `string | null` |  |
| `data_as_of` | `string | null` |  |
| `schema_version` | `"2"` |  |
| `common.input_url` | `string` |  |
| `common.type` | `person | company | post | subreddit | user | comment | profile | tweet` | What the URL points at, in the platform's own vocabulary. |
| `common.id` | `string | null` |  |
| `common.handle` | `string | null` |  |
| `common.canonical_url` | `string | null` |  |
| `freshness.source_retrieved_at` | `string | null` |  |
| `freshness.served_at` | `string` |  |
| `freshness.cache_age_seconds` | `integer | null` |  |
| `freshness.served_from_cache` | `boolean` | True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are. |
| `freshness.freshness_requested` | `recent | realtime` |  |
| `freshness.freshness_served` | `recent | realtime | stale` |  |
| `usage.receipt_id` | `string | null` |  |
| `usage.credits_quoted` | `integer` |  |
| `usage.credits_charged` | `integer` |  |
| `usage.balance_remaining` | `integer | null` |  |
| `usage.free_tier_hint` | `string` | Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits). |

## person

| Field | Type | Description |
| --- | --- | --- |
| `entity` | `"person"` |  |
| `platform` | `linkedin | reddit | x | null` |  |
| `canonical_url` | `string | null` |  |
| `data_as_of` | `string | null` |  |
| `schema_version` | `"2"` |  |
| `common.full_name` | `string` |  |
| `common.first_name` | `string | null` |  |
| `common.last_name` | `string | null` |  |
| `common.headline` | `string | null` |  |
| `common.location.name` | `string | null` |  |
| `common.location.country_code` | `string | null` |  |
| `common.about` | `string | null` |  |
| `common.current_position.company_name` | `string | null` |  |
| `common.current_position.company_handle` | `string | null` |  |
| `common.current_position.company_url` | `string | null` |  |
| `common.current_position.company_urn` | `string | null` |  |
| `common.current_position.start_year` | `integer | null` |  |
| `common.experience[].company.name` | `string | null` |  |
| `common.experience[].company.handle` | `string | null` |  |
| `common.experience[].company.url` | `string | null` |  |
| `common.experience[].positions[].role` | `string | null` |  |
| `common.experience[].positions[].location` | `string | null` |  |
| `common.experience[].positions[].is_current` | `boolean | null` |  |
| `common.experience[].positions[].start_date.month` | `integer | null` |  |
| `common.experience[].positions[].start_date.year` | `integer | null` |  |
| `common.experience[].positions[].end_date.month` | `integer | null` |  |
| `common.experience[].positions[].end_date.year` | `integer | null` |  |
| `common.education[].institution` | `string | null` |  |
| `common.education[].institution_url` | `string | null` |  |
| `common.education[].degree` | `string | null` |  |
| `common.education[].start_year` | `integer | null` |  |
| `common.education[].end_year` | `integer | null` |  |
| `common.skills[].name` | `string` |  |
| `common.skills[].endorsement_count` | `integer | null` |  |
| `common.followers` | `integer | null` |  |
| `common.connections` | `integer | null` |  |
| `common.is_verified` | `boolean | null` |  |
| `common.image_url` | `string | null` |  |
| `common.url` | `string` | Canonical LinkedIn profile URL. |
| `platform_fields.urn` | `string` | Stable LinkedIn URN (urn:li:fsd_profile:...). Use this for repeat lookups. |
| `platform_fields.public_identifier` | `string | null` |  |
| `platform_fields.is_influencer` | `boolean | null` |  |
| `platform_fields.is_creator` | `boolean | null` |  |
| `platform_fields.is_hiring` | `boolean | null` |  |
| `platform_fields.has_premium` | `boolean | null` |  |
| `platform_fields.open_to_messages` | `boolean | null` |  |
| `platform_fields.pronoun` | `string | null` |  |
| `freshness.source_retrieved_at` | `string | null` |  |
| `freshness.served_at` | `string` |  |
| `freshness.cache_age_seconds` | `integer | null` |  |
| `freshness.served_from_cache` | `boolean` | True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are. |
| `freshness.freshness_requested` | `recent | realtime` |  |
| `freshness.freshness_served` | `recent | realtime | stale` |  |
| `usage.receipt_id` | `string | null` |  |
| `usage.credits_quoted` | `integer` |  |
| `usage.credits_charged` | `integer` |  |
| `usage.balance_remaining` | `integer | null` |  |
| `usage.free_tier_hint` | `string` | Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits). |

## people_search

| Field | Type | Description |
| --- | --- | --- |
| `entity` | `"people_search"` |  |
| `platform` | `linkedin | reddit | x | null` |  |
| `canonical_url` | `string | null` |  |
| `data_as_of` | `string | null` |  |
| `schema_version` | `"2"` |  |
| `common.results[].name` | `string` |  |
| `common.results[].position` | `string | null` |  |
| `common.results[].location` | `string | null` |  |
| `common.results[].followers` | `integer | null` |  |
| `common.results[].is_verified` | `boolean | null` |  |
| `common.results[].image_url` | `string | null` |  |
| `common.results[].url` | `string | null` |  |
| `common.results[].urn` | `string` |  |
| `common.results[].public_identifier` | `string | null` |  |
| `common.results[].is_anonymous` | `boolean` | True when the profile is private: it exists but linkedin_get_profile cannot dereference it. Do not retry. |
| `common.cursor` | `string | null` |  |
| `common.next_url` | `string | null` |  |
| `common.total_matches` | `integer | null` |  |
| `common.returned_count` | `integer` |  |
| `common.truncation_hint` | `string | null` |  |
| `freshness.source_retrieved_at` | `string | null` |  |
| `freshness.served_at` | `string` |  |
| `freshness.cache_age_seconds` | `integer | null` |  |
| `freshness.served_from_cache` | `boolean` | True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are. |
| `freshness.freshness_requested` | `recent | realtime` |  |
| `freshness.freshness_served` | `recent | realtime | stale` |  |
| `usage.receipt_id` | `string | null` |  |
| `usage.credits_quoted` | `integer` |  |
| `usage.credits_charged` | `integer` |  |
| `usage.balance_remaining` | `integer | null` |  |
| `usage.free_tier_hint` | `string` | Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits). |

## company

| Field | Type | Description |
| --- | --- | --- |
| `entity` | `"company"` |  |
| `platform` | `linkedin | reddit | x | null` |  |
| `canonical_url` | `string | null` |  |
| `data_as_of` | `string | null` |  |
| `schema_version` | `"2"` |  |
| `common.name` | `string` |  |
| `common.description` | `string | null` |  |
| `common.website_url` | `string | null` |  |
| `common.industry` | `array<string>` |  |
| `common.employee_count` | `integer | null` |  |
| `common.employee_count_range` | `string | null` |  |
| `common.followers` | `integer | null` |  |
| `common.founded_year` | `integer | null` |  |
| `common.specialities` | `array<string>` |  |
| `common.headquarters.name` | `string | null` |  |
| `common.headquarters.country_code` | `string | null` |  |
| `common.logo_url` | `string | null` |  |
| `common.url` | `string` | Canonical LinkedIn company URL. |
| `platform_fields.urn` | `string` | Stable LinkedIn URN (urn:li:fsd_company:...). |
| `platform_fields.linkedin_id` | `integer | null` |  |
| `platform_fields.public_identifier` | `string | null` |  |
| `platform_fields.organization_type` | `string | null` |  |
| `platform_fields.stock_symbol` | `string | null` |  |
| `platform_fields.is_verified` | `boolean | null` |  |
| `freshness.source_retrieved_at` | `string | null` |  |
| `freshness.served_at` | `string` |  |
| `freshness.cache_age_seconds` | `integer | null` |  |
| `freshness.served_from_cache` | `boolean` | True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are. |
| `freshness.freshness_requested` | `recent | realtime` |  |
| `freshness.freshness_served` | `recent | realtime | stale` |  |
| `usage.receipt_id` | `string | null` |  |
| `usage.credits_quoted` | `integer` |  |
| `usage.credits_charged` | `integer` |  |
| `usage.balance_remaining` | `integer | null` |  |
| `usage.free_tier_hint` | `string` | Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits). |

## posts

| Field | Type | Description |
| --- | --- | --- |
| `entity` | `"posts"` |  |
| `platform` | `linkedin | reddit | x | null` |  |
| `canonical_url` | `string | null` |  |
| `data_as_of` | `string | null` |  |
| `schema_version` | `"2"` |  |
| `common.results[].urn` | `string` |  |
| `common.results[].url` | `string | null` |  |
| `common.results[].text` | `string | null` |  |
| `common.results[].created_at` | `string | null` |  |
| `common.results[].author.name` | `string | null` |  |
| `common.results[].author.url` | `string | null` |  |
| `common.results[].author.urn` | `string | null` |  |
| `common.results[].likes` | `integer | null` |  |
| `common.results[].comments_count` | `integer | null` |  |
| `common.results[].shares` | `integer | null` |  |
| `common.results[].is_repost` | `boolean | null` |  |
| `common.cursor` | `string | null` |  |
| `common.next_url` | `string | null` |  |
| `common.returned_count` | `integer` |  |
| `common.author_type` | `person | company` | What kind of entity the posts belong to. |
| `freshness.source_retrieved_at` | `string | null` |  |
| `freshness.served_at` | `string` |  |
| `freshness.cache_age_seconds` | `integer | null` |  |
| `freshness.served_from_cache` | `boolean` | True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are. |
| `freshness.freshness_requested` | `recent | realtime` |  |
| `freshness.freshness_served` | `recent | realtime | stale` |  |
| `usage.receipt_id` | `string | null` |  |
| `usage.credits_quoted` | `integer` |  |
| `usage.credits_charged` | `integer` |  |
| `usage.balance_remaining` | `integer | null` |  |
| `usage.free_tier_hint` | `string` | Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits). |

## reddit_search

| Field | Type | Description |
| --- | --- | --- |
| `entity` | `"reddit_search"` |  |
| `platform` | `linkedin | reddit | x | null` |  |
| `canonical_url` | `string | null` |  |
| `data_as_of` | `string | null` |  |
| `schema_version` | `"2"` |  |
| `common.type` | `posts | comments | subreddits | users` | Which result array is populated. |
| `common.posts[].id` | `string` | Post id with the t3_ prefix. Pass to reddit_get_post. |
| `common.posts[].title` | `string | null` |  |
| `common.posts[].author` | `string | null` |  |
| `common.posts[].subreddit.name` | `string` | Subreddit name without the r/ prefix, e.g. 'selfhosted'. |
| `common.posts[].subreddit.subscribers` | `integer | null` |  |
| `common.posts[].created_at` | `string | null` |  |
| `common.posts[].upvotes` | `integer | null` |  |
| `common.posts[].upvote_ratio` | `number | null` |  |
| `common.posts[].comment_count` | `integer | null` |  |
| `common.posts[].permalink` | `string | null` |  |
| `common.posts[].external_url` | `string | null` |  |
| `common.posts[].preview_text` | `string | null` |  |
| `common.posts[].flair` | `string | null` |  |
| `common.posts[].media_type` | `string | null` |  |
| `common.posts[].is_promoted` | `boolean` | True for promoted ads, which subreddit feeds include only when include_promoted=true. Organic posts are false. |
| `common.comments[].id` | `string` | Comment id with the t1_ prefix. |
| `common.comments[].author` | `string | null` |  |
| `common.comments[].content` | `string | null` |  |
| `common.comments[].created_at` | `string | null` |  |
| `common.comments[].upvotes` | `integer | null` |  |
| `common.comments[].permalink` | `string | null` |  |
| `common.comments[].parent_id` | `string | null` |  |
| `common.comments[].depth` | `integer | null` |  |
| `common.comments[].post.id` | `string | null` |  |
| `common.comments[].post.title` | `string | null` |  |
| `common.comments[].post.subreddit.name` | `string` | Subreddit name without the r/ prefix, e.g. 'selfhosted'. |
| `common.comments[].post.subreddit.subscribers` | `integer | null` |  |
| `common.subreddits[].name` | `string` |  |
| `common.subreddits[].description` | `string | null` |  |
| `common.subreddits[].subscribers` | `integer | null` |  |
| `common.users[].username` | `string` |  |
| `common.users[].created_at` | `string | null` |  |
| `common.users[].karma` | `integer | null` |  |
| `common.users[].profile_url` | `string | null` |  |
| `common.cursor` | `string | null` |  |
| `common.next_url` | `string | null` |  |
| `common.returned_count` | `integer` |  |
| `common.truncation_hint` | `string | null` |  |
| `freshness.source_retrieved_at` | `string | null` |  |
| `freshness.served_at` | `string` |  |
| `freshness.cache_age_seconds` | `integer | null` |  |
| `freshness.served_from_cache` | `boolean` | True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are. |
| `freshness.freshness_requested` | `recent | realtime` |  |
| `freshness.freshness_served` | `recent | realtime | stale` |  |
| `usage.receipt_id` | `string | null` |  |
| `usage.credits_quoted` | `integer` |  |
| `usage.credits_charged` | `integer` |  |
| `usage.balance_remaining` | `integer | null` |  |
| `usage.free_tier_hint` | `string` | Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits). |

## subreddit

| Field | Type | Description |
| --- | --- | --- |
| `entity` | `"subreddit"` |  |
| `platform` | `linkedin | reddit | x | null` |  |
| `canonical_url` | `string | null` |  |
| `data_as_of` | `string | null` |  |
| `schema_version` | `"2"` |  |
| `common.name` | `string` |  |
| `common.title` | `string | null` |  |
| `common.description` | `string | null` |  |
| `common.subscribers` | `integer | null` |  |
| `common.active_users` | `integer | null` |  |
| `common.created_at` | `string | null` |  |
| `common.is_nsfw` | `boolean | null` |  |
| `common.topics` | `array<string>` |  |
| `common.url` | `string` | Canonical reddit.com URL for the subreddit. |
| `common.rules[].name` | `string | null` |  |
| `common.rules[].description` | `string | null` |  |
| `common.moderators` | `array<string> | null` |  |
| `freshness.source_retrieved_at` | `string | null` |  |
| `freshness.served_at` | `string` |  |
| `freshness.cache_age_seconds` | `integer | null` |  |
| `freshness.served_from_cache` | `boolean` | True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are. |
| `freshness.freshness_requested` | `recent | realtime` |  |
| `freshness.freshness_served` | `recent | realtime | stale` |  |
| `usage.receipt_id` | `string | null` |  |
| `usage.credits_quoted` | `integer` |  |
| `usage.credits_charged` | `integer` |  |
| `usage.balance_remaining` | `integer | null` |  |
| `usage.free_tier_hint` | `string` | Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits). |

## reddit_posts

| Field | Type | Description |
| --- | --- | --- |
| `entity` | `"reddit_posts"` |  |
| `platform` | `linkedin | reddit | x | null` |  |
| `canonical_url` | `string | null` |  |
| `data_as_of` | `string | null` |  |
| `schema_version` | `"2"` |  |
| `common.results[].id` | `string` | Post id with the t3_ prefix. Pass to reddit_get_post. |
| `common.results[].title` | `string | null` |  |
| `common.results[].author` | `string | null` |  |
| `common.results[].subreddit.name` | `string` | Subreddit name without the r/ prefix, e.g. 'selfhosted'. |
| `common.results[].subreddit.subscribers` | `integer | null` |  |
| `common.results[].created_at` | `string | null` |  |
| `common.results[].upvotes` | `integer | null` |  |
| `common.results[].upvote_ratio` | `number | null` |  |
| `common.results[].comment_count` | `integer | null` |  |
| `common.results[].permalink` | `string | null` |  |
| `common.results[].external_url` | `string | null` |  |
| `common.results[].preview_text` | `string | null` |  |
| `common.results[].flair` | `string | null` |  |
| `common.results[].media_type` | `string | null` |  |
| `common.results[].is_promoted` | `boolean` | True for promoted ads, which subreddit feeds include only when include_promoted=true. Organic posts are false. |
| `common.cursor` | `string | null` |  |
| `common.next_url` | `string | null` |  |
| `common.returned_count` | `integer` |  |
| `freshness.source_retrieved_at` | `string | null` |  |
| `freshness.served_at` | `string` |  |
| `freshness.cache_age_seconds` | `integer | null` |  |
| `freshness.served_from_cache` | `boolean` | True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are. |
| `freshness.freshness_requested` | `recent | realtime` |  |
| `freshness.freshness_served` | `recent | realtime | stale` |  |
| `usage.receipt_id` | `string | null` |  |
| `usage.credits_quoted` | `integer` |  |
| `usage.credits_charged` | `integer` |  |
| `usage.balance_remaining` | `integer | null` |  |
| `usage.free_tier_hint` | `string` | Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits). |

## reddit_user

| Field | Type | Description |
| --- | --- | --- |
| `entity` | `"reddit_user"` |  |
| `platform` | `linkedin | reddit | x | null` |  |
| `canonical_url` | `string | null` |  |
| `data_as_of` | `string | null` |  |
| `schema_version` | `"2"` |  |
| `common.username` | `string` |  |
| `common.created_at` | `string | null` |  |
| `common.karma` | `integer | null` |  |
| `common.followers` | `integer | null` |  |
| `common.is_verified` | `boolean | null` |  |
| `common.description` | `string | null` |  |
| `common.account_type` | `string | null` |  |
| `common.url` | `string` | Canonical reddit.com URL for the user. |
| `common.comments[].id` | `string` | Comment id with the t1_ prefix. |
| `common.comments[].author` | `string | null` |  |
| `common.comments[].content` | `string | null` |  |
| `common.comments[].created_at` | `string | null` |  |
| `common.comments[].upvotes` | `integer | null` |  |
| `common.comments[].permalink` | `string | null` |  |
| `common.comments[].parent_id` | `string | null` |  |
| `common.comments[].depth` | `integer | null` |  |
| `common.comments[].post.id` | `string | null` |  |
| `common.comments[].post.title` | `string | null` |  |
| `common.comments[].post.subreddit.name` | `string` | Subreddit name without the r/ prefix, e.g. 'selfhosted'. |
| `common.comments[].post.subreddit.subscribers` | `integer | null` |  |
| `common.posts[].id` | `string` | Post id with the t3_ prefix. Pass to reddit_get_post. |
| `common.posts[].title` | `string | null` |  |
| `common.posts[].author` | `string | null` |  |
| `common.posts[].subreddit.name` | `string` | Subreddit name without the r/ prefix, e.g. 'selfhosted'. |
| `common.posts[].subreddit.subscribers` | `integer | null` |  |
| `common.posts[].created_at` | `string | null` |  |
| `common.posts[].upvotes` | `integer | null` |  |
| `common.posts[].upvote_ratio` | `number | null` |  |
| `common.posts[].comment_count` | `integer | null` |  |
| `common.posts[].permalink` | `string | null` |  |
| `common.posts[].external_url` | `string | null` |  |
| `common.posts[].preview_text` | `string | null` |  |
| `common.posts[].flair` | `string | null` |  |
| `common.posts[].media_type` | `string | null` |  |
| `common.posts[].is_promoted` | `boolean` | True for promoted ads, which subreddit feeds include only when include_promoted=true. Organic posts are false. |
| `common.subreddits[].name` | `string` | Subreddit name without the r/ prefix, e.g. 'selfhosted'. |
| `common.subreddits[].subscribers` | `integer | null` |  |
| `freshness.source_retrieved_at` | `string | null` |  |
| `freshness.served_at` | `string` |  |
| `freshness.cache_age_seconds` | `integer | null` |  |
| `freshness.served_from_cache` | `boolean` | True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are. |
| `freshness.freshness_requested` | `recent | realtime` |  |
| `freshness.freshness_served` | `recent | realtime | stale` |  |
| `usage.receipt_id` | `string | null` |  |
| `usage.credits_quoted` | `integer` |  |
| `usage.credits_charged` | `integer` |  |
| `usage.balance_remaining` | `integer | null` |  |
| `usage.free_tier_hint` | `string` | Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits). |

## reddit_thread

| Field | Type | Description |
| --- | --- | --- |
| `entity` | `"reddit_thread"` |  |
| `platform` | `linkedin | reddit | x | null` |  |
| `canonical_url` | `string | null` |  |
| `data_as_of` | `string | null` |  |
| `schema_version` | `"2"` |  |
| `common.posts[].id` | `string` | Post id with the t3_ prefix. Pass to reddit_get_post. |
| `common.posts[].title` | `string | null` |  |
| `common.posts[].author` | `string | null` |  |
| `common.posts[].subreddit.name` | `string` | Subreddit name without the r/ prefix, e.g. 'selfhosted'. |
| `common.posts[].subreddit.subscribers` | `integer | null` |  |
| `common.posts[].created_at` | `string | null` |  |
| `common.posts[].upvotes` | `integer | null` |  |
| `common.posts[].upvote_ratio` | `number | null` |  |
| `common.posts[].comment_count` | `integer | null` |  |
| `common.posts[].permalink` | `string | null` |  |
| `common.posts[].external_url` | `string | null` |  |
| `common.posts[].preview_text` | `string | null` |  |
| `common.posts[].flair` | `string | null` |  |
| `common.posts[].media_type` | `string | null` |  |
| `common.posts[].is_promoted` | `boolean` | True for promoted ads, which subreddit feeds include only when include_promoted=true. Organic posts are false. |
| `common.posts[].content` | `string | null` |  |
| `common.comments[].id` | `string` | Comment id with the t1_ prefix. |
| `common.comments[].author` | `string | null` |  |
| `common.comments[].content` | `string | null` |  |
| `common.comments[].created_at` | `string | null` |  |
| `common.comments[].upvotes` | `integer | null` |  |
| `common.comments[].permalink` | `string | null` |  |
| `common.comments[].parent_id` | `string | null` |  |
| `common.comments[].depth` | `integer | null` |  |
| `common.comments[].post.id` | `string | null` |  |
| `common.comments[].post.title` | `string | null` |  |
| `common.comments[].post.subreddit.name` | `string` | Subreddit name without the r/ prefix, e.g. 'selfhosted'. |
| `common.comments[].post.subreddit.subscribers` | `integer | null` |  |
| `common.comments_cursor` | `string | null` |  |
| `common.returned_count` | `integer` |  |
| `freshness.source_retrieved_at` | `string | null` |  |
| `freshness.served_at` | `string` |  |
| `freshness.cache_age_seconds` | `integer | null` |  |
| `freshness.served_from_cache` | `boolean` | True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are. |
| `freshness.freshness_requested` | `recent | realtime` |  |
| `freshness.freshness_served` | `recent | realtime | stale` |  |
| `usage.receipt_id` | `string | null` |  |
| `usage.credits_quoted` | `integer` |  |
| `usage.credits_charged` | `integer` |  |
| `usage.balance_remaining` | `integer | null` |  |
| `usage.free_tier_hint` | `string` | Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits). |

## x_search

| Field | Type | Description |
| --- | --- | --- |
| `entity` | `"x_search"` |  |
| `platform` | `linkedin | reddit | x | null` |  |
| `canonical_url` | `string | null` |  |
| `data_as_of` | `string | null` |  |
| `schema_version` | `"2"` |  |
| `common.type` | `recent | popular | people` | Which result array is populated. |
| `common.tweets[].id` | `string` | Numeric tweet id as a string. Pass to x_get_tweet. |
| `common.tweets[].text` | `string | null` |  |
| `common.tweets[].author.screen_name` | `string | null` |  |
| `common.tweets[].author.name` | `string | null` |  |
| `common.tweets[].author.id` | `string | null` |  |
| `common.tweets[].author.followers` | `integer | null` |  |
| `common.tweets[].author.is_verified` | `boolean | null` |  |
| `common.tweets[].created_at` | `string | null` |  |
| `common.tweets[].url` | `string | null` |  |
| `common.tweets[].views` | `integer | null` |  |
| `common.tweets[].likes` | `integer | null` |  |
| `common.tweets[].retweets` | `integer | null` |  |
| `common.tweets[].replies` | `integer | null` |  |
| `common.tweets[].quotes` | `integer | null` |  |
| `common.tweets[].bookmarks` | `integer | null` |  |
| `common.tweets[].lang` | `string | null` |  |
| `common.tweets[].is_reply` | `boolean | null` |  |
| `common.tweets[].is_retweet` | `boolean | null` |  |
| `common.tweets[].is_quote` | `boolean | null` |  |
| `common.tweets[].in_reply_to_screen_name` | `string | null` |  |
| `common.tweets[].conversation_id` | `string | null` |  |
| `common.tweets[].possibly_sensitive` | `boolean | null` |  |
| `common.people[].screen_name` | `string | null` |  |
| `common.people[].name` | `string | null` |  |
| `common.people[].id` | `string | null` |  |
| `common.people[].followers` | `integer | null` |  |
| `common.people[].is_verified` | `boolean | null` |  |
| `common.people[].description` | `string | null` |  |
| `common.people[].location` | `string | null` |  |
| `common.cursor` | `string | null` |  |
| `common.next_url` | `string | null` |  |
| `common.returned_count` | `integer` |  |
| `common.truncation_hint` | `string | null` |  |
| `freshness.source_retrieved_at` | `string | null` |  |
| `freshness.served_at` | `string` |  |
| `freshness.cache_age_seconds` | `integer | null` |  |
| `freshness.served_from_cache` | `boolean` | True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are. |
| `freshness.freshness_requested` | `recent | realtime` |  |
| `freshness.freshness_served` | `recent | realtime | stale` |  |
| `usage.receipt_id` | `string | null` |  |
| `usage.credits_quoted` | `integer` |  |
| `usage.credits_charged` | `integer` |  |
| `usage.balance_remaining` | `integer | null` |  |
| `usage.free_tier_hint` | `string` | Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits). |

## x_profile

| Field | Type | Description |
| --- | --- | --- |
| `entity` | `"x_profile"` |  |
| `platform` | `linkedin | reddit | x | null` |  |
| `canonical_url` | `string | null` |  |
| `data_as_of` | `string | null` |  |
| `schema_version` | `"2"` |  |
| `common.screen_name` | `string` |  |
| `common.name` | `string | null` |  |
| `common.description` | `string | null` |  |
| `common.location` | `string | null` |  |
| `common.website_url` | `string | null` |  |
| `common.created_at` | `string | null` |  |
| `common.followers` | `integer | null` |  |
| `common.following` | `integer | null` |  |
| `common.tweets_count` | `integer | null` |  |
| `common.media_count` | `integer | null` |  |
| `common.is_verified` | `boolean | null` |  |
| `common.verified_type` | `string | null` |  |
| `common.is_protected` | `boolean | null` |  |
| `common.image_url` | `string | null` |  |
| `common.banner_url` | `string | null` |  |
| `common.url` | `string` | Canonical x.com profile URL. |
| `platform_fields.id` | `string` | Numeric account id as a string; stable across handle changes. Use for repeat lookups. |
| `platform_fields.pinned_tweet_ids` | `array<string> | null` |  |
| `platform_fields.is_business_account` | `boolean | null` |  |
| `freshness.source_retrieved_at` | `string | null` |  |
| `freshness.served_at` | `string` |  |
| `freshness.cache_age_seconds` | `integer | null` |  |
| `freshness.served_from_cache` | `boolean` | True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are. |
| `freshness.freshness_requested` | `recent | realtime` |  |
| `freshness.freshness_served` | `recent | realtime | stale` |  |
| `usage.receipt_id` | `string | null` |  |
| `usage.credits_quoted` | `integer` |  |
| `usage.credits_charged` | `integer` |  |
| `usage.balance_remaining` | `integer | null` |  |
| `usage.free_tier_hint` | `string` | Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits). |

## x_tweets

| Field | Type | Description |
| --- | --- | --- |
| `entity` | `"x_tweets"` |  |
| `platform` | `linkedin | reddit | x | null` |  |
| `canonical_url` | `string | null` |  |
| `data_as_of` | `string | null` |  |
| `schema_version` | `"2"` |  |
| `common.results[].id` | `string` | Numeric tweet id as a string. Pass to x_get_tweet. |
| `common.results[].text` | `string | null` |  |
| `common.results[].author.screen_name` | `string | null` |  |
| `common.results[].author.name` | `string | null` |  |
| `common.results[].author.id` | `string | null` |  |
| `common.results[].author.followers` | `integer | null` |  |
| `common.results[].author.is_verified` | `boolean | null` |  |
| `common.results[].created_at` | `string | null` |  |
| `common.results[].url` | `string | null` |  |
| `common.results[].views` | `integer | null` |  |
| `common.results[].likes` | `integer | null` |  |
| `common.results[].retweets` | `integer | null` |  |
| `common.results[].replies` | `integer | null` |  |
| `common.results[].quotes` | `integer | null` |  |
| `common.results[].bookmarks` | `integer | null` |  |
| `common.results[].lang` | `string | null` |  |
| `common.results[].is_reply` | `boolean | null` |  |
| `common.results[].is_retweet` | `boolean | null` |  |
| `common.results[].is_quote` | `boolean | null` |  |
| `common.results[].in_reply_to_screen_name` | `string | null` |  |
| `common.results[].conversation_id` | `string | null` |  |
| `common.results[].possibly_sensitive` | `boolean | null` |  |
| `common.cursor` | `string | null` |  |
| `common.next_url` | `string | null` |  |
| `common.returned_count` | `integer` |  |
| `freshness.source_retrieved_at` | `string | null` |  |
| `freshness.served_at` | `string` |  |
| `freshness.cache_age_seconds` | `integer | null` |  |
| `freshness.served_from_cache` | `boolean` | True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are. |
| `freshness.freshness_requested` | `recent | realtime` |  |
| `freshness.freshness_served` | `recent | realtime | stale` |  |
| `usage.receipt_id` | `string | null` |  |
| `usage.credits_quoted` | `integer` |  |
| `usage.credits_charged` | `integer` |  |
| `usage.balance_remaining` | `integer | null` |  |
| `usage.free_tier_hint` | `string` | Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits). |

## x_tweet

| Field | Type | Description |
| --- | --- | --- |
| `entity` | `"x_tweet"` |  |
| `platform` | `linkedin | reddit | x | null` |  |
| `canonical_url` | `string | null` |  |
| `data_as_of` | `string | null` |  |
| `schema_version` | `"2"` |  |
| `common.id` | `string` | Numeric tweet id as a string. Pass to x_get_tweet. |
| `common.text` | `string | null` |  |
| `common.author.screen_name` | `string | null` |  |
| `common.author.name` | `string | null` |  |
| `common.author.id` | `string | null` |  |
| `common.author.followers` | `integer | null` |  |
| `common.author.is_verified` | `boolean | null` |  |
| `common.created_at` | `string | null` |  |
| `common.url` | `string | null` |  |
| `common.views` | `integer | null` |  |
| `common.likes` | `integer | null` |  |
| `common.retweets` | `integer | null` |  |
| `common.replies` | `integer | null` |  |
| `common.quotes` | `integer | null` |  |
| `common.bookmarks` | `integer | null` |  |
| `common.lang` | `string | null` |  |
| `common.is_reply` | `boolean | null` |  |
| `common.is_retweet` | `boolean | null` |  |
| `common.is_quote` | `boolean | null` |  |
| `common.in_reply_to_screen_name` | `string | null` |  |
| `common.conversation_id` | `string | null` |  |
| `common.possibly_sensitive` | `boolean | null` |  |
| `common.quoted_tweet.id` | `string` | Numeric tweet id as a string. Pass to x_get_tweet. |
| `common.quoted_tweet.text` | `string | null` |  |
| `common.quoted_tweet.author.screen_name` | `string | null` |  |
| `common.quoted_tweet.author.name` | `string | null` |  |
| `common.quoted_tweet.author.id` | `string | null` |  |
| `common.quoted_tweet.author.followers` | `integer | null` |  |
| `common.quoted_tweet.author.is_verified` | `boolean | null` |  |
| `common.quoted_tweet.created_at` | `string | null` |  |
| `common.quoted_tweet.url` | `string | null` |  |
| `common.quoted_tweet.views` | `integer | null` |  |
| `common.quoted_tweet.likes` | `integer | null` |  |
| `common.quoted_tweet.retweets` | `integer | null` |  |
| `common.quoted_tweet.replies` | `integer | null` |  |
| `common.quoted_tweet.quotes` | `integer | null` |  |
| `common.quoted_tweet.bookmarks` | `integer | null` |  |
| `common.quoted_tweet.lang` | `string | null` |  |
| `common.quoted_tweet.is_reply` | `boolean | null` |  |
| `common.quoted_tweet.is_retweet` | `boolean | null` |  |
| `common.quoted_tweet.is_quote` | `boolean | null` |  |
| `common.quoted_tweet.in_reply_to_screen_name` | `string | null` |  |
| `common.quoted_tweet.conversation_id` | `string | null` |  |
| `common.quoted_tweet.possibly_sensitive` | `boolean | null` |  |
| `freshness.source_retrieved_at` | `string | null` |  |
| `freshness.served_at` | `string` |  |
| `freshness.cache_age_seconds` | `integer | null` |  |
| `freshness.served_from_cache` | `boolean` | True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are. |
| `freshness.freshness_requested` | `recent | realtime` |  |
| `freshness.freshness_served` | `recent | realtime | stale` |  |
| `usage.receipt_id` | `string | null` |  |
| `usage.credits_quoted` | `integer` |  |
| `usage.credits_charged` | `integer` |  |
| `usage.balance_remaining` | `integer | null` |  |
| `usage.free_tier_hint` | `string` | Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits). |

## usage

| Field | Type | Description |
| --- | --- | --- |
| `entity` | `"usage"` |  |
| `platform` | `linkedin | reddit | x | null` |  |
| `canonical_url` | `string | null` |  |
| `data_as_of` | `string | null` |  |
| `schema_version` | `"2"` |  |
| `common.plan` | `trial | payg | flex | production` |  |
| `common.platforms` | `array<string>` | Platforms this account's key may call. Grants are explicit; write to hello@veezee.io to enable more. |
| `common.balance_remaining` | `integer` |  |
| `common.free_tier.credits_per_ip_day` | `integer` |  |
| `common.free_tier.used_today` | `integer` |  |
| `common.free_tier.remaining_today` | `integer` |  |
| `common.free_tier.resets` | `string` | UTC midnight when the day budget resets. ISO 8601. |
| `common.realtime_ops_used` | `integer` |  |
| `common.realtime_ops_limit` | `integer | null` |  |
| `common.concurrent_limit` | `integer` |  |
| `common.recent_receipts[].receipt_id` | `string` |  |
| `common.recent_receipts[].tool` | `string` |  |
| `common.recent_receipts[].credits_charged` | `integer` |  |
| `common.recent_receipts[].created_at` | `string` |  |
| `common.claim_url` | `string | null` |  |
| `common.upgrade_url` | `string` | Give this link to your human to add credits or upgrade; purchases credit THIS account with no login. |
| `common.manage_url` | `string` | Give this link to your human to change or cancel a paid plan in the Stripe billing portal. Valid at least 24 hours; call get_usage again for a fresh one. |
| `freshness.source_retrieved_at` | `string | null` |  |
| `freshness.served_at` | `string` |  |
| `freshness.cache_age_seconds` | `integer | null` |  |
| `freshness.served_from_cache` | `boolean` | True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are. |
| `freshness.freshness_requested` | `recent | realtime` |  |
| `freshness.freshness_served` | `recent | realtime | stale` |  |
| `usage.receipt_id` | `string | null` |  |
| `usage.credits_quoted` | `integer` |  |
| `usage.credits_charged` | `integer` |  |
| `usage.balance_remaining` | `integer | null` |  |
| `usage.free_tier_hint` | `string` | Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits). |

---

# Pricing - Veezee

Start free: your agent creates its own key in one call, no account or card, and gets 200 credits per IP per day (about 6,000 a month). Need more? Pay as you go at $2.00 per 1,000 credits ($20.00 minimum), or $99.00/mo with 80,000 credits included. Payment credits the key you already have, so nothing needs reconfiguring. Every tool's cost is fixed and shown on every response.

Only calls that return data spend credits: failed calls refund automatically, and unused purchased credits are refunded on request within 14 days. What agents pay elsewhere: the leading LinkedIn MCP vendor charges $1.50 per 1,000 results pay-as-you-go and $1,999/month on its volume plan; the official X API bills $0.005 per post read and $0.010 per user lookup on prepaid credits and requires an approved developer account (docs.x.com/x-api/getting-started/pricing, checked 2026-07-17), covering neither LinkedIn nor Reddit. Veezee starts at $0 with one prepaid meter across all three platforms. Named, dated sources: https://veezee.io/alternatives

## Packs

| Pack | Credits | Price | Notes |
| --- | --- | --- | --- |
| Free key | 200 credits/day | $0.00 | shared per IP; the agent mints the key free, no signup, no card, recent data only |
| Pay-as-you-go | per 1,000 credits | $2.00 | unit rate; $20.00 minimum purchase |
| Flex pack | 10,000 credits | $20.00 | prepaid, does not expire while the account is open |
| Production | 80,000 credits/mo | $99.00/mo | 5 concurrent, higher rate limits (120 req/min, search up to 30 results/call) |

## How to buy

Humans buy on https://veezee.io/pricing (each plan card checks out directly) or on https://veezee.io/upgrade; a new key is shown once on the confirmation page. Already have a key (agents mint one free at `POST /v1/keys/mint`)? Use the personalized upgrade_url that get_usage or a payment-fixable error returns: payment credits that same key, nothing to reconfigure. Payment runs through Stripe Checkout.

## Tool costs

| Tool | Credits | Notes |
| --- | --- | --- |
| linkedin_resolve_url | 2 |  |
| linkedin_get_profile | 4 | first 2 sections included; +2/section after, up to 4 total |
| linkedin_search_people | 10 | first 10 results included; +1/10 more, up to 30 (10 on trial) |
| linkedin_get_company | 4 |  |
| linkedin_get_posts | 4 |  |
| reddit_search | 6 |  |
| reddit_get_subreddit | 4 |  |
| reddit_get_subreddit_posts | 4 |  |
| reddit_get_user | 4 |  |
| reddit_get_post | 4 |  |
| reddit_resolve_url | 2 |  |
| x_search | 6 |  |
| x_get_profile | 4 |  |
| x_get_tweets | 4 |  |
| x_get_tweet | 4 |  |
| x_resolve_url | 2 |  |
| get_usage | 0 |  |

Realtime freshness (`freshness: "realtime"`) adds 2 credits to any tool that accepts it; refunded automatically if the live fetch falls back to cached data. Realtime needs a paid key: a free key always serves cached (`recent`) data.

## Free-key and trial-key limits

Free-key calls draw from the per-IP daily budget above (the Free plan). A `vz_trial_` key, issued through account recovery, carries its own caps: 500 credits, 1 concurrent call, 20 calls/minute, search capped at 10 results/call, 5 realtime fetches total. Claim any trial key with an email and confirm it by signing in at https://veezee.io/login: that adds a one-time 10,000-credit grant (once per email, once per key), spent under the same trial limits, after the free daily budget.

## Example costs

| Call | Credits | PAYG cost |
| --- | --- | --- |
| linkedin_resolve_url, one URL | 2 | $0.00 |
| linkedin_get_profile, up to 2 sections | 4 | $0.01 |
| linkedin_get_profile, all 4 sections | 8 | $0.02 |
| linkedin_search_people, limit=10 | 10 | $0.02 |
| linkedin_search_people, limit=30 | 12 | $0.02 |
| linkedin_get_company, one company | 4 | $0.01 |
| linkedin_get_posts, one page | 4 | $0.01 |
| realtime surcharge, any tool | 2 | $0.00 |

---

# Trust - Veezee

What Veezee stores, how it's protected, and how to leave.

## What we store

We keep request and response bodies to support idempotent replay: if you retry a call with the same `Idempotency-Key`, you get back the exact stored result instead of a second charge. Bodies are kept for up to 30 days and are size-capped. Ledger events (the record of what was charged and when) are kept indefinitely, since they're your billing record.

## Telemetry

Operational telemetry uses opaque, hashed identifiers, never raw account or request data. We don't put personal information in telemetry.

## Keys

API keys are shown to you exactly once, at creation. We store only a hash of the key, not the key itself.

## Authentication

REST and the CLI use API keys only, no OAuth. MCP clients that support the MCP authorization spec (Claude Code, claude.ai, ChatGPT developer-mode connectors, and others) connect via a real OAuth flow instead: an unauthenticated request gets a 401 with OAuth discovery, and a compliant client opens a Veezee sign-in with no key involved. Full reference: https://veezee.io/auth.md

## Billing and cancellation

Paid plans are self-serve through Stripe. To change or cancel: ask your agent for its manage link (the free get_usage tool returns `manage_url`), or paste your API key at https://veezee.io/manage. Either opens the Stripe billing portal for your account. Flex packs are one-time purchases; nothing recurs, so there is nothing to cancel.

## Contact

hello@veezee.io

---

# Agent readiness - Veezee

Agent readiness is the set of conventions that make a site legible to AI agents: stable URLs, markdown twins, structured data, robots controls, and machine-readable discovery files. This page walks the [Website Spec agent-readiness checklist](https://specification.website/spec/agent-readiness/) item by item and shows where veezee.io stands. Every Live row links to the artifact itself, on this domain, fetchable right now.

Current score: the one required item, 8 of 9 recommended items, and 6 of 10 optional items are live. The rows below say exactly what is not live and why.

## Required

| Item | Status | Proof |
| --- | --- | --- |
| [Stable URLs](https://specification.website/spec/agent-readiness/stable-urls/) | Live | URLs are public contracts. Renamed pages keep serving as redirects ([/twitter-api-for-ai-agents](/twitter-api-for-ai-agents)), and every published path is listed in [/sitemap.xml](/sitemap.xml). |

## Recommended

| Item | Status | Proof |
| --- | --- | --- |
| [Agent readiness overview](https://specification.website/spec/agent-readiness/agent-readiness-overview/) | Live | This page. |
| [/llms.txt](https://specification.website/spec/agent-readiness/llms-txt/) | Live | [/llms.txt](/llms.txt): a curated index of the whole corpus. |
| [Per-page Markdown](https://specification.website/spec/agent-readiness/markdown-source-endpoints/) | Live | Append index.md to any docs URL, or send `Accept: text/markdown`. Try [/docs/index.md](/docs/index.md). |
| [robots.txt for AI crawlers](https://specification.website/spec/agent-readiness/robots-for-ai-crawlers/) | Live | [/robots.txt](/robots.txt) names GPTBot, ClaudeBot, CCBot, Google-Extended, PerplexityBot, and more, each with an explicit allow. |
| [Structured data](https://specification.website/spec/agent-readiness/structured-data-for-agents/) | Live | JSON-LD (SoftwareApplication, Organization, Offer, BreadcrumbList) ships inline in every page. View source on [/](/) or [/pricing](/pricing). |
| [Machine-readable formats](https://specification.website/spec/agent-readiness/machine-readable-formats/) | Live | [/product.json](/product.json), [/recipes.json](/recipes.json), [/openapi.json](/openapi.json), [/proof-feed.json](/proof-feed.json). |
| [HTTP Link headers](https://specification.website/spec/agent-readiness/link-headers/) | Live | Every page response carries a Link header naming [/openapi.json](/openapi.json) as service-desc; the home page adds alternate links to [/llms.txt](/llms.txt) and [/index.md](/index.md). Check with `curl -sI https://veezee.io/`. |
| [Agent Skills discovery](https://specification.website/spec/agent-readiness/agent-skills-discovery/) | Live | [/.well-known/agent-skills/index.json](/.well-known/agent-skills/index.json), backed by the packs at [/docs/skills](/docs/skills). |
| [DNS-AID](https://specification.website/spec/agent-readiness/dns-aid/) | Live | `_index._agents.veezee.io` and `_mcp._agents.veezee.io` HTTPS records point agents at veezee.io and mcp.veezee.io. Check: `dig _index._agents.veezee.io TYPE65`. |

## Optional

| Item | Status | Proof |
| --- | --- | --- |
| [/llms-full.txt](https://specification.website/spec/agent-readiness/llms-full-txt/) | Live | [/llms-full.txt](/llms-full.txt): the whole docs corpus in one fetch. |
| [Content Signals](https://specification.website/spec/agent-readiness/content-signals/) | Live | `Content-Signal: search=yes, ai-input=yes, ai-train=yes` in [/robots.txt](/robots.txt). |
| [Web Bot Auth](https://specification.website/spec/agent-readiness/web-bot-auth/) | Not applicable | It defines how bot operators sign their requests. A content site has nothing to publish, and we serve signed and unsigned bots the same content. |
| [MCP and tool discovery](https://specification.website/spec/agent-readiness/mcp-and-tool-discovery/) | Live | [/.well-known/mcp.json](/.well-known/mcp.json) and [/.well-known/mcp-server-card.json](/.well-known/mcp-server-card.json), pointing at the live servers on mcp.veezee.io. |
| [A2A agent card](https://specification.website/spec/agent-readiness/a2a-agent-cards/) | Live | [/.well-known/agent-card.json](/.well-known/agent-card.json). Veezee does not run an A2A server; the card points A2A-aware crawlers at the MCP surface. |
| [Agentic Resource Discovery](https://specification.website/spec/agent-readiness/agentic-resource-discovery/) | Live | [/.well-known/ai-catalog.json](/.well-known/ai-catalog.json), advertised by the Agentmap line in [/robots.txt](/robots.txt). |
| [NLWeb](https://specification.website/spec/agent-readiness/nlweb/) | Not planned | MCP already gives agents a queryable interface with real auth and per-call pricing. An /ask endpoint would duplicate it. |
| [WebMCP](https://specification.website/spec/agent-readiness/webmcp/) | Live | The forms on [/upgrade](/upgrade) and [/manage](/manage) are declared as WebMCP tools (toolname and tooldescription attributes, plus imperative registration where fields are sensitive). Nothing auto-submits. |
| [OKF bundle](https://specification.website/spec/agent-readiness/okf-bundle/) | Not planned | The corpus already ships as Markdown: per-page index.md twins and [/llms-full.txt](/llms-full.txt). |
| [Schemamap](https://specification.website/spec/agent-readiness/schemamap/) | Not planned | It indexes per-resource .jsonld endpoints. Our JSON-LD ships inline in every page, so there are no .jsonld endpoints to index. |

## Why this page exists

Veezee sells LinkedIn, Reddit, and X data to AI agents, so the site is built agent-first: an agent should be able to discover, evaluate, connect, and pay with no human in the loop except the payment itself. The conventions above are how an agent finds its way in. If we are missing one you rely on, tell us: hello@veezee.io.

---

# Terms of service - Veezee

These terms cover use of veezee.io, api.veezee.io, and mcp.veezee.io ("Veezee"). Using the service means you accept them. Questions: [hello@veezee.io](mailto:hello@veezee.io).

## The service

Veezee provides read-only, structured data from public LinkedIn, Reddit, and X (formerly Twitter) pages, over REST, MCP, a TypeScript SDK, and a CLI. Every tool reads; nothing is ever posted, messaged, or changed on any platform on your behalf.

## Keys and accounts

API keys are created self-serve and shown once, at creation; Veezee stores only a hash. You are responsible for calls made with your keys. Attaching an email to a key adds recovery and management; the key works either way.

## Credits and payment

Credits are prepaid. Only calls that return data spend credits: failed or unfulfilled calls are refunded to the balance automatically, and a retried call with the same `Idempotency-Key` is never billed twice. When credits run out, calls stop; you can never owe more than you paid. Payments run through Stripe Checkout; card details never touch Veezee. Unused purchased credits are refunded on request within 14 days ([hello@veezee.io](mailto:hello@veezee.io)). The monthly plan renews through Stripe and can be cancelled anytime at [/manage](/manage).

## Fair use

The free budget is per IP per day so that anyone can evaluate the service without an account. Working around it (key farming, coordinated IP rotation) can get requests blocked. You are responsible for how you use retrieved data, including compliance with applicable law and the source platforms' terms. Don't use the service to harass or surveil individuals.

## Availability

The service is provided as-is, without an uptime guarantee. To the extent permitted by law, Veezee's total liability is limited to the amount you paid in the twelve months before the claim.

## Changes

We may update these terms; material changes are announced on the [changelog](/changelog).

---

# Privacy - Veezee

What Veezee stores, why, and what it never does. The longer operational version is on [/trust](/trust). Questions or deletion requests: [hello@veezee.io](mailto:hello@veezee.io).

## What we store

- **API traffic**: request and response bodies for up to 30 days, size-capped, so a retried call with the same `Idempotency-Key` returns the stored result instead of charging twice. Charge records (the ledger) are kept indefinitely: they are your billing history.
- **Keys**: only a hash. The key itself is shown once and never stored.
- **Email**: only if you sign in or claim a key. Used for sign-in codes, receipts, and the balance alerts you can turn off in the dashboard.
- **Free-tier metering**: per-IP daily counters that enforce the free budget.
- **Payments**: handled by Stripe. Card details never touch Veezee; we receive the order status and the checkout email.

## Analytics

The site uses PostHog (EU-hosted) for page analytics: no session recording, query strings stripped before sending, no advertising cookies. Signing in sets one session cookie, which is required for the dashboard to work. Operational telemetry uses opaque, hashed identifiers, never personal information. A first-party cookie named `vz_attr` remembers, for 30 days, which page and source first brought the browser here (campaign labels and referring site only, no identifier, no third parties); it exists so signups can be attributed to a source once, at signup.

## What we never do

We don't sell personal data, we don't put personal information in telemetry, and we don't show ads.

## Your choices

Revoke or rotate keys anytime in the [dashboard](/dashboard). To delete an account and its stored data, email [hello@veezee.io](mailto:hello@veezee.io). Unused purchased credits are refunded on request within 14 days.

---

# Changelog - Veezee

## 2026-07-21: Capability pages

24 capability pages, one per search task ("LinkedIn profile API", "Reddit comments API", "Tweet metrics API"), each with a copy-paste curl, the MCP call, parameters, and price, generated from the tool catalog and indexed at https://veezee.io/apis.

## 2026-07-17: Skills, integration guides, solution pages, status

Two new skill packs: `launch-sentiment-sweep` (one-shot Reddit and X reaction readout for a launch) and `outreach-list-builder` (ICP spec to ranked outreach list), making eight; SDK 0.7.0 ships all eight in the npm tarball. Integration guides at https://veezee.io/integrations for Claude Code, Codex CLI, Cursor, and Gemini CLI, each ending with a copy-paste verification prompt. Four solution pages: https://veezee.io/social-listening-api, https://veezee.io/lead-generation-api, https://veezee.io/brand-monitoring-api, https://veezee.io/competitive-intelligence-api. Live service checks at https://veezee.io/status.

## 2026-07-16: MCP OAuth connector sign-in

MCP clients that support the authorization spec now connect with zero keys: an unauthenticated request returns `401` with OAuth discovery, and the client opens a Veezee sign-in in the browser (one-time emailed code, no password, no card). Works with Claude Code, claude.ai, ChatGPT developer-mode connectors, and any compliant client; keyed connections work unchanged. Connected apps are listed and revocable in the dashboard.

## 2026-07-15: Free tier and a sign-in grant

Every data tool now answers under a free budget of 200 credits per IP per day: no account, no card. Signing in adds a one-time grant of 10,000 credits, once per email, spent after the daily budget.

## 2026-07-14: Accounts and key management

Sign in at https://veezee.io/login with a one-time emailed code (no password exists): dashboard, named keys, rotation and revocation, balance alerts, and self-serve lost-key recovery at https://veezee.io/recover. The CLI signs in with `vz login` (browser or `--device`). `vzm_` management tokens unlock the same surface over REST and MCP; spend keys stay data-only. The key spends; the identity governs.

## 2026-07-13: vz CLI alias, deeper comparisons

SDK 0.3.1: the CLI answers to `vz` as well as `veezee`, and the npm package now ships all six agent skill packs including `reddit-monitoring`. The comparison pages (https://veezee.io/alternatives) now assess data access head-on (search shape, freshness disclosure, docs you can read before paying, refund behavior), with sentiment gathered under the free tier using Veezee's own `reddit_search` and `x_search`. Three new landing pages: https://veezee.io/linkedin-api-for-ai-agents, https://veezee.io/reddit-api-for-ai-agents, https://veezee.io/x-api-for-ai-agents.

## 2026-07-13: Reddit and X

Reddit and X (formerly Twitter) join LinkedIn on the same contract: `reddit_search`, `reddit_get_subreddit`, `reddit_get_subreddit_posts`, `reddit_get_user`, `reddit_get_post`, `reddit_resolve_url`, `x_search`, `x_get_profile`, `x_get_tweets`, `x_get_tweet`, `x_resolve_url`, over the same MCP and REST pattern, priced per credit, free tier first. Per-platform docs: https://veezee.io/docs/linkedin, https://veezee.io/docs/reddit, https://veezee.io/docs/x.

## 2026-07-12: v1 launch

Veezee opens with LinkedIn: six tools (`linkedin_resolve_url`, `linkedin_get_profile`, `linkedin_search_people`, `linkedin_get_company`, `linkedin_get_posts`, `get_usage`) over MCP and REST (`GET /v1/linkedin/*`), priced per credit. No signup: your agent mints its own free key in one call, then calls run under a small shared per-IP daily budget (200 credits/day). Past that, buy a key at https://veezee.io/upgrade: pay, and checkout credits the same key.

---

# Social listening API - Veezee

Social listening means watching what people say about a brand, product, or topic across public discussion, not just tracking official accounts. Most teams want the raw posts and comments so their own pipeline or agent can score sentiment, cluster themes, or spot a spike; a vendor's canned sentiment label just gets in the way.

## How to do it with Veezee

Veezee gives an agent three tools for this. [reddit_search](https://veezee.io/docs/tools/reddit_search) with `type=comments` reaches comment-level mentions inside discussions, not just post titles. [x_search](https://veezee.io/docs/tools/x_search) sweeps X chronologically for a query, following the cursor for as many pages as the sweep needs. [reddit_get_subreddit_posts](https://veezee.io/docs/tools/reddit_get_subreddit_posts) reads one community's feed directly, useful once you know where the conversation happens (a product's own subreddit, a niche community). None of these return a sentiment score: every result carries the raw text, author, upvotes or likes, and timestamp, and your agent runs its own analysis on that.

No signup: your agent mints its own free key in one call, then uses it directly.

```sh
curl -s -X POST https://api.veezee.io/v1/keys/mint | jq -r .key
curl "https://api.veezee.io/v1/reddit/search?query=your-brand&type=comments" -H "Authorization: Bearer $VEEZEE_API_KEY"
```

## FAQ

**Does Veezee score sentiment for me?**

No. Every response carries the raw post or comment text plus upvotes, comment counts, and timestamps; your agent runs its own sentiment analysis on that text.

**Can I get notified the moment someone posts about my brand?**

Not automatically: there's no push mechanism. Poll reddit_search or x_search on your own schedule (`sort=new` for Reddit, `type=recent` for X) and diff against what you've already seen.

**How far back does the search go?**

reddit_search has no server-side time window on comment search, so filter results on `created_at` yourself; x_search takes `since:`/`until:` query operators for time windows directly.

**What's a realistic setup for checking this daily?**

A handful of narrow comment searches plus one subreddit poll and one X sweep, costed out step by step in the recipe below.

## Read next

- Worked recipe with real credit costs: [/use-cases/brand-monitoring](https://veezee.io/use-cases/brand-monitoring)
- Full docs: [/docs](https://veezee.io/docs)
- Credit prices and packs: [/pricing](https://veezee.io/pricing)
- Buy credits: [/upgrade](https://veezee.io/upgrade)

---

# Lead generation API - Veezee

Lead generation means turning a target list, a role, a company, an industry, into named people with enough context to reach out to. That means finding candidates who match, then pulling the profile detail (title, company, background) needed to personalize outreach, without a human clicking through LinkedIn by hand.

## How to do it with Veezee

[linkedin_search_people](https://veezee.io/docs/tools/linkedin_search_people) finds people by keywords, title, school, or current/past company; give it a role and a company and it returns names, positions, locations, and a urn for each match. [linkedin_get_profile](https://veezee.io/docs/tools/linkedin_get_profile) takes one of those results (or a known profile URL) and returns the full profile: headline, location, current position, follower counts, plus up to two extra sections (experience, education, skills, about) at no extra cost. [linkedin_get_company](https://veezee.io/docs/tools/linkedin_get_company) resolves a company by URL, slug, or website domain, and returns the numeric id linkedin_search_people needs to filter results down to that one company.

No signup: your agent mints its own free key in one call, then uses it directly.

```sh
curl -s -X POST https://api.veezee.io/v1/keys/mint | jq -r .key
curl "https://api.veezee.io/v1/linkedin/search?keywords=VP%20of%20Sales&current_company=acme.com" -H "Authorization: Bearer $VEEZEE_API_KEY"
```

## FAQ

**Can I get an email address or phone number?**

No. Veezee returns what LinkedIn's profile shows publicly (name, headline, position, history); it does not return contact details.

**Can I search by company name directly?**

For search, yes: linkedin_search_people's `current_company` filter resolves a plain company name for you. linkedin_get_company itself doesn't search by name; give it a URL, slug, or website domain instead.

**How many results does one search return?**

Up to 30 per call (10 on a trial key); a cursor page is a new, separately priced call, so one larger `limit` is cheaper than several small pages.

**Can Veezee message or connect with these people for me?**

No. Every LinkedIn tool is read-only: no posting, commenting, or messaging.

## Read next

- Worked recipe with real credit costs: [/use-cases/prospect-enrichment](https://veezee.io/use-cases/prospect-enrichment)
- Full docs: [/docs](https://veezee.io/docs)
- Credit prices and packs: [/pricing](https://veezee.io/pricing)
- Buy credits: [/upgrade](https://veezee.io/upgrade)

---

# Brand monitoring API - Veezee

Brand monitoring means tracking mentions of a brand, product, or executive across public discussion, and being able to drill into any one thread when something looks worth a closer look, not just counting mentions.

## How to do it with Veezee

[x_search](https://veezee.io/docs/tools/x_search) sweeps X for a brand's name or handle, chronologically or by engagement. [reddit_search](https://veezee.io/docs/tools/reddit_search) with `type=comments` finds mentions inside Reddit discussions, not just post titles. When one thread is worth reading in full, [reddit_get_post](https://veezee.io/docs/tools/reddit_get_post) fetches that post's full body and, with `detail=full`, the entire comment tree in context, so an agent can follow up on a specific complaint or compliment instead of guessing from a one-line summary.

No signup: your agent mints its own free key in one call, then uses it directly.

```sh
curl -s -X POST https://api.veezee.io/v1/keys/mint | jq -r .key
curl "https://api.veezee.io/v1/x/search?query=%22your-brand%22&type=recent" -H "Authorization: Bearer $VEEZEE_API_KEY"
```

## FAQ

**Can I set up an ongoing monitor that runs itself?**

Not automatically: run the searches on your own schedule, a daily cron job, an agent loop. There's no built-in recurring job.

**How do I read the full discussion under a Reddit post I found in search results?**

Take the post's `t3_` id from reddit_search or reddit_get_subreddit_posts and call reddit_get_post with `detail=full`; it returns the comment tree in depth order.

**Does this include a sentiment score per mention?**

No. Every result is the raw post or comment text plus its engagement numbers; scoring sentiment is up to your agent.

**Is there a cheaper way to check one specific community every day?**

reddit_get_subreddit_posts with `sort=new` reads that community's feed directly for a flat per-page price, cheaper than a broad keyword search once you already know where the conversation happens.

## Read next

- Worked recipe with real credit costs: [/use-cases/brand-monitoring](https://veezee.io/use-cases/brand-monitoring)
- Full docs: [/docs](https://veezee.io/docs)
- Credit prices and packs: [/pricing](https://veezee.io/pricing)
- Buy credits: [/upgrade](https://veezee.io/upgrade)

---

# Competitive intelligence API - Veezee

Competitive intelligence means tracking what a competitor's company page says about itself, what its people are posting, and what the public is saying about it elsewhere, pulled into one picture instead of five open tabs.

## How to do it with Veezee

[linkedin_get_company](https://veezee.io/docs/tools/linkedin_get_company) fetches a competitor's LinkedIn page: description, industry, employee count, headquarters, and the id needed for further LinkedIn calls. [linkedin_get_posts](https://veezee.io/docs/tools/linkedin_get_posts) reads that same company's (or one exec's) recent posts, the voice-of-company signal: what they're announcing, hiring for, or talking about. [reddit_search](https://veezee.io/docs/tools/reddit_search) and [x_search](https://veezee.io/docs/tools/x_search) then cover what's said about the competitor outside its own channels, on Reddit and X respectively.

No signup: your agent mints its own free key in one call, then uses it directly.

```sh
curl -s -X POST https://api.veezee.io/v1/keys/mint | jq -r .key
curl "https://api.veezee.io/v1/linkedin/posts?identifier=competitor.com" -H "Authorization: Bearer $VEEZEE_API_KEY"
```

## FAQ

**Can I search LinkedIn posts by keyword across the whole platform?**

No. linkedin_get_posts returns one company or person's recent posts; there's no keyword search across LinkedIn in v1.

**How do I avoid guessing the wrong company page?**

Pass the competitor's website domain (e.g. `acme.com`) instead of guessing a slug from the brand name. Veezee resolves and verifies the domain against the company it returns; a famous brand name can otherwise point at an unrelated page.

**Does this include job listings or funding data?**

No. linkedin_get_company returns the company's own profile fields (industry, headcount, HQ, specialities); it does not return job listings.

**What's a reasonable cadence for this?**

A weekly check on a handful of companies (a company fetch plus a recent-posts page each) is the recipe below; run it more often around a launch or news cycle.

## Read next

- Worked recipes with real credit costs: [/use-cases/market-research](https://veezee.io/use-cases/market-research) and [/use-cases/company-research](https://veezee.io/use-cases/company-research)
- Full docs: [/docs](https://veezee.io/docs)
- Credit prices and packs: [/pricing](https://veezee.io/pricing)
- Buy credits: [/upgrade](https://veezee.io/upgrade)

---

# LinkedIn profile API - Veezee

Give a profile URL, the slug after /in/, or a URN, and get the profile back as structured JSON: name, headline, location, current position, and follower counts, plus up to two sections from about, experience, education, and skills at no extra cost. Messy URLs (utm params, m. subdomains) are cleaned automatically.

The base call costs 4 credits; each section beyond two adds 2 credits (max 4 sections). Data is recent by default; paid keys can force a live fetch with `freshness=realtime` for 2 credits extra. If you only have a name, start with the [people search API](https://veezee.io/linkedin-people-search-api) and pass its result here.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/linkedin/profiles?identifier=williamhgates" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/linkedin` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `linkedin_get_profile`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "linkedin_get_profile",
    "arguments": {
      "identifier": "williamhgates"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `identifier` | yes | `string` | Profile URL, slug (after /in/), or urn:li:fsd_profile URN. |
| `sections` | no | `array` | Extra profile sections. First 2 are included in the base price. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `person` envelope. Full field list: https://veezee.io/docs/fields#person

## Pricing

`linkedin_get_profile` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/linkedin_get_profile). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Does it return email addresses or phone numbers?**

No. It returns what the public profile shows (identity, position, background); no contact details.

**Can I search by name with this?**

No: it fetches one known profile. [linkedin_search_people](https://veezee.io/docs/tools/linkedin_search_people) turns a name into profile identifiers first.

**Which sections should I request?**

The two you actually need: experience and education cover most enrichment jobs, and two sections ride free on the base call.

## Read next

- [linkedin_get_profile: the full reference](https://veezee.io/docs/tools/linkedin_get_profile)
- [Prospect enrichment recipe](https://veezee.io/use-cases/prospect-enrichment)
- [LinkedIn API for AI agents](https://veezee.io/linkedin-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Profile enrichment API - Veezee

Profile enrichment takes a record you already have, a signup, a CRM row, a lead, and fills in who the person is now: current role, company, and background from their LinkedIn profile. Veezee serves recent data, and paid keys can force a real-time read with `freshness=realtime`, so a recent job change shows up.

Pass the profile URL or slug and request up to two sections (experience, education, skills, about) free on the 4 credits base call. The worked enrichment loop with real credit arithmetic is at [/use-cases/prospect-enrichment](https://veezee.io/use-cases/prospect-enrichment).

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/linkedin/profiles?identifier=williamhgates&sections=experience%2Ceducation" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/linkedin` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `linkedin_get_profile`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "linkedin_get_profile",
    "arguments": {
      "identifier": "williamhgates",
      "sections": [
        "experience",
        "education"
      ]
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `identifier` | yes | `string` | Profile URL, slug (after /in/), or urn:li:fsd_profile URN. |
| `sections` | no | `array` | Extra profile sections. First 2 are included in the base price. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `person` envelope. Full field list: https://veezee.io/docs/fields#person

## Pricing

`linkedin_get_profile` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/linkedin_get_profile). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**What if I only have a name and employer?**

Search first: [linkedin_search_people](https://veezee.io/docs/tools/linkedin_search_people) takes keywords plus a current_company filter and returns matches with the identifiers this call accepts.

**How fresh is the data?**

Recent by default. Paid keys can pass `freshness=realtime` (2 credits extra) to force a live read.

**Can it enrich by email address?**

No. There is no email-to-person resolution; start from a URL, a slug, or a name search.

## Read next

- [linkedin_get_profile: the full reference](https://veezee.io/docs/tools/linkedin_get_profile)
- [Prospect enrichment recipe](https://veezee.io/use-cases/prospect-enrichment)
- [LinkedIn API for AI agents](https://veezee.io/linkedin-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# LinkedIn people search API - Veezee

Search people on LinkedIn by free-text keywords plus structured filters: first and last name, title, school, current or past company. Results come back structured, name, position, location, with the identifier that [linkedin_get_profile](https://veezee.io/docs/tools/linkedin_get_profile) needs for a full fetch.

One search costs 10 credits and returns up to 30 results on a paid key (10 on the free tier); one larger `limit` is cheaper than several cursor pages, since every page is a separately priced call.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/linkedin/search?keywords=CTO&current_company=anthropic" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/linkedin` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `linkedin_search_people`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "linkedin_search_people",
    "arguments": {
      "keywords": "CTO",
      "current_company": "anthropic"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `keywords` | no | `string` | Free-text query: a name, a title, or both. |
| `first_name` | no | `string` | First-name filter, exact match. |
| `last_name` | no | `string` | Last-name filter, exact match. |
| `title` | no | `string` | Current job title filter. |
| `school` | no | `string` | School or university name filter. |
| `current_company` | no | `string` | Company name, slug, numeric id, or urn:li:fsd_company URN. Names are fuzzy-matched by LinkedIn; ids and URNs filter exactly. |
| `past_company` | no | `string` | Same accepted forms as current_company; names are resolved to an id server-side. |
| `limit` | no | `integer` | How many results to return. |
| `cursor` | no | `string` | Cursor from a previous page. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `people_search` envelope. Full field list: https://veezee.io/docs/fields#people_search

## Pricing

`linkedin_search_people` costs 10 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/linkedin_search_people). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Can I filter by company?**

Yes: current_company and past_company accept a company name (fuzzy-matched by LinkedIn's own company search), a slug, a numeric id, or a URN.

**Why was my school-only search rejected?**

School and company filters alone return INVALID_INPUT: include keywords, or a name or title filter that keywords can derive from.

**Can every result be fetched as a full profile?**

Results marked is_anonymous=true can't be fetched with linkedin_get_profile; everything else can.

## Read next

- [linkedin_search_people: the full reference](https://veezee.io/docs/tools/linkedin_search_people)
- [Candidate sourcing recipe](https://veezee.io/use-cases/candidate-sourcing)
- [LinkedIn API for AI agents](https://veezee.io/linkedin-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Search LinkedIn by job title - Veezee

Answer "who is the Head of Growth at that company" without clicking through LinkedIn: pass a `title` filter, optionally scoped by `current_company`, and get matching people back with names, positions, and locations. Use `past_company` instead to reach former holders of a role.

This is [linkedin_search_people](https://veezee.io/docs/tools/linkedin_search_people) with its title filter: 10 credits per search, up to 30 results on a paid key.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/linkedin/search?title=Head+of+Growth&current_company=vercel" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/linkedin` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `linkedin_search_people`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "linkedin_search_people",
    "arguments": {
      "title": "Head of Growth",
      "current_company": "vercel"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `keywords` | no | `string` | Free-text query: a name, a title, or both. |
| `first_name` | no | `string` | First-name filter, exact match. |
| `last_name` | no | `string` | Last-name filter, exact match. |
| `title` | no | `string` | Current job title filter. |
| `school` | no | `string` | School or university name filter. |
| `current_company` | no | `string` | Company name, slug, numeric id, or urn:li:fsd_company URN. Names are fuzzy-matched by LinkedIn; ids and URNs filter exactly. |
| `past_company` | no | `string` | Same accepted forms as current_company; names are resolved to an id server-side. |
| `limit` | no | `integer` | How many results to return. |
| `cursor` | no | `string` | Cursor from a previous page. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `people_search` envelope. Full field list: https://veezee.io/docs/fields#people_search

## Pricing

`linkedin_search_people` costs 10 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/linkedin_search_people). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Do I need keywords too?**

No. When title is set, keywords derive from it automatically.

**Can I filter by location or seniority?**

There are no such filters; each result carries the person's location, so filter client-side.

**How do I go from a match to a full profile?**

Pass the match's identifier to [linkedin_get_profile](https://veezee.io/docs/tools/linkedin_get_profile) at 4 credits.

## Read next

- [linkedin_search_people: the full reference](https://veezee.io/docs/tools/linkedin_search_people)
- [Candidate sourcing recipe](https://veezee.io/use-cases/candidate-sourcing)
- [LinkedIn API for AI agents](https://veezee.io/linkedin-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# People search API - Veezee

When an agent holds a fragment, "Jane Doe, VP Data at Acme", a people search API turns it into concrete candidates: names, current positions, locations, and identifiers ready for a follow-up profile fetch. Veezee runs this against LinkedIn's public professional graph.

Combine free-text keywords with filters for name, title, school, and current or past employer; 10 credits per search. Matches then expand with the [profile API](https://veezee.io/linkedin-profile-api) (anonymous results excepted).

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/linkedin/search?keywords=CTO&current_company=anthropic" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/linkedin` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `linkedin_search_people`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "linkedin_search_people",
    "arguments": {
      "keywords": "CTO",
      "current_company": "anthropic"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `keywords` | no | `string` | Free-text query: a name, a title, or both. |
| `first_name` | no | `string` | First-name filter, exact match. |
| `last_name` | no | `string` | Last-name filter, exact match. |
| `title` | no | `string` | Current job title filter. |
| `school` | no | `string` | School or university name filter. |
| `current_company` | no | `string` | Company name, slug, numeric id, or urn:li:fsd_company URN. Names are fuzzy-matched by LinkedIn; ids and URNs filter exactly. |
| `past_company` | no | `string` | Same accepted forms as current_company; names are resolved to an id server-side. |
| `limit` | no | `integer` | How many results to return. |
| `cursor` | no | `string` | Cursor from a previous page. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `people_search` envelope. Full field list: https://veezee.io/docs/fields#people_search

## Pricing

`linkedin_search_people` costs 10 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/linkedin_search_people). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Can I look someone up by email address?**

No: search is by name, title, school, and company. There is no email-to-person resolution.

**What about people who aren't on LinkedIn?**

They won't appear; coverage is LinkedIn's public graph.

**How many results per call?**

Up to 30 on a paid key, 10 on the free tier; cursor pages are new, separately priced calls.

## Read next

- [linkedin_search_people: the full reference](https://veezee.io/docs/tools/linkedin_search_people)
- [LinkedIn API for AI agents](https://veezee.io/linkedin-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# LinkedIn company API - Veezee

Fetch one company's LinkedIn page as structured JSON: name, description, industry, employee count, headquarters, website, founding year, and specialities, plus the URN and numeric id that scope a people search to that company. The identifier is a company URL, the slug after /company/, or a website domain.

The base call costs 4 credits. A domain identifier quotes 8 credits, and the resolution surcharge is refunded at settlement for already-known domains.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/linkedin/companies?identifier=microsoft" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/linkedin` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `linkedin_get_company`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "linkedin_get_company",
    "arguments": {
      "identifier": "microsoft"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `identifier` | yes | `string` | Company URL, slug (after /company/), or website domain (e.g. 'microsoft.com'). Numeric ids/URNs are not fetchable; use them only in linkedin_search_people company filters. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `company` envelope. Full field list: https://veezee.io/docs/fields#company

## Pricing

`linkedin_get_company` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/linkedin_get_company). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Can I fetch by company name?**

Not directly: pass a URL, slug, or domain. A bare name resolves through linkedin_search_people's current_company filter instead.

**Does it include job listings or funding rounds?**

No: the company's own profile fields only.

**How do I find employees of the company?**

Feed the returned id or URN into [linkedin_search_people](https://veezee.io/docs/tools/linkedin_search_people) as a company filter.

## Read next

- [linkedin_get_company: the full reference](https://veezee.io/docs/tools/linkedin_get_company)
- [Company research recipe](https://veezee.io/use-cases/company-research)
- [LinkedIn API for AI agents](https://veezee.io/linkedin-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Company lookup by domain - Veezee

You have a domain, from an email address, a signup, a lead list, and need the company behind it. Pass the bare domain as the identifier and Veezee resolves it to the matching LinkedIn company page, verifying the match against the website that company itself lists, so a similar-sounding name can't send you to the wrong page.

A domain lookup quotes 8 credits (set `max_credits` accordingly); the resolution surcharge is refunded at settlement when the domain is already known, so repeat lookups settle at 4 credits.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/linkedin/companies?identifier=anthropic.com" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/linkedin` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `linkedin_get_company`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "linkedin_get_company",
    "arguments": {
      "identifier": "anthropic.com"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `identifier` | yes | `string` | Company URL, slug (after /company/), or website domain (e.g. 'microsoft.com'). Numeric ids/URNs are not fetchable; use them only in linkedin_search_people company filters. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `company` envelope. Full field list: https://veezee.io/docs/fields#company

## Pricing

`linkedin_get_company` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/linkedin_get_company). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**What comes back?**

The full company record: description, industry, employee count, headquarters, website, founding year, plus the id for people-search filters.

**Do slugs and URLs work too?**

Yes, at a flat 4 credits with no resolution surcharge.

**What's the typical pipeline?**

Signup domain in, company record out, then [linkedin_search_people](https://veezee.io/docs/tools/linkedin_search_people) scoped to that company for the people. Worked version: [/use-cases/company-research](https://veezee.io/use-cases/company-research).

## Read next

- [linkedin_get_company: the full reference](https://veezee.io/docs/tools/linkedin_get_company)
- [Company research recipe](https://veezee.io/use-cases/company-research)
- [LinkedIn API for AI agents](https://veezee.io/linkedin-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Company headcount API - Veezee

Employee count is the standard sizing signal: sales segmentation, market sizing, vendor due diligence. This call returns a company's employee count as listed on its LinkedIn page, alongside industry, headquarters, description, and founding year, so one call sizes and classifies the company at once.

Identify the company by URL, slug, or website domain; 4 credits base, with domains quoting 8 credits and the surcharge refunded for already-known domains.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/linkedin/companies?identifier=microsoft" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/linkedin` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `linkedin_get_company`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "linkedin_get_company",
    "arguments": {
      "identifier": "microsoft"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `identifier` | yes | `string` | Company URL, slug (after /company/), or website domain (e.g. 'microsoft.com'). Numeric ids/URNs are not fetchable; use them only in linkedin_search_people company filters. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `company` envelope. Full field list: https://veezee.io/docs/fields#company

## Pricing

`linkedin_get_company` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/linkedin_get_company). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Is there historical headcount?**

No time series: poll on your own schedule and store the counts to build growth curves.

**A per-department breakdown?**

No: the total employee count as LinkedIn lists it.

**How fresh is the count?**

Recent by default; paid keys can force a live read with `freshness=realtime` (2 credits extra).

## Read next

- [linkedin_get_company: the full reference](https://veezee.io/docs/tools/linkedin_get_company)
- [LinkedIn API for AI agents](https://veezee.io/linkedin-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# LinkedIn posts API - Veezee

Read the recent LinkedIn posts of one person or one company: what they're announcing, hiring for, and talking about, as structured JSON with a cursor for older pages. The identifier is a profile or company URL, a slug, or a company website domain; the entity type is detected automatically.

Each page costs 4 credits; a domain identifier quotes 8 credits with the surcharge refunded for known domains, exactly like the [company API](https://veezee.io/linkedin-company-api).

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/linkedin/posts?identifier=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fmicrosoft%2F" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/linkedin` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `linkedin_get_posts`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "linkedin_get_posts",
    "arguments": {
      "identifier": "https://www.linkedin.com/company/microsoft/"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `identifier` | yes | `string` | Person or company URL, slug, URN, or company website domain. |
| `cursor` | no | `string` | Cursor from a previous page for older posts. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `posts` envelope. Full field list: https://veezee.io/docs/fields#posts

## Pricing

`linkedin_get_posts` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/linkedin_get_posts). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Can I keyword-search across all LinkedIn posts?**

No: this reads one entity's recent posts. There is no cross-LinkedIn post search in v1.

**Can I fetch one specific post by URL?**

There is no single-post fetch. [linkedin_resolve_url](https://veezee.io/docs/tools/linkedin_resolve_url) identifies a post URL, and reading the author's recent posts usually surfaces it.

**How far back does it go?**

One page per call; keep following the cursor, each page a new 4 credits call.

## Read next

- [linkedin_get_posts: the full reference](https://veezee.io/docs/tools/linkedin_get_posts)
- [LinkedIn API for AI agents](https://veezee.io/linkedin-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# LinkedIn URL resolver - Veezee

Agents meet LinkedIn URLs in every shape: share links with utm params, m. subdomains, trailing junk. This endpoint classifies any LinkedIn URL as a person, company, or post and returns the stable id, the handle, and the canonical URL, so the right fetch tool gets the right identifier.

It costs 2 credits. Skip it when you already hold a clean slug, URN, or URL: the fetch tools accept those directly, so resolving first would waste the call.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/linkedin/resolve-url?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fwilliamhgates%3Futm_source%3Dshare" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/linkedin` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `linkedin_resolve_url`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "linkedin_resolve_url",
    "arguments": {
      "url": "https://www.linkedin.com/in/williamhgates?utm_source=share"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `url` | yes | `string` | A LinkedIn URL, e.g. https://www.linkedin.com/in/williamhgates or .../company/microsoft. |

Returns a `url_resolution` envelope. Full field list: https://veezee.io/docs/fields#url_resolution

## Pricing

`linkedin_resolve_url` costs 2 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/linkedin_resolve_url). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Which id do I use for a company?**

The returned handle for fetches; the URN or numeric id is a people-search filter input, not a fetch identifier.

**What happens with non-LinkedIn URLs?**

INVALID_INPUT, stating the URL isn't LinkedIn.

**What about post URLs?**

They resolve to the post's activity URN. There is no single-post fetch, so read the author's [posts feed](https://veezee.io/linkedin-posts-api) for content.

## Read next

- [linkedin_resolve_url: the full reference](https://veezee.io/docs/tools/linkedin_resolve_url)
- [LinkedIn API for AI agents](https://veezee.io/linkedin-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Reddit search API - Veezee

Search all of Reddit by keyword through one endpoint. `type` picks the target: posts (default), comments (what people actually say, see the [Reddit comments API](https://veezee.io/reddit-comments-api)), subreddits, or users. Posts sort by relevance, top, new, hot, or comment count, with a time range from past hour to all time.

Each page costs 6 credits. Result depth per query is capped upstream around a few hundred results, so decompose broad topics into several narrower queries rather than paging one giant one.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/reddit/search?query=best+crm+for+freelancers&type=posts" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/reddit` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `reddit_search`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "reddit_search",
    "arguments": {
      "query": "best crm for freelancers",
      "type": "posts"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `query` | yes | `string` | Free-text keywords, e.g. 'self hosted photo backup'. Not a URL; use reddit_resolve_url for URLs. |
| `type` | no | `string` | What to search. 'comments' finds mentions inside discussions; 'subreddits' finds communities. |
| `sort` | no | `string` | posts: any value; comments: relevance|top|new; invalid for subreddits and users. |
| `range` | no | `string` | Time window. posts only. |
| `cursor` | no | `string` | Cursor from a previous page. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `reddit_search` envelope. Full field list: https://veezee.io/docs/fields#reddit_search

## Pricing

`reddit_search` costs 6 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/reddit_search). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Does the time range work on comments?**

No: `range` applies to posts only (INVALID_INPUT elsewhere). Comments sort by relevance, top, or new; filter created_at client-side.

**How do I read a result's full discussion?**

Take the post's t3_ id to the [Reddit thread API](https://veezee.io/reddit-thread-api) with `detail=full` for the whole comment tree.

**How deep can I paginate?**

Follow the cursor; each page is a new 6 credits call, and depth per query caps upstream around a few hundred results.

## Read next

- [reddit_search: the full reference](https://veezee.io/docs/tools/reddit_search)
- [Brand monitoring recipe](https://veezee.io/use-cases/brand-monitoring)
- [Reddit API for AI agents](https://veezee.io/reddit-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Reddit comments API - Veezee

Post titles ask questions; comments hold the answers, the recommendations, the complaints. Comment-level search, `type=comments`, reaches inside discussions, and every result is the raw comment text with author, score, and timestamp, so your own model does the scoring instead of trusting a canned sentiment label.

Each search page costs 6 credits. When one comment is worth its context, [reddit_get_post](https://veezee.io/docs/tools/reddit_get_post) fetches it inside its thread, or the whole discussion tree with `detail=full`.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/reddit/search?query=notion+alternative&type=comments" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/reddit` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `reddit_search`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "reddit_search",
    "arguments": {
      "query": "notion alternative",
      "type": "comments"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `query` | yes | `string` | Free-text keywords, e.g. 'self hosted photo backup'. Not a URL; use reddit_resolve_url for URLs. |
| `type` | no | `string` | What to search. 'comments' finds mentions inside discussions; 'subreddits' finds communities. |
| `sort` | no | `string` | posts: any value; comments: relevance|top|new; invalid for subreddits and users. |
| `range` | no | `string` | Time window. posts only. |
| `cursor` | no | `string` | Cursor from a previous page. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `reddit_search` envelope. Full field list: https://veezee.io/docs/fields#reddit_search

## Pricing

`reddit_search` costs 6 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/reddit_search). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Is a sentiment score included?**

No, deliberately: raw text plus engagement numbers, scored by your own pipeline.

**Can I time-window a comment search?**

Server-side windows apply to post search only; sort comments by new and filter created_at client-side.

**How do I fetch one comment with its thread?**

Pass its t1_ id as comment_id to reddit_get_post (4 credits on top of the base call).

## Read next

- [reddit_search: the full reference](https://veezee.io/docs/tools/reddit_search)
- [Social listening API](https://veezee.io/social-listening-api)
- [Brand monitoring recipe](https://veezee.io/use-cases/brand-monitoring)
- [Reddit API for AI agents](https://veezee.io/reddit-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Subreddit API - Veezee

Fetch one subreddit's profile: title, description, subscriber and active-user counts, age, NSFW flag, and topics. Subscriber counts are the standard community-sizing signal for market research; `include_settings` adds the community rules and moderator list for 2 credits more, worth reading before posting or judging moderation culture.

The base call costs 4 credits. Name the subreddit without the r/ prefix ('selfhosted') or paste a full URL.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/reddit/subreddits?subreddit_name=selfhosted" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/reddit` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `reddit_get_subreddit`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "reddit_get_subreddit",
    "arguments": {
      "subreddit_name": "selfhosted"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `subreddit_name` | yes | `string` | Subreddit name without the r/ prefix, e.g. 'selfhosted'. Full URLs are accepted and cleaned. |
| `include_settings` | no | `boolean` | Also return rules and moderators for +2 credits. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `subreddit` envelope. Full field list: https://veezee.io/docs/fields#subreddit

## Pricing

`reddit_get_subreddit` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/reddit_get_subreddit). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Does it return posts?**

No: read the feed with the [subreddit posts API](https://veezee.io/subreddit-posts-api).

**How do I find subreddits I don't know by name?**

[Search by topic](https://veezee.io/find-subreddits-api) with reddit_search type=subreddits.

**What's in settings?**

The community's rules and its moderator list.

## Read next

- [reddit_get_subreddit: the full reference](https://veezee.io/docs/tools/reddit_get_subreddit)
- [Market research recipe](https://veezee.io/use-cases/market-research)
- [Reddit API for AI agents](https://veezee.io/reddit-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Subreddit posts API - Veezee

Read any subreddit's feed programmatically: one page of posts as structured JSON, in the community's own front-page order by default, or `sort=new` for monitoring loops that poll and diff. Reddit splices promoted posts into feeds; `include_promoted` controls whether they appear.

Each page costs 4 credits; a cursor page is a new call priced the same way.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/reddit/subreddit-posts?subreddit_name=webdev&sort=new" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/reddit` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `reddit_get_subreddit_posts`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "reddit_get_subreddit_posts",
    "arguments": {
      "subreddit_name": "webdev",
      "sort": "new"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `subreddit_name` | yes | `string` | Subreddit name without the r/ prefix, e.g. 'selfhosted'. |
| `sort` | no | `string` | Defaults to the subreddit's front-page order. |
| `range` | no | `string` | Required with sort=top or controversial, but currently not applied upstream on this feed (results are all-time). |
| `include_promoted` | no | `boolean` | Keep the promoted ads Reddit splices into the feed (marked is_promoted). Default drops them. |
| `cursor` | no | `string` | Cursor from a previous page for older posts. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `reddit_posts` envelope. Full field list: https://veezee.io/docs/fields#reddit_posts

## Pricing

`reddit_get_subreddit_posts` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/reddit_get_subreddit_posts). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Can I get top posts of the week?**

Known gap, stated honestly: on this feed sort=top currently returns all-time top regardless of `range`. For time-windowed queries use [reddit_search](https://veezee.io/docs/tools/reddit_search), whose range does work.

**Several subreddits in one call?**

One per call; loop client-side.

**How do I read comments on a post I found?**

Its t3_ id goes to the [Reddit thread API](https://veezee.io/reddit-thread-api).

## Read next

- [reddit_get_subreddit_posts: the full reference](https://veezee.io/docs/tools/reddit_get_subreddit_posts)
- [Brand monitoring recipe](https://veezee.io/use-cases/brand-monitoring)
- [Reddit API for AI agents](https://veezee.io/reddit-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Reddit user API - Veezee

Fetch one Reddit user's public profile: username, account age, karma, follower count, and description, the vetting call before quoting a loud voice or engaging one. Add up to two sections, comments, posts, subreddits, at 2 credits each: recent activity for the first two, active communities for the third.

The base call costs 4 credits. Name the user without the u/ prefix or paste the profile URL.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/reddit/users?username=spez" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/reddit` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `reddit_get_user`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "reddit_get_user",
    "arguments": {
      "username": "spez"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `username` | yes | `string` | Reddit username without the u/ prefix, e.g. 'spez'. Full profile URLs are accepted and cleaned. |
| `sections` | no | `array` | Extra activity sections, 2 credits each (max 2 per call). |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `reddit_user` envelope. Full field list: https://veezee.io/docs/fields#reddit_user

## Pricing

`reddit_get_user` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/reddit_get_user). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Can I find users by topic?**

Yes, with [reddit_search](https://veezee.io/docs/tools/reddit_search) type=users; this endpoint needs an exact username.

**What exactly do sections return?**

comments and posts return the first page of that user's recent activity; subreddits returns where they're active.

**Why vet a user at all?**

Account age and karma separate an established community voice from a throwaway before you cite or engage them.

## Read next

- [reddit_get_user: the full reference](https://veezee.io/docs/tools/reddit_get_user)
- [Reddit API for AI agents](https://veezee.io/reddit-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Reddit thread API - Veezee

When search surfaces a thread worth reading, this call fetches the post's full body and, with `detail=full`, the entire discussion tree: comments flattened in tree order with depth, about 200 per page, with a cursor to continue. It also batches: full text for up to 100 posts by their t3_ ids in one call.

Batch pricing starts at 4 credits for up to 10 ids; `detail=full` works with exactly one id and adds 4 credits.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/reddit/posts?post_ids=t3_1tbups6&detail=full" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/reddit` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `reddit_get_post`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "reddit_get_post",
    "arguments": {
      "post_ids": [
        "t3_1tbups6"
      ],
      "detail": "full"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `post_ids` | yes | `array` | 1 to 100 post ids with the t3_ prefix, e.g. ["t3_1tbups6"]. |
| `detail` | no | `string` | 'full' adds the discussion tree; only valid with exactly one id, +4 credits. |
| `comment_id` | no | `string` | A t1_ comment id to fetch in context; only valid with exactly one post id, +4 credits like detail 'full'. |
| `sort` | no | `string` | Discussion-tree order; only with detail 'full'. |
| `cursor` | no | `string` | comments_cursor from a previous detail='full' page. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `reddit_thread` envelope. Full field list: https://veezee.io/docs/fields#reddit_thread

## Pricing

`reddit_get_post` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/reddit_get_post). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Where do post ids come from?**

reddit_search, reddit_get_subreddit_posts, or the [URL resolver](https://veezee.io/reddit-url-resolver); they're the t3_ values.

**Can I fetch one specific comment?**

Pass its t1_ id as comment_id (4 credits extra) to get that comment in its post context.

**Does one call return the whole tree?**

About 200 comments per page in tree order; follow comments_cursor for the rest.

## Read next

- [reddit_get_post: the full reference](https://veezee.io/docs/tools/reddit_get_post)
- [Reddit API for AI agents](https://veezee.io/reddit-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Find subreddits by topic - Veezee

Audience research starts with "where does this niche hang out". [reddit_search](https://veezee.io/docs/tools/reddit_search) with `type=subreddits` turns a topic into matching communities, ready to size with the [subreddit API](https://veezee.io/subreddit-api)'s subscriber and active-user counts and to read with the [subreddit posts API](https://veezee.io/subreddit-posts-api).

Each search page costs 6 credits. Broad topics do better decomposed into several narrower queries: result depth per query caps upstream around a few hundred.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/reddit/search?query=self+hosting&type=subreddits" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/reddit` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `reddit_search`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "reddit_search",
    "arguments": {
      "query": "self hosting",
      "type": "subreddits"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `query` | yes | `string` | Free-text keywords, e.g. 'self hosted photo backup'. Not a URL; use reddit_resolve_url for URLs. |
| `type` | no | `string` | What to search. 'comments' finds mentions inside discussions; 'subreddits' finds communities. |
| `sort` | no | `string` | posts: any value; comments: relevance|top|new; invalid for subreddits and users. |
| `range` | no | `string` | Time window. posts only. |
| `cursor` | no | `string` | Cursor from a previous page. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `reddit_search` envelope. Full field list: https://veezee.io/docs/fields#reddit_search

## Pricing

`reddit_search` costs 6 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/reddit_search). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**How do I judge whether a community fits?**

Fetch its profile: subscriber and active-user counts size it, and `include_settings` adds the rules and moderator list before you post.

**Can I find users the same way?**

Yes: type=users finds accounts by topic.

**What comes after finding communities?**

A sort=new poll on each feed is the standard monitoring loop; worked costs at [/use-cases/brand-monitoring](https://veezee.io/use-cases/brand-monitoring).

## Read next

- [reddit_search: the full reference](https://veezee.io/docs/tools/reddit_search)
- [Market research recipe](https://veezee.io/use-cases/market-research)
- [Reddit API for AI agents](https://veezee.io/reddit-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Reddit URL resolver - Veezee

Classify any reddit.com or redd.it URL, share links, old.reddit.com, mobile forms, as a subreddit, user, post, or comment, and get the exact identifier the other Reddit endpoints need: t3_ ids for posts, t1_ for comments, names for subreddits and users. It parses offline without fetching the page.

It costs 2 credits. Skip it when you already hold an id or name: the other tools accept those directly.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/reddit/resolve-url?url=https%3A%2F%2Fredd.it%2F1tbups6" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/reddit` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `reddit_resolve_url`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "reddit_resolve_url",
    "arguments": {
      "url": "https://redd.it/1tbups6"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `url` | yes | `string` | A Reddit URL, e.g. https://www.reddit.com/r/selfhosted/comments/1tbups6/... or https://redd.it/1tbups6. |

Returns a `url_resolution` envelope. Full field list: https://veezee.io/docs/fields#url_resolution

## Pricing

`reddit_resolve_url` costs 2 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/reddit_resolve_url). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**What do I do with each result type?**

post goes to the [Reddit thread API](https://veezee.io/reddit-thread-api); comment to the same call's comment_id; subreddit and user to their fetch endpoints.

**What happens with non-Reddit URLs?**

INVALID_INPUT, stating the URL isn't Reddit.

**Does it hit Reddit at all?**

No: the parse is offline, which is why it's the cheapest Reddit call.

## Read next

- [reddit_resolve_url: the full reference](https://veezee.io/docs/tools/reddit_resolve_url)
- [Reddit API for AI agents](https://veezee.io/reddit-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Twitter search API - Veezee

Search X (formerly Twitter) by keyword. `type` picks the mode: recent (default) sweeps chronologically and keeps paginating as far as you follow the cursor, popular ranks by engagement, people finds accounts. Advanced operators pass through verbatim: `from:nasa`, `min_faves:100`, quoted phrases, and `since:`/`until:` for time windows.

Each page costs 6 credits, so a deep sweep costs linearly in pages. Results are tweet summaries with engagement counts, ready for [tweet-level metrics](https://veezee.io/tweet-metrics-api) or [profile](https://veezee.io/twitter-profile-api) follow-ups.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/x/search?query=veezee+api" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/x` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `x_search`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "x_search",
    "arguments": {
      "query": "veezee api"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `query` | yes | `string` | Free-text keywords; X advanced operators work, e.g. 'claude code from:AnthropicAI since:2026-06-01'. |
| `type` | no | `string` | recent = chronological deep sweep; popular = top engagement; people = account search (single page). |
| `cursor` | no | `string` | Cursor from a previous page. Not valid with type 'people'. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `x_search` envelope. Full field list: https://veezee.io/docs/fields#x_search

## Pricing

`x_search` costs 6 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/x_search). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Is there a date-range parameter?**

No separate parameter: put `since:`/`until:` operators in the query itself.

**How do I search within one account?**

Add `from:handle` to the query.

**How deep does recent go?**

As far as you keep following the cursor; each page is a new 6 credits call.

## Read next

- [x_search: the full reference](https://veezee.io/docs/tools/x_search)
- [Brand monitoring API](https://veezee.io/brand-monitoring-api)
- [X (formerly Twitter) API for AI agents](https://veezee.io/x-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Twitter profile API - Veezee

Fetch one X (formerly Twitter) account's profile: name, bio, location, website, follower and following counts, tweet and media counts, verification state, and join date. The identifier is a screen name without the @, a full x.com or twitter.com URL, or the numeric account id.

It costs 4 credits. The returned platform_fields.id is stable across handle changes: store it for repeat lookups.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/x/profiles?identifier=nasa" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/x` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `x_get_profile`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "x_get_profile",
    "arguments": {
      "identifier": "nasa"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `identifier` | yes | `string` | Screen name without the @ (e.g. 'nasa'), profile URL, or numeric account id. |
| `by` | no | `string` | Force how identifier is interpreted; auto-detected when omitted. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `x_profile` envelope. Full field list: https://veezee.io/docs/fields#x_profile

## Pricing

`x_get_profile` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/x_get_profile). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Can I get the follower list?**

No: counts only, no follower enumeration.

**What about an account whose handle is all digits?**

Numeric strings are treated as ids; force handle interpretation with `by=screen_name`.

**How do I read what the account posts?**

The [user tweets API](https://veezee.io/user-tweets-api) fetches the timeline.

## Read next

- [x_get_profile: the full reference](https://veezee.io/docs/tools/x_get_profile)
- [X (formerly Twitter) API for AI agents](https://veezee.io/x-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# User tweets API - Veezee

Fetch one page of an X account's timeline: the voice check before outreach, the raw feed for a monitoring loop. `mode` picks the view: posts (default), posts_and_replies, or highlights; `include_retweets=false` filters retweets out. Each tweet comes back as a summary with engagement counts, plus a cursor for older pages.

Each page costs 4 credits; a cursor page is a new call priced the same way.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/x/tweets?identifier=nasa" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/x` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `x_get_tweets`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "x_get_tweets",
    "arguments": {
      "identifier": "nasa"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `identifier` | yes | `string` | Screen name without the @, profile URL, or numeric account id. |
| `mode` | no | `string` | Which timeline view to read. |
| `include_retweets` | no | `boolean` | Set false to drop retweets from the page. |
| `cursor` | no | `string` | Cursor from a previous page for older tweets. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `x_tweets` envelope. Full field list: https://veezee.io/docs/fields#x_tweets

## Pricing

`x_get_tweets` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/x_get_tweets). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Just the account's original tweets?**

mode=posts with include_retweets=false.

**Can I search within the timeline?**

Use [x_search](https://veezee.io/docs/tools/x_search) with a `from:` operator instead; this call reads pages in order.

**Full metrics for one tweet I found?**

Its id goes to the [tweet metrics API](https://veezee.io/tweet-metrics-api).

## Read next

- [x_get_tweets: the full reference](https://veezee.io/docs/tools/x_get_tweets)
- [X (formerly Twitter) API for AI agents](https://veezee.io/x-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Tweet lookup API - Veezee

Fetch a single tweet by id or URL: the text, full engagement metrics (views, likes, retweets, quotes, replies, bookmarks), language, and the quoted tweet inline when there is one. The id is the digits after /status/ in any tweet URL.

It costs 4 credits. The typical use is verification: confirm a tweet exists and check its engagement before citing it, or follow a quote chain hop by hop.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/x/tweet?tweet_id=2054497961162478079" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/x` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `x_get_tweet`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "x_get_tweet",
    "arguments": {
      "tweet_id": "2054497961162478079"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `tweet_id` | yes | `string` | Numeric tweet id, e.g. '2054497961162478079', or a full tweet URL. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `x_tweet` envelope. Full field list: https://veezee.io/docs/fields#x_tweet

## Pricing

`x_get_tweet` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/x_get_tweet). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Does it return the replies underneath?**

No: one tweet per call. Search the conversation with [x_search](https://veezee.io/docs/tools/x_search) or read the author's timeline.

**Can I pass a full URL?**

Yes, tweet URLs are accepted; the [URL resolver](https://veezee.io/x-url-resolver) handles messier forms offline.

**Batch lookups?**

One tweet per call; loop client-side.

## Read next

- [x_get_tweet: the full reference](https://veezee.io/docs/tools/x_get_tweet)
- [X (formerly Twitter) API for AI agents](https://veezee.io/x-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Tweet metrics API - Veezee

Get a tweet's complete engagement picture in one call: views, likes, retweets, quotes, replies, and bookmarks, the numbers reporting, creator vetting, and citation checks need. When the tweet quotes another, the quoted tweet arrives inline.

Each tweet costs 4 credits. For an account-level view, follower counts and tweet totals, use the [profile API](https://veezee.io/twitter-profile-api) instead.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/x/tweet?tweet_id=2054497961162478079" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/x` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `x_get_tweet`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "x_get_tweet",
    "arguments": {
      "tweet_id": "2054497961162478079"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `tweet_id` | yes | `string` | Numeric tweet id, e.g. '2054497961162478079', or a full tweet URL. |
| `freshness` | no | `string` | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. |
| `max_credits` | no | `integer` | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |

Returns a `x_tweet` envelope. Full field list: https://veezee.io/docs/fields#x_tweet

## Pricing

`x_get_tweet` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/x_get_tweet). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Can I get metrics over time?**

The call returns the numbers as of now; poll on a schedule and store snapshots to build a curve.

**Metrics for every tweet in a timeline?**

[User tweets](https://veezee.io/user-tweets-api) pages carry summary engagement counts; fetch individual tweets when you need the full set including views and bookmarks.

**Which metrics are included?**

Views, likes, retweets, quotes, replies, bookmarks, and language, per tweet.

## Read next

- [x_get_tweet: the full reference](https://veezee.io/docs/tools/x_get_tweet)
- [X (formerly Twitter) API for AI agents](https://veezee.io/x-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# X URL resolver - Veezee

Classify any x.com or twitter.com URL, mobile links, query params, /i/web/status forms, as a profile or a tweet, and get the handle or numeric id the other X endpoints need. It parses offline without fetching the page.

It costs 2 credits. Skip it when you already hold a handle or tweet id: the fetch tools accept those directly.

## Try it now

No account, no card: mint a free key in one call, then call the endpoint.

```
curl -s -X POST https://api.veezee.io/v1/keys/mint
```

```
curl "https://api.veezee.io/v1/x/resolve-url?url=https%3A%2F%2Fx.com%2Fnasa%2Fstatus%2F2054497961162478079" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Over MCP

Point an MCP client at `https://mcp.veezee.io/x` (streamable-http; `https://mcp.veezee.io/all` serves every platform over one connection) and call `x_resolve_url`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "x_resolve_url",
    "arguments": {
      "url": "https://x.com/nasa/status/2054497961162478079"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `url` | yes | `string` | An X URL, e.g. https://x.com/nasa/status/2054497961162478079 or https://twitter.com/nasa. |

Returns a `url_resolution` envelope. Full field list: https://veezee.io/docs/fields#url_resolution

## Pricing

`x_resolve_url` costs 2 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/x_resolve_url). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

## FAQ

**Can it expand t.co short links?**

No: t.co can't be expanded offline, and the call returns INVALID_INPUT saying so. Expand the link in your own fetch step first.

**Do old twitter.com URLs work?**

Yes, both domains and their mobile forms.

**What next per result type?**

tweet goes to the [tweet lookup API](https://veezee.io/tweet-lookup-api); profile to the [profile API](https://veezee.io/twitter-profile-api) or [timeline](https://veezee.io/user-tweets-api).

## Read next

- [x_resolve_url: the full reference](https://veezee.io/docs/tools/x_resolve_url)
- [X (formerly Twitter) API for AI agents](https://veezee.io/x-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)

---

# Social data APIs by capability - Veezee

Every Veezee capability as its own page: what it does, a copy-paste curl, the MCP call, parameters, and price. All of them run on one key and one credit meter, and the free budget (200 credits per IP per day, no account) covers trying any of them.

## LinkedIn

- [LinkedIn profile API](https://veezee.io/linkedin-profile-api): Fetch a LinkedIn profile as structured JSON by URL, slug, or URN: name, headline, current position, experience, education. Free key, no signup.
- [Profile enrichment API](https://veezee.io/profile-enrichment-api): Enrich a person record with LinkedIn data: current role, company, experience, education. One call per profile, free key, no signup.
- [LinkedIn people search API](https://veezee.io/linkedin-people-search-api): Search LinkedIn people by keywords, title, school, or company over API and get structured results ready for profile fetches. Free key, no signup.
- [Search LinkedIn by job title](https://veezee.io/search-linkedin-by-job-title): Find LinkedIn profiles by job title over API, optionally scoped to a company: 'Head of Growth at that startup' as one structured call.
- [People search API](https://veezee.io/people-search-api): A people search API for agents: turn a name, role, or employer into concrete people with positions, locations, and fetchable identifiers.
- [LinkedIn company API](https://veezee.io/linkedin-company-api): Fetch a LinkedIn company page as JSON: description, industry, employee count, HQ, website, founding year. By URL, slug, or website domain.
- [Company lookup by domain](https://veezee.io/company-lookup-by-domain): Turn a website domain into the company behind it: pass acme.com, get the verified LinkedIn company record as structured JSON.
- [Company headcount API](https://veezee.io/company-headcount-api): Get a company's employee count from its LinkedIn page by URL, slug, or domain, with industry, HQ, and description in the same call.
- [LinkedIn posts API](https://veezee.io/linkedin-posts-api): Fetch the recent LinkedIn posts of any person or company as JSON, by URL, slug, or domain: what they announce, hire for, talk about.
- [LinkedIn URL resolver](https://veezee.io/linkedin-url-resolver): Classify any LinkedIn URL over API: profile, company, or post, with the stable id, handle, and canonical URL for follow-up fetches.

## Reddit

- [Reddit search API](https://veezee.io/reddit-search-api): Search all of Reddit by keyword over API: posts, comments, subreddits, or users as structured JSON, sorted and time-windowed. Free key, no signup.
- [Reddit comments API](https://veezee.io/reddit-comments-api): Search Reddit comments by keyword over API: what people actually say about a product, brand, or problem, as raw structured JSON.
- [Subreddit API](https://veezee.io/subreddit-api): Fetch subreddit details over API: subscribers, active users, description, age, rules, and moderators as structured JSON.
- [Subreddit posts API](https://veezee.io/subreddit-posts-api): Read any subreddit's feed over API: one page of posts, front-page or newest-first, as structured JSON. The community monitoring primitive.
- [Reddit user API](https://veezee.io/reddit-user-api): Fetch a Reddit user's public profile over API: karma, account age, followers, plus recent posts, comments, and active subreddits.
- [Reddit thread API](https://veezee.io/reddit-thread-api): Fetch a Reddit post with its full discussion tree over API: body text plus comments in tree order with depth, and a cursor to continue.
- [Find subreddits by topic](https://veezee.io/find-subreddits-api): Discover subreddits by keyword over API, then size each community with subscriber and active-user counts. Free key, no signup.
- [Reddit URL resolver](https://veezee.io/reddit-url-resolver): Classify any Reddit URL offline: subreddit, user, post, or comment, with the exact id the other Reddit endpoints need.

## X (formerly Twitter)

- [Twitter search API](https://veezee.io/twitter-search-api): Search X (formerly Twitter) by keyword over API: chronological sweeps, top posts, or people, with advanced operators. Free key, no signup.
- [Twitter profile API](https://veezee.io/twitter-profile-api): Fetch an X (Twitter) profile over API: bio, follower and tweet counts, verification, join date. By handle, URL, or numeric id.
- [User tweets API](https://veezee.io/user-tweets-api): Fetch any X (Twitter) account's timeline over API: own posts, replies, or highlights, with engagement counts and a cursor for older pages.
- [Tweet lookup API](https://veezee.io/tweet-lookup-api): Fetch a single tweet by id or URL over API, with full engagement metrics and the quoted tweet inline. Free key, no signup.
- [Tweet metrics API](https://veezee.io/tweet-metrics-api): Get a tweet's full engagement metrics over API: views, likes, retweets, quotes, replies, bookmarks. One call per tweet.
- [X URL resolver](https://veezee.io/x-url-resolver): Classify any X or Twitter URL offline: profile or tweet, with the handle or numeric id the other X endpoints need.

## By task

- [Social listening API](https://veezee.io/social-listening-api)
- [Lead generation API](https://veezee.io/lead-generation-api)
- [Brand monitoring API](https://veezee.io/brand-monitoring-api)
- [Competitive intelligence API](https://veezee.io/competitive-intelligence-api)

## By platform

- [LinkedIn API for AI agents](https://veezee.io/linkedin-api-for-ai-agents)
- [Reddit API for AI agents](https://veezee.io/reddit-api-for-ai-agents)
- [X API for AI agents](https://veezee.io/x-api-for-ai-agents)

---

# SDK - Veezee docs

Typed TypeScript client for the Veezee REST API: LinkedIn, Reddit, and X (formerly Twitter) data behind one client. Zero runtime dependencies, built on Node 20's global `fetch`. Package home: [@veezee/sdk on npm](https://www.npmjs.com/package/@veezee/sdk); source: [veezeehq/veezee-sdk on GitHub](https://github.com/veezeehq/veezee-sdk).

## Install

```
npm install @veezee/sdk
```

Node 20+ required. The package also ships the [`veezee` CLI](/docs/cli) (short alias: `vz`) and the [agent skill packs](/docs/skills).

## Quickstart

```ts
import { VeezeeClient } from "@veezee/sdk";

const client = new VeezeeClient(); // finds your key: constructor option, VEEZEE_API_KEY, or ~/.veezee/config
const profile = await client.linkedin.getProfile({ identifier: "williamhgates" });
const chatter = await client.reddit.search({ query: "notion alternative", type: "comments" });
const tweets = await client.x.getTweets({ identifier: "nasa" });
```

No key yet? `await client.mint()` creates a free one and saves it to `~/.veezee/config` (same store `npx @veezee/sdk init` writes). The free key includes 200 credits per IP per day. Need more? `client.checkout({ pack: "flex" })` (or [/upgrade](/upgrade) in a browser) adds credits to the same key, so nothing needs reconfiguring. Already have a key? `new VeezeeClient({ apiKey: process.env.VEEZEE_API_KEY })`.

## The methods

One method per tool, same names and envelopes as the REST contract (https://veezee.io/openapi.json). Every data response carries `usage` with the receipt id, credits charged, and balance.

LinkedIn, under `client.linkedin` ([platform docs](/docs/linkedin)):

- `getProfile`: a person's profile with named sections (about, experience, education, skills)
- `searchPeople`: people search with typed filters (title, current or past company, school, keywords)
- `getCompany`: a company page by URL, slug, or website domain
- `getPosts`: recent posts by a person or company

Reddit, under `client.reddit` ([platform docs](/docs/reddit)):

- `search`: search posts, comments, subreddits, or users
- `getSubreddit`: subreddit details, optionally including settings
- `getSubredditPosts`: one page of a subreddit's posts, by sort
- `getUser`: a Reddit user, with optional comments, posts, and subreddits sections
- `getPost`: posts by id, optionally with the full discussion thread
- `resolveUrl`: identify a Reddit URL

X, under `client.x` ([platform docs](/docs/x)):

- `search`: search recent or popular tweets, or people
- `getProfile`: a profile with follower and tweet counts
- `getTweets`: an account's tweets by mode (posts, posts and replies, highlights)
- `getTweet`: one tweet with full engagement metrics
- `resolveUrl`: identify an X URL

Top-level on the client:

- `resolveUrl`: identify a LinkedIn URL (person, company, or post)
- `getUsage`: credits, plan, and recent charges; free, requires a key
- `checkout`: buy a key or add credits

## Retries and idempotency

The client retries RATE_LIMITED, CONCURRENCY_LIMIT, UPSTREAM_UNAVAILABLE, INTERNAL, and network failures up to 3 attempts with backoff, honoring retry_after_seconds. Each metered call gets one Idempotency-Key reused across its own retries, so retries never double-charge. Terminal errors throw `VeezeeError` with the same code/message/param shape the API returns, including `offer` and `credits_required` on payment-fixable errors.

---

# CLI - Veezee docs

The `veezee` CLI ships inside [@veezee/sdk](https://www.npmjs.com/package/@veezee/sdk): the same tools as REST and MCP, as `vz <platform> <verb>` subcommands across LinkedIn, Reddit, and X, with JSON output via `--json`. `vz` is the same binary, three keystrokes shorter. `vz init` creates a free key in one call (no account needed) and saves it to `~/.veezee/config`; every command then runs under the free budget of 200 credits per IP per day on all three platforms. Need more? Buy credits at [/upgrade](/upgrade): checkout credits the same key.

## Install

```
npm install -g @veezee/sdk
```

## Commands

```
vz init                               mint a free key (no signup) and save it to ~/.veezee/config
vz linkedin profile get <identifier>  fetch a person's LinkedIn profile
vz linkedin search [flags]            search people on LinkedIn
vz linkedin company get <identifier>  fetch a company's LinkedIn page
vz linkedin posts get <identifier>    fetch recent posts by a person or company
vz reddit search <query> [flags]      search Reddit posts, comments, subreddits, or users
vz reddit subreddit <name> [flags]    fetch subreddit details
vz reddit subreddit-posts <name>      fetch a subreddit's posts
vz reddit user <username> [flags]     fetch a Reddit user
vz reddit post <ids> [flags]          fetch Reddit posts by id, with optional discussion thread
vz reddit resolve-url <url>           identify a Reddit URL
vz x search <query> [flags]           search X (formerly Twitter)
vz x profile <identifier> [flags]     fetch an X profile
vz x tweets <identifier> [flags]      fetch an account's tweets
vz x tweet <tweet_id>                 fetch one tweet with full metrics
vz x resolve-url <url>                identify an X URL
vz resolve-url <url>                  identify a LinkedIn URL (person/company/post)
vz usage                              check credits, plan, and recent charges (requires a key)
```

## Examples

```
vz linkedin profile get williamhgates --sections experience,education
vz linkedin search --keywords "CTO" --company anthropic --limit 20
vz linkedin company get microsoft --json
vz reddit search "notion alternative" --type comments
vz reddit subreddit selfhosted --include-settings
vz reddit post t3_1tbups6,t3_1tbuneg
vz x search "claude code"
vz x profile nasa
vz x tweets nasa --mode posts_and_replies --no-retweets
vz usage --key vz_live_... --json
```

## Flags

`--json` prints the raw response envelope. `--key <apiKey>` sets the API key (else reads `VEEZEE_API_KEY`, or the key `vz init` saved to `~/.veezee/config`; omit entirely to run under the free per-IP budget). `--base-url <url>` overrides the API base URL.

Per command: `linkedin profile get` takes `--sections a,b` and `--realtime`; `linkedin search` takes `--keywords`, `--title`, `--company`, `--past-company`, `--school`, `--first-name`, `--last-name`, `--limit`, `--cursor`, `--freshness`; `reddit search` takes `--type posts|comments|subreddits|users`, `--sort`, `--range`, `--cursor`; `reddit post` takes `--detail concise|full`, `--comment-id`; `x search` takes `--type recent|popular|people`; `x tweets` takes `--mode posts|posts_and_replies|highlights` and `--no-retweets`.

Every data command takes `--max-credits <n>` (per-call spend cap; an over-quote call fails with nothing charged).

Unknown flags are a hard usage error (exit 2), never silently ignored. `--json` applies to errors too: the machine-readable error shape prints to stdout. Run `vz --help` for the full list.

Exit codes: 0 success, 1 failure, 2 usage error (bad command, unknown flag, or INVALID_INPUT from the API), 4 auth required (no key, or UNAUTHORIZED/NOT_ENTITLED from the API).

---

# Source candidates from LinkedIn - Veezee

You name the role and the company; your agent searches LinkedIn and pulls full profiles for the top matches. The recipe below runs in Claude, n8n, or your own code on Veezee's LinkedIn tools.

## Recipe

1. No signup: mint a free key (`POST /v1/keys/mint`, no body) and call every step below under a shared budget of 200 credits per IP per day. Hit the cap, or need `limit: 30`? Buy a key at [/upgrade](/upgrade); checkout credits the same key.
2. `linkedin_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. `linkedin_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. `linkedin_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`; `linkedin_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

- Free-key calls and trial keys cap search at 10 results per call; the `limit: 30` step needs a paid key.
- A `current_company` name is matched by LinkedIn natively and works at any limit; a past_company name or company URL caps the limit, so pass the numeric id (from linkedin_get_company) for those at `limit: 30`.
- 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.
- With a paid key, call `get_usage` (free, exempt from the rate limit) before a large batch to check balance; a free key has no account balance to check, but each response reports its own cost.

## Run it

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

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

---

# 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.

---

# 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.

---

# Brand monitoring on Reddit and X - Veezee

You give it a brand name; your agent searches Reddit comments and posts for mentions, watches the brand's subreddit, and sweeps X, once or on a daily schedule. The recipe below runs in Claude, n8n, or your own code on Veezee's search tools.

## Recipe

1. No signup: mint a free key (`POST /v1/keys/mint`, no body) and call every step below under a shared budget of 200 credits per IP per day. Running this daily needs more than that; buy a key at [/upgrade](/upgrade) first, checkout credits the same key.
2. `reddit_search` with `type: "comments"`: run a few narrow queries for the brand name and its common nicknames or misspellings. There is no server-side time window on comment search, so filter results on `created_at` yourself. Cost: 6 credits per query page.
3. `reddit_get_subreddit_posts` with `sort: "new"`: poll the brand's home community (or its category subreddit) for new posts. Cost: 4 credits per page.
4. `x_search` with `type: "recent"`: sweep X for the same brand terms, the deep chronological mode. Cost: 6 credits per page.
5. `get_usage`: free, exempt from the rate limit, once you have a key. Check balance before a scheduled run.

## Total cost

A daily sweep of 3 comment searches, 1 subreddit poll, and 1 X sweep: 28 credits/day.

## Limits worth knowing

- Comment search has no time-window parameter; filter on `created_at` client-side and re-poll with `sort: "new"` for fresh mentions.
- Reddit's discover depth caps around a few hundred results per query; several narrow queries beat one broad one.
- Cached search results refresh on a 20-minute cycle: polling faster than that replays the same page.
- X search paginates as far as you follow the cursor, so a deep sweep costs linearly in pages; budget for that before running one.

## Run it

Platform docs: [/docs/reddit](/docs/reddit) and [/docs/x](/docs/x). Full reference: [/docs](/docs).

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

---

# Market research - Veezee

Market research finds the communities and accounts already talking about a space, sizes them, and profiles whoever is loudest.

## Recipe

1. No signup: mint a free key (`POST /v1/keys/mint`, no body) and call every step below under a shared budget of 200 credits per IP per day. Buy a key at [/upgrade](/upgrade) once you need more; checkout credits the same key.
2. `reddit_search` with `type: "subreddits"`: find communities discussing the topic. Cost: 6 credits per page.
3. `reddit_get_subreddit`: size each candidate community by subscriber and active-user counts, the standard sizing signal. Cost: 4 credits per community.
4. `x_search` with `type: "people"`: find X accounts talking about the topic. Single page, no cursor. Cost: 6 credits.
5. `reddit_get_user` and `x_get_profile`: profile the loudest voices found above before quoting or engaging them. Cost: 4 credits per Reddit user, 4 credits per X account.

## Total cost

48 credits for one subreddit-discovery page, sizing 3 candidate communities, one X people search, and profiling 3 loud voices on each platform.

## Limits worth knowing

- Reddit's discover result depth caps around a few hundred per query; decompose a broad market into several narrower queries.
- `x_search` with `type: "people"` returns a single page with no cursor: it is a scan, not an exhaustive directory.
- `reddit_get_user` and `x_get_profile` need an exact username or handle; use the search results' author/handle fields directly, don't guess one.

## Run it

Platform docs: [/docs/reddit](/docs/reddit) and [/docs/x](/docs/x). Full reference: [/docs](/docs).

---

# Build lead lists from LinkedIn - Veezee

You describe who you sell to; your agent searches LinkedIn and builds a ranked lead list: who to contact, why they fit, and what to open with. The recipe below runs in Claude, n8n, or your own code on Veezee's LinkedIn tools.

## Recipe

1. Try a handful of prospects free: mint a key (`POST /v1/keys/mint`, no body) under a shared budget of 200 credits per IP per day. A real list with enrichment per prospect needs more; buy a key at [/upgrade](/upgrade), checkout credits the same key.
2. `linkedin_search_people`: turn your buyer description into filters (`title`, `keywords`, `current_company`, `past_company`, `school`), `limit: 30`. One larger call beats several small pages. Cost: 12 credits.
3. `linkedin_get_profile`: enrich the top 10 with `sections: ["experience", "about"]`; the first two sections are included in the base price. Cost: 40 credits for 10.
4. `linkedin_get_company`: firmographic context per distinct company (industry, size, what they do), the raw material for a specific hook. Cost: 4 credits per company.
5. `linkedin_get_posts` on the strongest prospects: one page each is usually enough to spot a recent topic worth referencing in an opener. Cost: 4 credits per prospect.

Every opener line must trace to data a call actually returned: a post topic, a role change, a company fact. No returned hook means "no recent hook found", not an invented one.

## Total cost

104 credits for one search at limit 30, 10 profile enrichments, 8 company lookups, and 5 post pulls.

## Limits worth knowing

- No contact details: Veezee returns LinkedIn profile data, not emails or phone numbers, and sends nothing on your behalf.
- Skip `is_anonymous: true` results; a private profile cannot be enriched. Count it as "match found, profile private" if list size matters.
- A third or fourth profile section adds 2 credits per section per call; on a long list that multiplies fast.
- A past_company name or company-URL filter caps the search limit; `current_company` names work at any limit. For exact company filtering pass the numeric id from `linkedin_get_company`.

## Run it

Full reference: [/docs](/docs). Hiring version of this recipe: [/use-cases/candidate-sourcing](/use-cases/candidate-sourcing).

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

---

# Account research - Veezee

Account research builds a briefing on one target account before a call: what the company is, who matters there, and what they have been posting.

## Recipe

1. One account runs free: mint a key (`POST /v1/keys/mint`, no body) under a shared budget of 200 credits per IP per day. Researching a full account list needs more; buy a key at [/upgrade](/upgrade), checkout credits the same key.
2. `linkedin_get_company`: the company facts, by URL, slug, or website domain: industry, size, headquarters, founding year, specialities. Cost: 4 credits.
3. `linkedin_get_posts` on the company: what it has said publicly, one page. Cost: 4 credits.
4. `linkedin_search_people` with `current_company` set to this company and `title` narrowing to the roles you care about (the champion, the buyer). Cost: 10 credits.
5. `linkedin_get_profile` with `sections: ["experience"]` for the 3 people worth a closer look. Cost: 4 credits each, 12 credits for 3.

## Total cost

30 credits for one company, one post page, one people search, and 3 profiles.

## Limits worth knowing

- No contact details: no emails, no phone numbers. The briefing tells you who to reach, not how to reach them off-platform.
- Each run is a point-in-time snapshot; there is no standing monitor. Re-run before the next call instead.
- Skip `is_anonymous: true` search results; a private profile cannot be fetched.
- A website-domain identifier on `linkedin_get_company` can add a resolution surcharge; set `max_credits` to cap it.

## Run it

Full reference: [/docs](/docs). Batch version for many companies: [/use-cases/company-research](/use-cases/company-research).

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

---

# Launch sentiment sweep - Veezee

A launch sentiment sweep reads out how Reddit and X reacted to a launch, release, or announcement in one pass: volume, representative quotes, themes, and the accounts driving the conversation.

## Recipe

1. A small test sweep runs free: mint a key (`POST /v1/keys/mint`, no body) under a shared budget of 200 credits per IP per day. A real two-platform sweep needs more; buy a key at [/upgrade](/upgrade), checkout credits the same key.
2. `reddit_search` with `type: "posts"` and `range` set to the launch window, then a second pass with `type: "comments"`, `sort: "new"` for reactions buried inside other threads, usually the more honest signal. Cost: 6 credits per query page.
3. `x_search` with `type: "recent"` for the chronological sweep and `type: "popular"` for the highest-engagement takes. Cost: 6 credits per page.
4. `reddit_get_post`: batch-fetch bodies of the threads with the most signal, up to 100 ids per call, first 10 included in the base price. Cost: 4 credits per batch; `detail: "full"` (one id, whole comment tree) adds 4 credits.
5. `x_get_profile` for the 2-3 accounts whose takes are driving the conversation. Cost: 4 credits each.

Veezee returns raw posts, comments, and tweets, never a sentiment score; your agent reads the text and judges tone itself.

## Total cost

36 credits for two Reddit searches, two X searches, one batch body fetch, and two account profiles.

## Limits worth knowing

- `range` works on post search only; comment search has no server-side time filter, so filter comments on `created_at` yourself.
- `x_search` has no date parameter; put `since:`/`until:` operators directly in the query string.
- This is a one-shot sweep of a fixed window. For ongoing coverage of a brand over time, use [/use-cases/brand-monitoring](/use-cases/brand-monitoring).
- Launch-day sweeps often justify `freshness: "realtime"` (+2 credits per call, paid keys only) to catch the last few minutes instead of the last cache cycle.

## Run it

Platform docs: [/docs/reddit](/docs/reddit) and [/docs/x](/docs/x). Full reference: [/docs](/docs).

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

---

# Post and voice research - Veezee

Post and voice research turns a LinkedIn identifier into a picture of what someone posts about: recurring topics, tone, and how often they are active, the groundwork for outreach or a comment that lands.

## Recipe

1. One voice check runs free: mint a key (`POST /v1/keys/mint`, no body) under a shared budget of 200 credits per IP per day.
2. `linkedin_resolve_url` only for a dirty or ambiguous URL; a clean profile URL, slug, or company URL goes straight to step 3. Cost: 2 credits.
3. `linkedin_get_posts`: one page of posts with text, timestamps, and engagement counts. It detects person vs company automatically. Read the page for topics, tone, repost ratio, and the `created_at` spread (that spread is the posting cadence). Cost: 4 credits; each further page is priced the same.
4. `linkedin_get_profile` with `sections: ["about"]` when you want context on who is posting. Cost: 4 credits.

## Total cost

8 credits for one post page plus the author's overview.

## Limits worth knowing

- `linkedin_get_posts` returns an identifier's own recent posts, one page at a time. It is not a keyword search across LinkedIn and cannot fetch one specific post by URL.
- For a company, pass the slug or URL, not a URN or numeric id.
- One page usually answers the voice question; page further only when you need more history, since every page costs the same.

## Run it

Full reference: [/docs](/docs). Turning voice into an outreach list: [/use-cases/outreach-list-builder](/use-cases/outreach-list-builder).

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

---

# Connect LinkedIn to Claude - Veezee

Veezee is a hosted LinkedIn MCP server: paste one URL into Claude and Claude gets LinkedIn people search, full profiles, companies, and posts as tools. Nothing to install, no LinkedIn login, and trying it is free.

## Add it to claude.ai

1. Open Settings, then Connectors, then Add custom connector.
2. Paste this URL: `https://mcp.veezee.io/linkedin?src=connect-lp`
3. Ask Claude to look up a public LinkedIn profile URL and summarize the person's experience.

That URL carries the LinkedIn tools. Paste `https://mcp.veezee.io/all?src=connect-lp` instead to add Reddit and X tools over the same connection.

## Using Claude Code?

```
claude mcp add --transport http veezee "https://mcp.veezee.io/all?src=connect-lp"
```

Cursor, ChatGPT, VS Code, and the other MCP clients are covered in [/docs/clients](/docs/clients).

## What Claude can do once connected

- Search people by title, company, school, or location (`linkedin_search_people`).
- Fetch a full profile with experience and education from a URL, slug, or name (`linkedin_get_profile`).
- Look up a company's size, industry, and page posts (`linkedin_get_company`, `linkedin_get_posts`).

Ask in plain words: "prep me for my next call with this profile URL", "who runs data engineering at this company", "what did their company page post this month".

## What it costs

Trying it is free: 200 credits a day, no card, no signup. Adding your email claims a one-time 10,000-credit grant. After that it is pay as you go at $2 per 1,000 credits; a profile fetch costs 4 credits, a people search 10 credits. Failed calls refund automatically. Full price list: [/pricing](/pricing).

## Common questions

**Does it touch my LinkedIn account?** No. It does not ask for your LinkedIn login or cookies, and there is no browser extension. Claude reads public LinkedIn data through Veezee's managed API.

**What are the free limits?** A free connection searches up to 10 results per call, returns the first page only, and serves cached data. Paid credits raise the search limit to 30 and unlock pagination and realtime fetches.

**What is an MCP server?** The standard way to give tools to Claude and other AI assistants. You paste a URL once; the assistant discovers the tools by itself.

Full reference: [/docs](/docs). Agent-first setup: [/agent-setup](/agent-setup).

---

# Agent skills - Veezee docs

Skills are SKILL.md instruction packs your agent installs once and reuses: each pack teaches a recurring job (inputs, tool sequence, budget rules) on top of the Veezee tools. All packs live in [veezeehq/veezee-skills on GitHub](https://github.com/veezeehq/veezee-skills) and ship inside the [@veezee/sdk npm package](https://www.npmjs.com/package/@veezee/sdk).

## Install

From GitHub:

```
npx skills add veezeehq/veezee-skills
```

Or from the npm package, after `npm install @veezee/sdk`:

```
npx skills add ./node_modules/@veezee/sdk/skills
```

Or copy the raw SKILL.md into your project's skills directory.

## Available skills

- prospect-enrich: enrich known prospects with current role, company, and experience data, with per-run credit budget rules. [SKILL.md](https://github.com/veezeehq/veezee-skills/blob/main/skills/prospect-enrich/SKILL.md)
- candidate-sourcing: turn a role spec (title, company, school) into a ranked, enriched shortlist. [SKILL.md](https://github.com/veezeehq/veezee-skills/blob/main/skills/candidate-sourcing/SKILL.md)
- company-enrichment: enrich a batch of companies (URLs, slugs, or website domains) with firmographics. [SKILL.md](https://github.com/veezeehq/veezee-skills/blob/main/skills/company-enrichment/SKILL.md)
- account-research: one-account pre-outreach briefing: company facts, key people, recent posts. [SKILL.md](https://github.com/veezeehq/veezee-skills/blob/main/skills/account-research/SKILL.md)
- post-voice-research: what a person or company posts about: topics, tone, cadence. [SKILL.md](https://github.com/veezeehq/veezee-skills/blob/main/skills/post-voice-research/SKILL.md)
- reddit-monitoring: watch subreddits and comment chatter for a brand, product, or topic, with budget rules. [SKILL.md](https://github.com/veezeehq/veezee-skills/blob/main/skills/reddit-monitoring/SKILL.md)
- launch-sentiment-sweep: one-shot Reddit and X reaction readout for a launch or announcement: volume, quotes, themes, notable accounts. [SKILL.md](https://github.com/veezeehq/veezee-skills/blob/main/skills/launch-sentiment-sweep/SKILL.md)
- outreach-list-builder: turn an ICP spec into a ranked outbound sales list with company context and opener hooks. [SKILL.md](https://github.com/veezeehq/veezee-skills/blob/main/skills/outreach-list-builder/SKILL.md)

Both installs carry all eight packs (the npm package ships them as of SDK 0.7.0).

## Machine index

Agents can enumerate the packs at https://veezee.io/.well-known/agent-skills/index.json.

Truth rule: a skill only instructs what the shipped tools actually do; every pack is validated in CI (frontmatter shape, forbidden-vocabulary scan).

---

# Evidence - Veezee

Public results of the Veezee tool-selection eval: does a fresh-context model pick the right Veezee tool, emit a valid first call, and read a real response envelope correctly? Machine-readable twin: [/evidence/tool-selection-eval.json](/evidence/tool-selection-eval.json).

## Method

Anthropic tool-eval rubric, three axes, graded by three fresh-context subagents.

Picker sees ONLY the tool names + descriptions and a realistic user ask, and must name the right tool with no args. First-call-success sees names + descriptions + params and must emit the exact first call (tool + JSON args), validated against the frozen zod schemas. Response-usability sees a real production response envelope and must answer the user's question from it and name its next action.

No agent saw the expected answers. All results reflect the shipped tool descriptions as of the run date.

Models: picker Haiku (the smallest model the descriptions must survive), first-call Sonnet, response-usability Sonnet. Run date: 2026-07-11.

## Scope: what this does and doesn't measure

This eval measures tool-selection and first-call / response-envelope usability only: whether a model picks the right tool for a realistic ask, emits a valid first call, and can read and act on a real response envelope. It does NOT measure data quality, coverage, or freshness, and it does NOT measure API availability or latency. It covers the LinkedIn toolset (five LinkedIn tools plus get_usage); the Reddit and X tools shipped after this run and have not yet been through this eval.

## Picker: 13/13

| Case | Ask | Expected | Selected | Result |
| --- | --- | --- | --- | --- |
| P1 | Find the LinkedIn profile of the CTO of Datadog. | linkedin_search_people | linkedin_search_people | pass |
| P2 | What has Anthropic been posting on LinkedIn recently? | linkedin_get_posts | linkedin_get_posts | pass |
| P3 | Pull the full work history for linkedin.com/in/satyanadella. | linkedin_get_profile | linkedin_get_profile | pass |
| P4 | How many employees does Stripe have on LinkedIn? | linkedin_get_company | linkedin_get_company | pass |
| P5 | A user pasted this link, what is it? https://www.linkedin.com/company/openai/?utm_source=chatgpt | linkedin_resolve_url or linkedin_get_company | linkedin_resolve_url | pass |
| P7 | How many credits do I have left? | get_usage | get_usage | pass |
| P8 | Find software engineers at Shopify who used to work at Amazon. | linkedin_search_people | linkedin_search_people | pass |
| P9 | Get the education history of williamhgates. | linkedin_get_profile | linkedin_get_profile | pass |
| P10 | I only have the website vercel.com. Get their LinkedIn company info. | linkedin_get_company | linkedin_get_company | pass |
| P11 | Did Bill Gates post anything about malaria this month? | linkedin_get_posts | linkedin_get_posts | pass |
| P12 | Look up the profile of the person named 'Jordan Rivera' who works at Datadog. | linkedin_search_people | linkedin_search_people | pass |
| P13 | Check whether my key is still valid and what plan I'm on. | get_usage | get_usage | pass |
| P14 | Read this specific post for me: https://www.linkedin.com/feed/update/urn:li:activity:7123456789/ | linkedin_resolve_url or none | none | pass |

## First-call success: 8/8

| Case | Ask | Tool | Args | Result |
| --- | --- | --- | --- | --- |
| F1 | Pull the work history for linkedin.com/in/satyanadella. | linkedin_get_profile | `{"identifier":"linkedin.com/in/satyanadella","sections":["experience"]}` | pass |
| F2 | Find software engineers at Shopify who used to work at Amazon. | linkedin_search_people | `{"title":"Software Engineer","current_company":"Shopify","past_company":"Amazon"}` | pass |
| F3 | I only have the website vercel.com. Get their LinkedIn company info. | linkedin_get_company | `{"identifier":"vercel.com"}` | pass |
| F4 | What has Anthropic been posting on LinkedIn recently? | linkedin_get_posts | `{"identifier":"anthropic"}` | pass |
| F5 | Get the education history of williamhgates. | linkedin_get_profile | `{"identifier":"williamhgates","sections":["education"]}` | pass |
| F6 | Search up to 30 results for CTOs at Anthropic, but do not spend more than 15 credits on the call. | linkedin_search_people | `{"keywords":"CTO Anthropic","title":"CTO","limit":30,"max_credits":15}` | pass |
| F7 | Get LinkedIn company info for microsoft.com with a hard 6-credit ceiling. | linkedin_get_company | `{"identifier":"microsoft.com","max_credits":6}` | pass |
| F8 | (a LinkedIn company URL passed as the identifier) | linkedin_get_company | `{}` | pass |

Notes on the hard cases: **F3** Website domains are first-class identifiers: the domain reaches the company in one call, zero extra turns.

**F6** The hard case: a result cap plus a hard credit ceiling. The model followed the description's budget rule (quote 12 <= max_credits 15) and avoided the company-name-filter-plus-3-pages combination the planner rejects; the server's teaching error remains the safety net for agents that miss it.

**F7** Correctly predicted from the published prices that domain resolution quotes 8 credits, exceeding max_credits=6, and expected the call to reject uncharged.

**F8** Passed the LinkedIn URL straight through as identifier, without misrouting it through linkedin_resolve_url first.

## Response usability: 3/3

| Case | Ask | Envelope source | Result |
| --- | --- | --- | --- |
| U1 | How many employees does Microsoft have on LinkedIn, and what industry is it in? | production linkedin_get_company identifier=microsoft | pass |
| U2 | How many credits do I have left and what did my last few calls cost? | production get_usage | pass |
| U3 | Find CTOs at Anthropic; I will want their profiles next. | production linkedin_search_people keywords=CTO current_company=1035 limit=10 | pass |

Note on U3: the eval's own input envelope was a Microsoft-id search mislabeled "Anthropic". The pass is the model catching that mismatch from the envelope's echoed current_company field and refusing to spend credits on wrong-company fetches; the full grading note is in the JSON twin.

## 30-day availability and latency

Pending. Synthetics-derived 30-day availability and p50/p95 latency have not accumulated enough data yet. This section will be filled in once that monitoring window closes; no numbers are published here in the meantime.

## Verdict

Descriptions pass the picker axis on a small fast model (Haiku) and the first-call axis on a mid-size model (Sonnet). The hardest cases (a result cap combined with a hard credit ceiling; a website domain as the only identifier) pass on the first call with the shipped descriptions.