{"data":{"name":"CreateWith Agent API","description":"Creator-discovery API over Twitch metrics we collected ourselves by polling — Twitch exposes no history, so nothing here is backfilled; collection began 2026-06-08.","facts":["Access: 100 successful data calls per calendar month free; Premium is $29 USD/month for unlimited existing-data usage. Keep the introductory price while continuously subscribed. See /pricing and /account.","Anonymous REST discovery allows 5 data calls and 25 returned rows per IP per UTC day. Production MCP data calls require OAuth sign-in or a verified API key. Verify your email at /login and issue an API key at /account. Existing dossiers require an account. New research and contributions are unavailable during beta. Dossier unlocks grant permanent access to one immutable version; refreshed versions unlock separately.","API keys and OAuth MCP connections share one account plan. Both plans allow 60 requests/minute. Free usage resets at midnight UTC on the first of each month; pagination and empty searches count. Failures, idempotent replays, metadata, shortlist presentation and reopening owned dossier versions do not count. At the free limit, quota_exceeded links to /account to upgrade. Premium has no monthly cap.","Every number here is from snapshots we collected ourselves: collection began 2026-06-08, and nothing before that exists or can be backfilled.","contentQuery/enrichedQuery counts are unknown (null), except total=0 on an empty first page; bandDetail=exact cannot force counts. All hard filters precede pagination; no early candidate cap.","Only the 3d/7d/14d metric windows are computed. 30d becomes computable no earlier than 2026-09-06 and is switched on once the rollup has the headroom for it; 90d no earlier than 2027-03-05.","Off-platform dossiers cover ~1,800 creators out of 650k+ tracked; GET /api/v1/stats is free and carries both live counts, plus where the dossiers are by language and reach band."],"first_reply":"CreateWith searches Twitch creators for brand campaigns. Sign in if your connector prompts you. Describe what you need in your own words and combine requirements freely. These are examples, not a fixed menu:\n\n1. \"Find English-speaking music creators for an audio brand, under 50k followers\" — Off-platform interest (needs: the interest or topic)\n2. \"Find rising English-language Minecraft streamers under 10k followers\" — Rising in a game (needs: game name or genre, follower ceiling)\n3. \"Show me the small Twitch channels blowing up this week\" — Trending right now (needs: size tier (micro/small/mid/large))\n4. \"Find creators whose live audience is unusually big for their follower count\" — Undervalued engagement (runs as it is)\n5. \"Tell me everything you know about the streamer quiggy_\" — Creator lookup (needs: login or display name)\n6. \"Find German-speaking streamers for a campaign running in Germany\" — Market-targeted (needs: market/country)\n7. \"Build a brand-safe shortlist of Fortnite creators between 1k and 50k followers\" — Brand-safe shortlist (needs: game or audience, reach band, shortlist size)\n8. \"What's happening on Twitch right now?\" — What's live now (runs as it is)\n\nTell me your brief. I can search, check the available evidence, and explain which requirements are confirmed or still unknown.","first_reply_note":"`first_reply` offers examples for an unclear brief. The eight recipes are examples, not a fixed menu. Translate a natural-language brief into supported filters and combine them freely. Ask for clarification only when needed; explain requirements the available data cannot establish.","relay_note":"Every metered response carries `meta.relay`: its `recipe` and `window` name the search that ran, and its `say` lines are the caveats for that exact response; `recipes` plus `facts` describe what this service offers.","docs":{"llms":"/llms.txt?v=58d4585","skill":"/skill.md?v=58d4585","openapi":"/openapi.json","signup":"/signup"},"auth":{"scheme":"Authorization: Bearer tw_live_<32 chars>","rule":"Anonymous REST has a daily trial. Verified API keys and OAuth MCP share 100 successful data calls per month free or $29 USD/month Premium with unlimited usage. Both plans allow 60 requests/minute. Existing dossiers require an account; owned version rereads stay free. New research and contributions are unavailable. Account and upgrade details are at /account.","signup":{"url":"/login","keys":"/account","verification_required":true},"free_tier_calls":200,"rate_limit_per_min":60,"guest":{"daily_call_cap":5,"daily_row_cap":25,"note":"Anonymous creator-data calls share 5 calls and 25 rows per IP per UTC day across REST and guest MCP (MCP data calls require an account when OAuth is enabled); exhausted budgets return 429 guest_limit. Browser headers do not increase this allowance. Calls reserve capacity atomically; rows are settled before delivery. Quota outages fail closed with 503 quota_unavailable. Guest Idempotency-Key does not replay responses."}},"endpoints":[{"method":"GET","path":"/api/v1","price_class":"free","description":"Endpoint index and examples."},{"method":"GET","path":"/api/v1/creators/search","price_class":"search","description":"Creator search, ≤25 rows/page: window, q, game, genre, tag, language, broadcaster_type, min/maxAvgViewers, min/maxFollowers, minMomentum, minViewerGrowth, brandSafeOnly, enrichedOnly, enrichedQuery, contentQuery, contentScope, creatorCountry, collaborationBrand, queryMode, textMatch, preferenceQuery, followerScope, categoryBasis, ranking, sort, dir, limit, offset. genre resolves topics across categories; country returns sourced evidence or labelled unverified location-text leads, not audience geography. queryMode defaults to web (required terms); explicit any broadens matching. Unknown or duplicate parameters and invalid values return 400. viewer_growth is a signed ratio: 0.25 means +25% average viewers vs the prior window."},{"method":"GET","path":"/api/v1/creators/{id}","price_class":"read","description":"Profile, metrics and trends by Twitch user id; resolve logins with search?q=."},{"method":"GET","path":"/api/v1/creators/{id}/research","price_class":"dossier","description":"Verified key required. Unlock an immutable dossier version permanently; owned rereads are free. Optional ?version= UUID. Missing coverage is refunded."},{"method":"GET","path":"/api/v1/trending","price_class":"read","description":"Rising creators by size tier; pagination per tier."},{"method":"GET","path":"/api/v1/live","price_class":"read","description":"Live platform overview snapshot."},{"method":"GET","path":"/api/v1/stats","price_class":"free","description":"Corpus coverage and value distributions, with actual overview and component update times. Exact daily component snapshots may be older than the response."},{"method":"GET","path":"/api/v1/categories","price_class":"free","description":"Tracked categories: ?genre= topic or ?q= name; ordered by channel count."},{"method":"POST","path":"/api/v1/keys","price_class":"free","description":"API keys require verified email: sign in at /login, then issue a key at /account. Anonymous key issuance is disabled."},{"method":"GET","path":"/api/v1/account","price_class":"free","description":"Your plan, monthly usage and reset date. Requires an API key or signed-in account."},{"method":"POST","path":"/api/v1/subscription/checkout","price_class":"free","description":"Start Premium at $29 USD/month; returns a hosted payment URL for the account owner."},{"method":"POST","path":"/api/v1/subscription/portal","price_class":"free","description":"Manage subscription payments and cancellation; returns a billing management URL."}],"mcp":{"url":"/api/v1/mcp","transport":"streamable-http (stateless, POST only)","tools":[{"name":"search_creators","price_class":"search"},{"name":"get_creator_research","price_class":"dossier"},{"name":"search_enriched_creators","price_class":"search"},{"name":"get_channel_profile","price_class":"read"},{"name":"get_trending","price_class":"read"},{"name":"get_live","price_class":"read"},{"name":"get_overview_stats","price_class":"free"},{"name":"list_categories","price_class":"free"},{"name":"list_recipes","price_class":"free"},{"name":"present_shortlist","price_class":"free"}],"accept_note":"Raw HTTP callers must also send `Accept: application/json, text/event-stream` — the transport returns 406 without it. Failed calls do not consume monthly allowance. MCP client libraries set it for you.","oauth_enabled":true,"data_calls_require_account":true,"resource_metadata":"/.well-known/oauth-protected-resource"},"recipes":[{"id":"off-platform-interest","title":"Off-platform interest","one_liner":"creators with a real second act (music, art, sport, business).","human_provides":["the interest or topic","reach band (optional)"],"example_ask":"Find streamers who are also musicians (or artists, athletes, founders)","human_prompt":"Find English-speaking music creators for an audio brand, under 50k followers","required_params":["enrichedQuery"],"optional_params":["hideInsufficient","minStreams","minFollowers","maxFollowers","language","ranking","limit"],"call":"GET /api/v1/creators/search?enrichedQuery=<interest>&hideInsufficient=true then GET /api/v1/creators/{id}/research to confirm the interest is in the dossier","example_url":"/api/v1/creators/search?enrichedQuery=music&language=en&maxFollowers=50000&ranking=relevance&hideInsufficient=true","returns":"full-text matches over research dossiers — verify the hit in the dossier before presenting; expect false positives.","notes":"enrichedQuery is full text over dossiers, so expect false positives — a dossier that merely MENTIONS the word matches, which is why the confirming GET /api/v1/creators/{id}/research is part of this recipe; coverage is partial (~1,800 dossiers), so a thin result means few are researched, not that none fit."},{"id":"rising-in-game","title":"Rising in a game","one_liner":"momentum-ranked small creators in one category.","human_provides":["game name or genre","follower ceiling","language (optional)"],"example_ask":"Find rising English-language streamers under 10k followers playing <game>","human_prompt":"Find rising English-language Minecraft streamers under 10k followers","required_params":["sort=momentum_score","game"],"optional_params":["genre","language","maxFollowers","minFollowers","hideInsufficient","minStreams","brandSafeOnly","dir","limit"],"call":"GET /api/v1/creators/search?sort=momentum_score&dir=desc&language=en&maxFollowers=10000&game=<name>&hideInsufficient=true&minStreams=3","example_url":"/api/v1/creators/search?sort=momentum_score&dir=desc&language=en&maxFollowers=10000&game=Minecraft&hideInsufficient=true&minStreams=3","returns":"up to 25 creators with window metrics, momentum rank and latest-stream context.","notes":"minStreams=3 keeps one-off spikes out (hideInsufficient=true implies 3+ streams unless you set minStreams yourself); brandSafeOnly=true composes onto this call, as it does onto every recipe here; unsure the game is covered? GET /api/v1/categories?q=<topic> and GET /api/v1/stats are free."},{"id":"trending-now","title":"Trending right now","one_liner":"disproportionate risers by size tier.","human_provides":["size tier (micro/small/mid/large)","window (optional)"],"example_ask":"Who's blowing up this week among small channels?","human_prompt":"Show me the small Twitch channels blowing up this week","required_params":[],"optional_params":["window","tier","limit"],"call":"GET /api/v1/trending?window=7d&tier=micro","example_url":"/api/v1/trending?window=7d&tier=micro","returns":"per-tier sections with trending_score, confidence, machine-written reasons and a 14-point daily series."},{"id":"undervalued-engagement","title":"Undervalued engagement","one_liner":"the moneyball tell: watchers per follower.","human_provides":["follower band (optional)","game or language (optional)"],"example_ask":"Find creators with unusually engaged audiences for their size","human_prompt":"Find creators whose live audience is unusually big for their follower count","required_params":["sort=viewer_to_follower_ratio"],"optional_params":["minFollowers","maxFollowers","game","genre","language","hideInsufficient","minStreams","dir","limit"],"call":"GET /api/v1/creators/search?sort=viewer_to_follower_ratio&dir=desc&hideInsufficient=true&maxFollowers=<n>","example_url":"/api/v1/creators/search?sort=viewer_to_follower_ratio&dir=desc&hideInsufficient=true&minFollowers=1000&maxFollowers=20000&minStreams=3","returns":"creators ranked by viewer_to_follower_ratio — ~0.3–3% is typical, >5% anomalously engaged."},{"id":"creator-lookup","title":"Creator lookup","one_liner":"everything held on one creator.","human_provides":["login or display name"],"example_ask":"Tell me about streamer <login>","human_prompt":"Tell me everything you know about the streamer quiggy_","required_params":["q"],"optional_params":["limit"],"call":"GET /api/v1/creators/search?q=<login> then GET /api/v1/creators/{id} with rows[0].id, then GET /api/v1/creators/{id}/research","example_url":"/api/v1/creators/search?q=quiggy_","returns":"profile, every computed window, trends, plus the off-platform dossier when one exists.","notes":"{id} is the NUMERIC Twitch user id read from rows[0].id of the search — never the login. No dossier means research is unavailable for this creator. The beta does not commission new research."},{"id":"market-targeted","title":"Market-targeted","one_liner":"broadcast-language candidates; creator location needs separate evidence.","human_provides":["market/country","game or interest (optional)"],"example_ask":"Find UK-based FPS creators","human_prompt":"Find German-speaking streamers for a campaign running in Germany","required_params":["language"],"optional_params":["sort","dir","game","genre","minFollowers","maxFollowers","limit"],"call":"GET /api/v1/creators/search?language=<code>&sort=momentum_score&dir=desc then GET /api/v1/creators/{id}/research and check location","example_url":"/api/v1/creators/search?language=de&sort=momentum_score&dir=desc","returns":"language-filtered candidates — broadcast language is not evidence of creator country or audience geography; creator location is separately sourced or a labelled unverified location-text lead."},{"id":"brand-safe-shortlist","title":"Brand-safe shortlist","one_liner":"outreach-ready picks for a brand brief.","human_provides":["game or audience","reach band","shortlist size"],"example_ask":"Build me a brand-safe shortlist of mid-size <game> creators","human_prompt":"Build a brand-safe shortlist of Fortnite creators between 1k and 50k followers","required_params":["brandSafeOnly=true","minFollowers","sort=momentum_score"],"optional_params":["game","genre","maxFollowers","hideInsufficient","minStreams","language","dir","limit"],"call":"GET /api/v1/creators/search?brandSafeOnly=true&game=<name>&minFollowers=<n>&maxFollowers=<n>&hideInsufficient=true&sort=momentum_score&dir=desc then GET /api/v1/creators/{id}/research for the finalists","example_url":"/api/v1/creators/search?brandSafeOnly=true&game=Fortnite&minFollowers=1000&maxFollowers=50000&hideInsufficient=true&sort=momentum_score&dir=desc","returns":"content-label-filtered creators, momentum-ranked, with metrics; dossiers add socials, location and prior brand deals for the finalists."},{"id":"whats-live","title":"What's live now","one_liner":"right-now platform snapshot.","human_provides":[],"example_ask":"What's happening on Twitch right now?","human_prompt":"What's happening on Twitch right now?","required_params":[],"optional_params":[],"call":"GET /api/v1/live","example_url":"/api/v1/live","returns":"concurrent viewers, live channels, top games/channels/clips at this moment."}],"example_asks":[{"ask":"Find streamers who are also musicians (or artists, athletes, founders)","call":"GET /api/v1/creators/search?enrichedQuery=<interest>&hideInsufficient=true then GET /api/v1/creators/{id}/research to confirm the interest is in the dossier"},{"ask":"Find rising English-language streamers under 10k followers playing <game>","call":"GET /api/v1/creators/search?sort=momentum_score&dir=desc&language=en&maxFollowers=10000&game=<name>&hideInsufficient=true&minStreams=3"},{"ask":"Who's blowing up this week among small channels?","call":"GET /api/v1/trending?window=7d&tier=micro"},{"ask":"Find creators with unusually engaged audiences for their size","call":"GET /api/v1/creators/search?sort=viewer_to_follower_ratio&dir=desc&hideInsufficient=true&maxFollowers=<n>"},{"ask":"Tell me about streamer <login>","call":"GET /api/v1/creators/search?q=<login> then GET /api/v1/creators/{id} with rows[0].id, then GET /api/v1/creators/{id}/research"},{"ask":"Find UK-based FPS creators","call":"GET /api/v1/creators/search?language=<code>&sort=momentum_score&dir=desc then GET /api/v1/creators/{id}/research and check location"},{"ask":"Build me a brand-safe shortlist of mid-size <game> creators","call":"GET /api/v1/creators/search?brandSafeOnly=true&game=<name>&minFollowers=<n>&maxFollowers=<n>&hideInsufficient=true&sort=momentum_score&dir=desc then GET /api/v1/creators/{id}/research for the finalists"},{"ask":"What's happening on Twitch right now?","call":"GET /api/v1/live"}],"quickstart":{"try_it":"curl -s \"https://createwith.dev/api/v1/creators/search?limit=3\"","keep_your_usage_together":"Verify your email at https://createwith.dev/login, then create an API key at https://createwith.dev/account.","then_store_it":"Store the API key and reuse it across sessions in a secrets store. Credits and unlocked dossier versions belong to your account.","call_with_a_key":"curl -H \"Authorization: Bearer tw_live_...\" \"https://createwith.dev/api/v1/creators/search?limit=3\""}},"meta":{"request_id":"2a6e2c92-cf4d-4f8d-b28b-b385b846a026","generated_at":"2026-10-16T17:39:42.469Z","billing":{"price_class":"free","billed_micro":0,"lane":"free","free_calls_remaining":null},"links":{"self":"https://createwith.dev/api/v1","docs":"https://createwith.dev/llms.txt","index":"https://createwith.dev/api/v1","recipes":{"off-platform-interest":"https://createwith.dev/api/v1/creators/search?enrichedQuery=music&language=en&maxFollowers=50000&ranking=relevance&hideInsufficient=true","rising-in-game":"https://createwith.dev/api/v1/creators/search?sort=momentum_score&dir=desc&language=en&maxFollowers=10000&game=Minecraft&hideInsufficient=true&minStreams=3","trending-now":"https://createwith.dev/api/v1/trending?window=7d&tier=micro","undervalued-engagement":"https://createwith.dev/api/v1/creators/search?sort=viewer_to_follower_ratio&dir=desc&hideInsufficient=true&minFollowers=1000&maxFollowers=20000&minStreams=3","creator-lookup":"https://createwith.dev/api/v1/creators/search?q=quiggy_","market-targeted":"https://createwith.dev/api/v1/creators/search?language=de&sort=momentum_score&dir=desc","brand-safe-shortlist":"https://createwith.dev/api/v1/creators/search?brandSafeOnly=true&game=Fortnite&minFollowers=1000&maxFollowers=50000&hideInsufficient=true&sort=momentum_score&dir=desc","whats-live":"https://createwith.dev/api/v1/live"}}}}