{"openapi":"3.1.0","info":{"title":"Executive Producer — Public API","version":"1.0.0","summary":"Read-only story-discovery API for AI agents and integrators.","description":"Executive Producer is a discovery index for local news across 18 US metros. Every story links to its primary publisher via `canonical_source_url` — that is the URL to cite. Editorial fields (score, hook, visuals suggestion) are prefixed `ep_`.\n\nPaid endpoints accept native agent payment via x402 (USDC on Base mainnet). `/national` is free — it is the flagship cross-market rollup surface and exists to make us findable by agents.\n\nNo API keys. Rate-limited at the edge. Please set an identifying User-Agent header.","contact":{"name":"Joshua Harrington","email":"hello@news-ep.com"},"license":{"name":"Metadata attribution-required; source text belongs to publisher","url":"https://news-ep.com/llms.txt"}},"servers":[{"url":"https://news-ep.com/api/v1"}],"paths":{"/stories":{"get":{"summary":"List ranked, deduped story clusters","operationId":"listStories","parameters":[{"name":"market","in":"query","schema":{"type":"string","enum":["dmv","hampton-roads","baltimore","richmond","philadelphia","new-york","chicago","atlanta","detroit","charlotte","raleigh-durham","memphis"],"default":"dmv"}},{"name":"category","in":"query","schema":{"type":"string","enum":["transportation","crime","politics","development","education","environment","health","business","community","sports","weather","other"]}},{"name":"geography","in":"query","schema":{"type":"string","maxLength":120}},{"name":"breaking","in":"query","schema":{"type":"boolean"}},{"name":"trending","in":"query","schema":{"type":"boolean"}},{"name":"since","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"q","in":"query","schema":{"type":"string","maxLength":200}},{"name":"sort","in":"query","schema":{"type":"string","enum":["score","recent"],"default":"score"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Paginated list of stories","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoryList"}}}}}}},"/stories/{story_id}":{"get":{"summary":"Fetch a single story by ID","operationId":"getStory","parameters":[{"name":"story_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"A single story","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Story"}}}},"404":{"description":"Story not found"}}}},"/national":{"get":{"summary":"Cross-market story rollups (free)","operationId":"listNationalRollups","parameters":[{"name":"category","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["score","recent"],"default":"score"}},{"name":"hours","in":"query","schema":{"type":"integer","minimum":1,"maximum":168,"default":48}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":25}}],"responses":{"200":{"description":"Paginated list of rollups","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NationalRollupList"}}}}}}},"/national/{rollup_id}":{"get":{"summary":"Fetch a single national rollup by ID","operationId":"getNationalRollup","parameters":[{"name":"rollup_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"A single rollup","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NationalRollup"}}}},"404":{"description":"Rollup not found"}}}}},"components":{"schemas":{"HardFacts":{"type":"object","properties":{"who":{"type":["string","null"]},"what":{"type":["string","null"]},"when":{"type":["string","null"]},"where":{"type":["string","null"]},"why":{"type":["string","null"]}}},"Source":{"type":"object","required":["name","outlet_url","article_url","credibility_tier"],"properties":{"name":{"type":"string"},"outlet_url":{"type":"string","format":"uri"},"article_url":{"type":"string","format":"uri"},"credibility_tier":{"type":"integer","description":"1=official, 2=major outlet, 3=local/niche, 4=community"}}},"Story":{"type":"object","required":["id","headline","category","market","canonical_source_url","ep_url","ep_score","sources","created_at","updated_at"],"properties":{"id":{"type":"integer"},"headline":{"type":"string"},"summary":{"type":["string","null"]},"category":{"type":"string"},"geography":{"type":["string","null"]},"market":{"type":"string"},"hard_facts":{"$ref":"#/components/schemas/HardFacts"},"is_breaking":{"type":"boolean"},"trending_direction":{"type":"string","enum":["rising","stable","falling"]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"canonical_source_url":{"type":"string","format":"uri","description":"Primary publisher URL. Cite this, not ep_url."},"ep_url":{"type":"string","format":"uri"},"ep_score":{"type":"integer","minimum":0,"maximum":100},"ep_hook":{"type":["string","null"]},"ep_visuals_suggestion":{"type":["string","null"]},"follows_up_on":{"type":["integer","null"]},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}}},"Pagination":{"type":"object","required":["page","per_page","total","has_more"],"properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"has_more":{"type":"boolean"}}},"StoryList":{"type":"object","required":["stories","pagination","attribution"],"properties":{"stories":{"type":"array","items":{"$ref":"#/components/schemas/Story"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"attribution":{"type":"string"}}},"RollupComponent":{"type":"object","required":["cluster_id","market","headline","ep_url"],"properties":{"cluster_id":{"type":"integer"},"market":{"type":"string"},"headline":{"type":"string"},"ep_url":{"type":"string","format":"uri"}}},"NationalRollup":{"type":"object","required":["id","headline","topic_category","rollup_score","markets_covered","markets","component_stories","sources","created_at","updated_at","ep_url"],"properties":{"id":{"type":"integer"},"headline":{"type":"string"},"summary":{"type":["string","null"]},"topic_category":{"type":"string"},"rollup_score":{"type":"number"},"markets_covered":{"type":"integer"},"markets":{"type":"array","items":{"type":"string"}},"primary_story_id":{"type":["integer","null"]},"component_stories":{"type":"array","items":{"$ref":"#/components/schemas/RollupComponent"}},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"ep_url":{"type":"string","format":"uri"}}},"NationalRollupList":{"type":"object","required":["rollups","total","attribution"],"properties":{"rollups":{"type":"array","items":{"$ref":"#/components/schemas/NationalRollup"}},"total":{"type":"integer"},"attribution":{"type":"string"}}}}}}