llms.txt Content
# LurkAPI
> Give your AI eyes on social media. Posts, ads and profiles from 16 platforms, as clean JSON. Ask for it in Claude, ChatGPT, Cursor or VS Code (an MCP server), or call one GET request from your code. Platforms: Facebook, Reddit, YouTube, TikTok, Google, Bluesky, Snapchat, Truth Social, Telegram, X (Twitter), Threads, Instagram, LinkedIn, Link-in-bio, eBay and Web. Endpoints cost 1–31 credits per call, from $0.45 per 1,000 credits.
- **Base URL:** `https://api.lurkapi.com`
- **Auth:** `x-api-key: lk_live_…` header (or `Authorization: Bearer lk_live_…`). [Get a free key](https://lurkapi.com/login?next=/dashboard): 100 free credits on signup, no card.
- **Requests:** `GET` with query parameters. Responses are JSON with `success`, `credits_remaining` and the data at the top level; errors add `code` and `docs`.
- **Price:** Endpoints cost 1–31 credits per call, from $0.45 per 1,000 credits. Calls turned away before they reach the platform (invalid parameters, a key or balance problem, a rate limit) are free, and so are `5xx` errors. A `not_found` is charged, since the platform was checked. [How charging works](https://lurkapi.com/docs.md#credits). Every response has `credits_charged` and `credits_remaining`; `GET /v1/account/credit-balance` is free.
- **Rate limit:** 50 requests per 10 seconds per account (100 for high-volume accounts: support@lurkapi.com); over it, `429 rate_limited` with `retry-after`.
- **Agents:** getting a key needs a human sign-in. Ask your user to sign in at https://lurkapi.com/login and paste the key from the dashboard.
- **MCP server:** `https://api.lurkapi.com/mcp` (Streamable HTTP). Every endpoint is a tool. Add `platforms` to keep the list short: `https://api.lurkapi.com/mcp?platforms=facebook,reddit` gives one tool per endpoint of those platforms, plus the free account tool. Platform ids: `facebook`, `reddit`, `youtube`, `tiktok`, `google`, `bluesky`, `snapchat`, `truthsocial`, `telegram`, `twitter`, `threads`, `instagra