{"openapi":"3.1.0","info":{"title":"Creators of Today — Intel API","version":"v1","description":"Live intelligence on real creators: who is RISING (velocity, not size), who works with whom, what tools people actually use, and topic momentum — every number measured, never modeled. Payment posture: **shadow**. Free keys today; published prices are what x402 per-call payment will charge when enforcement flips on. If we haven’t indexed someone you need, POST /creators/request — demand drives our index.","contact":{"email":"hello@creatorsoftoday.com","url":"https://creatorsoftoday.com/developers"}},"servers":[{"url":"https://api.creatorsoftoday.com","description":"production"},{"url":"https://creatorsoftoday.com","description":"production (apex)"}],"tags":[{"name":"Intel","description":"The paid data surface (shadow-billed while mode=shadow)."},{"name":"Account","description":"Keys, usage, pricing — always free."}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Your cot_… API key."}}},"paths":{"/api/intel/v1/keys":{"post":{"operationId":"createKey","summary":"Get a free API key (self-serve, no card)","tags":["Account"],"security":[],"description":"Returns the key ONCE — we store only its SHA-256. Send it as `Authorization: Bearer <key>` (also accepted: x-api-key header, ?api_key= query). Free tier: 1000 requests/day.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","name"],"properties":{"email":{"type":"string","format":"email"},"name":{"type":"string","minLength":2,"maxLength":80},"purpose":{"type":"string","maxLength":300}}},"example":{"email":"you@example.com","name":"My research agent","purpose":"scouting rising AI creators"}}}},"responses":{"201":{"description":"Key issued (shown once).","content":{"application/json":{"schema":{"type":"object"},"example":{"key":"cot_…","plan":"free","note":"Store this key now — we only keep its hash."}}}},"429":{"description":"Per-IP signup limit reached (try tomorrow)."}}}},"/api/intel/v1/pricing":{"get":{"operationId":"intel_pricing","summary":"This price sheet. Always free. · free","tags":["Account"],"security":[],"description":"The machine-readable price sheet. Free, no key. Agents: read this before paying.","responses":{"200":{"description":"Price sheet","content":{"application/json":{"schema":{"type":"object"},"example":{"version":"v1","currency":"USD","skus":"[…]"}}}}}}},"/api/intel/v1/me":{"get":{"operationId":"intel_me","summary":"Your key info + 30-day usage. Free. · free","tags":["Account"],"security":[{"bearerAuth":[]}],"description":"Your key info + last 30 days of usage, including `would_have_cost_usd` (shadow billing).","responses":{"200":{"description":"Key + usage","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Missing/invalid key. Body includes the signup hint."},"402":{"description":"x402 enforce mode only: pay-per-call via the Cloudflare edge (price + accepted assets in body)."},"429":{"description":"Daily plan limit reached."}}}},"/api/intel/v1/rising":{"get":{"operationId":"intel_rising","summary":"Rising creators ranked by velocity (growth rate from a small base), not size. · $0.02/request","tags":["Intel"],"security":[{"bearerAuth":[]}],"description":"Creators ranked by VELOCITY — growth rate from a small base (followers/day, engagement/day), not audience size. A creator going 100→400 outranks one flat at 45k. The signal Harmonic/SignalFire sell enterprise-only, self-serve here. Every response includes `meta`: { sku, price_usd, billed, x402_mode, generated_at, coverage? }. `coverage` states how complete our data is for this answer — trust it.","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Velocity-ranked creators","content":{"application/json":{"schema":{"type":"object"},"example":{"data":{"variant":"velocity","window_days":7,"creators":[{"rank":1,"handle":"mayabuilds","velocity":{"followers":340}}]},"meta":{"sku":"intel.rising","price_usd":0.02,"coverage":{"scoreable_creators":30}}}}}},"401":{"description":"Missing/invalid key. Body includes the signup hint."},"402":{"description":"x402 enforce mode only: pay-per-call via the Cloudflare edge (price + accepted assets in body)."},"429":{"description":"Daily plan limit reached."}}}},"/api/intel/v1/creators/:handle":{"get":{"operationId":"intel_dossier","summary":"One creator, everything: profile, platforms, follower velocity, connections, gear, partnerships, recent work. · $0.01/request","tags":["Intel"],"security":[{"bearerAuth":[]}],"description":"One creator, everything we know: profile, per-platform followers + 14-day velocity (real snapshots, never modeled), top connections, gear they create with, disclosed partnerships, recent work. 404 = not indexed yet — the miss is logged as demand, and the response tells you how to queue them. Every response includes `meta`: { sku, price_usd, billed, x402_mode, generated_at, coverage? }. `coverage` states how complete our data is for this answer — trust it.","parameters":[{"name":"handle","in":"path","required":true,"schema":{"type":"string"},"example":"techguyver","description":"Creator handle, with or without the leading @. Case-insensitive; old handles resolve via aliases."}],"responses":{"200":{"description":"The dossier","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Missing/invalid key. Body includes the signup hint."},"402":{"description":"x402 enforce mode only: pay-per-call via the Cloudflare edge (price + accepted assets in body)."},"404":{"description":"Not indexed. Your interest was logged; POST /creators/request to queue their backfill.","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"not_indexed","request_indexing":{"method":"POST","path":"/api/intel/v1/creators/request"}}}}},"429":{"description":"Daily plan limit reached."}}}},"/api/intel/v1/creators/:handle/graph":{"get":{"operationId":"intel_graph","summary":"Who a creator talks about and who talks about them — the mention + partnership edges. · $0.01/request","tags":["Intel"],"security":[{"bearerAuth":[]}],"description":"The edges around a creator: who they talk about, who talks about them, disclosed brand deals (each with a receipt post).","parameters":[{"name":"handle","in":"path","required":true,"schema":{"type":"string"},"example":"techguyver","description":"Creator handle, with or without the leading @. Case-insensitive; old handles resolve via aliases."}],"responses":{"200":{"description":"Mention + partnership edges","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Missing/invalid key. Body includes the signup hint."},"402":{"description":"x402 enforce mode only: pay-per-call via the Cloudflare edge (price + accepted assets in body)."},"429":{"description":"Daily plan limit reached."}}}},"/api/intel/v1/search":{"get":{"operationId":"intel_search","summary":"Search creators + resources. · $0.005/request","tags":["Intel"],"security":[{"bearerAuth":[]}],"description":"Search creators + resources.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"video agents"}],"responses":{"200":{"description":"Matches","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Missing/invalid key. Body includes the signup hint."},"402":{"description":"x402 enforce mode only: pay-per-call via the Cloudflare edge (price + accepted assets in body)."},"429":{"description":"Daily plan limit reached."}}}},"/api/intel/v1/topics/:slug":{"get":{"operationId":"intel_topic","summary":"Topic momentum: real daily view series + top voices. · $0.005/request","tags":["Intel"],"security":[{"bearerAuth":[]}],"description":"Topic momentum: real measured daily views (90d series) + the top voices driving it.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"example":"agents"}],"responses":{"200":{"description":"Series + voices","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Missing/invalid key. Body includes the signup hint."},"402":{"description":"x402 enforce mode only: pay-per-call via the Cloudflare edge (price + accepted assets in body)."},"429":{"description":"Daily plan limit reached."}}}},"/api/intel/v1/tools/:slug/people":{"get":{"operationId":"intel_tools","summary":"Tool → the people who use it (BuiltWith for people). · $0.01/request","tags":["Intel"],"security":[{"bearerAuth":[]}],"description":"\"BuiltWith for people\" — a tool/gear item and the creators who use it.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"example":"dji-mic-2"}],"responses":{"200":{"description":"Adopters","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Missing/invalid key. Body includes the signup hint."},"402":{"description":"x402 enforce mode only: pay-per-call via the Cloudflare edge (price + accepted assets in body)."},"429":{"description":"Daily plan limit reached."}}}},"/api/intel/v1/creators/request":{"post":{"operationId":"intel_request","summary":"Not indexed yet? Request a creator — we queue their backfill. Demand drives our index. · $0.05/request","tags":["Intel"],"security":[{"bearerAuth":[]}],"description":"Not indexed? Ask. Requests dedupe per (handle, platform) and accumulate a demand counter — the most-wanted creators get indexed first. 202 = queued; once approved, the scrape pipeline backfills them.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["handle"],"properties":{"handle":{"type":"string","maxLength":60},"platform":{"type":"string","enum":["x","instagram","youtube","github"],"default":"x"}}},"example":{"handle":"@somebody_new","platform":"instagram"}}}},"responses":{"200":{"description":"Already indexed — dossier link included.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Queued.","content":{"application/json":{"schema":{"type":"object"},"example":{"data":{"status":"queued","demand":3}}}}},"401":{"description":"Missing/invalid key. Body includes the signup hint."},"402":{"description":"x402 enforce mode only: pay-per-call via the Cloudflare edge (price + accepted assets in body)."},"429":{"description":"Daily plan limit reached."}}}}}}