# Vanefeed > Vanefeed is a REST API for public social-media data: posts, profiles, comments, search, trends, webhooks and a live stream across YouTube, Reddit, Telegram, web/news, TikTok, Instagram, Facebook and X. One API key, one JSON schema. Only successful calls are charged; every response carries `X-Credits-Cost`; `?dry_run=true` quotes a call for free. Base URL: `https://api.vanefeed.com` (self-hosted installs: `http://127.0.0.1:8765`). Authenticate with `Authorization: Bearer sk_live_...` or `X-API-Key: sk_live_...`. Get a key instantly with 100 free credits at https://vanefeed.com/signup.html, or programmatically with `POST /v1/signup` (JSON: `name`, `email`, `accept_terms: true`, optional `company`, `use_case`; the key is returned once). Try every endpoint in the browser at https://vanefeed.com/playground.html. Usage, request log, keys and billing: https://vanefeed.com/dashboard.html (log in at https://vanefeed.com/login.html). ## Docs - [Full API reference (Markdown)](llms-full.txt): every endpoint, parameter, credit cost, error and example - [Quickstart](https://vanefeed.com/docs.html#quickstart): first call in one minute - [Credits and rate limits](https://vanefeed.com/docs.html#limits): headers `X-Credits-Cost`, `X-Credits-Remaining`, `X-Credits-Low`, `X-Request-Id`, `Retry-After` - [Errors](https://vanefeed.com/docs.html#errors): uniform `{"error", "message"}` shape - [OpenAPI spec](https://api.vanefeed.com/v1/openapi.json) ## Endpoints (live) - `GET /v1/mentions/search` (5 credits): search collected mentions; params `q`, `platform` (repeatable), `author`, `since`, `until`, `lang`, `sort` (new|top), `limit` (1-200), `cursor` - `GET /v1/mentions/{id}` (1): one mention - `GET /v1/accounts/lookup` (2): stats for `platform` + `handle` from collected data - `GET /v1/accounts/{platform}/{handle}/posts` (2): an account's collected posts - `GET /v1/trends` (5): top hashtags; `platform`, `window_hours` (1-720), `limit` (1-100) - `POST /v1/webhooks` (3): push `mention.new` / `alert.fired` events to a public URL, HMAC-SHA256 signed - `GET /v1/stream` (60 per session): server-sent events; `since`, `duration` (1-300 s) - `GET /v1/usage` (free): quota and spend this month ## Endpoints (live, on-demand; youtube, reddit, telegram, web, x, tiktok, instagram, facebook) - `limit` on posts, comments and search: how many results in one call, default 100 (capped at each platform's ceiling); priced per 20 results returned - `GET /v1/youtube/profile` (1): `handle` → Profile {handle, name, verified, followers, ...} - `GET /v1/youtube/posts` (2 per 20 results): `handle`, `tab` (videos|shorts), `limit` (1-1000, default 100), `cursor` - `GET /v1/youtube/post` (1): `id` (video id or URL) - `GET /v1/youtube/comments` (2 per 20 results): `id`, `limit` (1-1000, default 100), `cursor` - `GET /v1/youtube/search` (3 per 20 results): `q`, `limit` (1-1000, default 100), `cursor`, `yt_params` - `GET /v1/reddit/posts?handle=r/`, `/v1/reddit/post?id=`, `/v1/reddit/comments?id=`, `/v1/reddit/search?q=&subreddit=` - `GET /v1/telegram/profile?handle=`, `/v1/telegram/posts?handle=`, `/v1/telegram/post?id=t.me//` - `GET /v1/web/posts?url=`, `/v1/web/search?q=&hl=&gl=` (news) - `GET /v1/x/profile|posts|post|comments|search` (search: `q`, `product`=Latest|Top|Media), `/v1/x/followers|following?handle=` - `GET /v1/x/community?id=` (1): name, description, members, rules, topic, creator - `GET /v1/x/community_posts?id=&sort=latest|top` (2 per 20 results): posts in a community, `limit`, `cursor` - `GET /v1/x/transcript?id=