{"openapi":"3.1.0","info":{"title":"CheckNews public API","version":"1.0","description":"Read-only JSON API over the CheckNews archive. No key needed. 120 requests/minute per IP."},"servers":[{"url":"https://checknews.org/api/v1"}],"externalDocs":{"url":"https://checknews.org/desarrolladores.php"},"paths":{"/search.php":{"get":{"operationId":"searchNews","summary":"Search the whole archive (or list latest stories when q is empty)","parameters":[{"name":"q","in":"query","required":false,"description":"Keywords, \"quoted phrase\", or alternatives joined with OR.","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"Start date/datetime (ISO 8601). A story matches if it was active on or after this time.","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"End date/datetime (ISO 8601).","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"Only the last N days (overrides from).","schema":{"type":"integer","minimum":1}},{"name":"hours","in":"query","required":false,"description":"Only the last N hours (overrides from and days).","schema":{"type":"integer","minimum":1}},{"name":"country","in":"query","required":false,"description":"ISO 3166-1 alpha-2 code(s) or country name(s), comma separated.","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"ISO 639-1 code(s), comma separated.","schema":{"type":"string"}},{"name":"publisher","in":"query","required":false,"description":"Exact outlet name, e.g. \"BBC News\".","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Topic.","schema":{"type":"string","enum":["politics","business","technology","climate","sports","science","culture"]}},{"name":"status","in":"query","required":false,"description":"Story momentum.","schema":{"type":"string","enum":["breaking","developing","updates","quiet","hot"]}},{"name":"min_sources","in":"query","required":false,"description":"Minimum number of distinct sources.","schema":{"type":"integer","minimum":0}},{"name":"sort","in":"query","required":false,"description":"Order.","schema":{"type":"string","enum":["relevance","recent","coverage","oldest"]}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100).","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"description":"Pagination offset (use next_offset).","schema":{"type":"integer","minimum":0,"default":0}},{"name":"max_articles","in":"query","required":false,"description":"Articles listed per story (0-60).","schema":{"type":"integer","minimum":0,"maximum":60,"default":10}},{"name":"coverage","in":"query","required":false,"description":"Include the coverage summary (1/0).","schema":{"type":"integer","enum":[0,1],"default":1}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}}},"429":{"description":"Rate limited. See Retry-After."},"503":{"description":"API disabled."}}}},"/story.php":{"get":{"operationId":"getStory","summary":"One story with all its articles","parameters":[{"name":"id","in":"query","required":true,"description":"Story id.","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoryResult"}}}},"429":{"description":"Rate limited. See Retry-After."},"503":{"description":"API disabled."},"404":{"description":"Not found"}}}},"/top.php":{"get":{"operationId":"getTopStories","summary":"Most covered stories in the last N hours","parameters":[{"name":"from","in":"query","required":false,"description":"Start date/datetime (ISO 8601). A story matches if it was active on or after this time.","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"End date/datetime (ISO 8601).","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"Only the last N days (overrides from).","schema":{"type":"integer","minimum":1}},{"name":"hours","in":"query","required":false,"description":"Only the last N hours (overrides from and days).","schema":{"type":"integer","minimum":1}},{"name":"country","in":"query","required":false,"description":"ISO 3166-1 alpha-2 code(s) or country name(s), comma separated.","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"ISO 639-1 code(s), comma separated.","schema":{"type":"string"}},{"name":"publisher","in":"query","required":false,"description":"Exact outlet name, e.g. \"BBC News\".","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Topic.","schema":{"type":"string","enum":["politics","business","technology","climate","sports","science","culture"]}},{"name":"status","in":"query","required":false,"description":"Story momentum.","schema":{"type":"string","enum":["breaking","developing","updates","quiet","hot"]}},{"name":"min_sources","in":"query","required":false,"description":"Minimum number of distinct sources.","schema":{"type":"integer","minimum":0}},{"name":"sort","in":"query","required":false,"description":"Order.","schema":{"type":"string","enum":["relevance","recent","coverage","oldest"]}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100).","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"description":"Pagination offset (use next_offset).","schema":{"type":"integer","minimum":0,"default":0}},{"name":"max_articles","in":"query","required":false,"description":"Articles listed per story (0-60).","schema":{"type":"integer","minimum":0,"maximum":60,"default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}}},"429":{"description":"Rate limited. See Retry-After."},"503":{"description":"API disabled."}}}},"/sources.php":{"get":{"operationId":"getSources","summary":"Feeds polled and outlets active in the last N days","parameters":[{"name":"country","in":"query","required":false,"description":"ISO2 or name.","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"ISO 639-1.","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Part of the outlet name.","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"Window, 1-90.","schema":{"type":"integer","default":30}},{"name":"limit","in":"query","required":false,"description":"1-500.","schema":{"type":"integer","default":200}}],"responses":{"200":{"description":"OK"}}}},"/countries.php":{"get":{"operationId":"listCountries","summary":"Countries monitored and their recent activity","parameters":[{"name":"days","in":"query","required":false,"description":"Window, 1-90.","schema":{"type":"integer","default":7}}],"responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"Article":{"type":"object","properties":{"title":{"type":"string"},"publisher":{"type":["string","null"]},"url":{"type":"string","format":"uri"},"country":{"type":["string","null"]},"country_name":{"type":["string","null"]},"language":{"type":["string","null"]},"published_at":{"type":["string","null"],"format":"date-time"}}},"Story":{"type":"object","properties":{"id":{"type":"integer"},"title":{"type":"string"},"permalink":{"type":"string","format":"uri"},"status":{"type":"string"},"category":{"type":"string"},"country":{"type":["string","null"]},"country_name":{"type":["string","null"]},"language":{"type":["string","null"]},"first_seen_at":{"type":"string","format":"date-time"},"last_activity_at":{"type":"string","format":"date-time"},"source_count":{"type":"integer"},"article_count":{"type":"integer"},"image":{"type":["string","null"]},"source_url":{"type":["string","null"]},"articles":{"type":"array","items":{"$ref":"#/components/schemas/Article"}}}},"StoryResult":{"type":"object","properties":{"story":{"$ref":"#/components/schemas/Story"}}},"SearchResult":{"type":"object","properties":{"query":{"type":"object"},"total":{"type":"integer"},"total_is_capped":{"type":"boolean"},"offset":{"type":"integer"},"limit":{"type":"integer"},"next_offset":{"type":["integer","null"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/Story"}},"coverage":{"type":"object","description":"Aggregates of matching articles: publishers, countries, languages, categories, timeline."},"links":{"type":"object"},"generated_at":{"type":"string","format":"date-time"}}}}}}