Docs

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

Start here#

Platforms#

Surfaces#

Reference#

Getting started#

Fastest path: paste one line into your agent and let it set itself up.

Your agent's chat

Fetch https://veezee.io/agent-setup/prompt.md and follow the setup instructions.

Or do the same by hand:

1. Get a free key#

Terminal

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

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

2. Call the API#

Terminal

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

The free key includes 200 credits per IP per day, recent data only. If you call without a key, the error response tells you exactly how to get one, so an agent recovers on its own in one round-trip.

3. Or connect over MCP#

MCP endpoint

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. Need more than the free budget? Buy credits#

Pick a pack at /upgrade and pay: checkout credits the same key, so nothing needs reconfiguring.

Send the key as Authorization: Bearer <api_key> on every REST call, or in your MCP client's connection headers. Paid calls also send an Idempotency-Key header (any unique string per call) so a retried call is never billed twice.

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: Structured people and company data for outreach, recruiting, and research.
Reddit: Discussions and comment-level sentiment: what people actually say about a product, problem, or brand, straight from the comments.
X (formerly Twitter): 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.
linkedin_get_profile 4 credits: Get a LinkedIn person profile.
linkedin_search_people 10 credits: Search people on LinkedIn.
linkedin_get_company 4 credits: Get a LinkedIn company.
linkedin_get_posts 4 credits: Get recent posts by a person or company.
reddit_search 6 credits: Search Reddit posts, comments, subreddits, or users.
reddit_get_subreddit 4 credits: Get subreddit details.
reddit_get_subreddit_posts 4 credits: Get a subreddit's posts.
reddit_get_user 4 credits: Get a Reddit user.
reddit_get_post 4 credits: Get Reddit posts by id, with optional discussion thread.
reddit_resolve_url 2 credits: Identify a Reddit URL.
x_search 6 credits: Search X (formerly Twitter).
x_get_profile 4 credits: Get an X profile.
x_get_tweets 4 credits: Get an account's tweets.
x_get_tweet 4 credits: Get one tweet with full metrics.
x_resolve_url 2 credits: Identify an X URL.
get_usage 0 credits: Check credits and recent charges.

More reference#

Field reference: every field Veezee actually serves, by entity.
Auth reference: every REST or CLI call needs a key, and your agent creates one free; MCP clients that support the authorization spec sign in over the browser instead. Key types at a glance: vz_live_ keys make data calls, vz_trial_ keys are limited trial keys, and vzm_ tokens manage an account from the dashboard.
Error reference: every error code, when it happens, and how to recover.
Use cases: candidate sourcing, outreach list building, prospect enrichment, account research, company research, brand monitoring, launch sentiment sweep, market research, post and voice research.
AGENTS.md: non-obvious rules for agents calling Veezee.