llms.txt Content
# Stormy Social Data
Stormy is a REST API and remote Streamable HTTP MCP server for public social data across Instagram, YouTube, TikTok, X, LinkedIn, and Reddit.
Human documentation: https://stormy.ai/docs
OpenAPI: https://stormy.ai/openapi.json
Machine capabilities: https://stormy.ai/api/v1/capabilities
MCP endpoint: https://stormy.ai/mcp
REST base URL: https://stormy.ai/api/v1
## Authentication
Use either header:
Authorization: Bearer YOUR_STORMY_API_KEY
X-API-Key: YOUR_STORMY_API_KEY
Never send an API key in a URL, JSON body, prompt, or MCP tool argument.
Every connect snippet below writes the header as "Bearer $STORMY_API_KEY". That
is a SHELL VARIABLE and it is expanded when you connect, not later. Export it
first, in the same shell:
export STORMY_API_KEY=stm_live_...
Without that you store the literal characters $STORMY_API_KEY and every call
answers 401 "Invalid or revoked Stormy API key" while your key is fine. If you
cannot export it, paste the key into the snippet literally instead.
## Simple synchronous REST endpoints
POST /search
Body: {"platform":"youtube","query":"roofing creators in Ohio","limit":10,"fresh":false}
Platforms: instagram, youtube, tiktok, x, linkedin, reddit.
limit: 1-100. fresh defaults to false and reads cache.
Optional: min_followers, max_followers.
Cost: limit x $0.01 cached, limit x $0.08 fresh. The body above costs $0.10;
the same call with "limit":25,"fresh":true costs $2.00. GET /pricing quotes any
call before you send it.
Takes 45-90 seconds. Past 100 seconds it answers 200 with a job_id and
poll_after_seconds instead of holding the connection to the gateway's ceiling.
POST /profile
Body: {"target":"https://tiktok.com/@creator","platform":"tiktok","fresh":true,"include_posts":true}
target may be a URL, handle, username, public identifier, or channel ID.
POST /emails
Body: {"platform":"youtube","targets":["@creator_one","@creator_two"]}
Supported for Instagram, TikTok, and YouTube. 1-25 targets. Only successful veri
OpenAPI Spec (preview)
{"openapi":"3.1.0","info":{"title":"Stormy Social Data API","description":"Usage-priced social profile, post, and contact data over REST and MCP.","version":"1.0.0"},"paths":{"/api/v1/pricing":{"get":{"tags":["Stormy Social Data"],"summary":"Pricing","operationId":"pricing_api_v1_pricing_get","parameters":[{"name":"quantity","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Quantity"}},{"name":"include_email","in":"query","required":false,"schema":{"type":"boolean",