{"openapi":"3.1.0","info":{"title":"Sararath","description":"Read-only index of Thai government news. Not affiliated with any government agency.","version":"1.0.0"},"components":{},"paths":{"/v1/articles":{"get":{"operationId":"getV1Articles","tags":["articles"],"summary":"List articles","responses":{"200":{"description":"A page of articles","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"object","properties":{"slug":{"type":"string"},"name_th":{"type":"string"},"homepage_url":{"type":"string"}},"required":["slug","name_th","homepage_url"]},"title":{"type":"string"},"summary":{"type":["string","null"]},"body_text":{"type":"string"},"category":{"type":"string"},"agency_name":{"type":"string"},"canonical_url":{"type":"string"},"language":{"type":"string"},"published_at":{"type":["string","null"]},"published_raw":{"type":"string"},"retrieved_at":{"type":["string","null"]},"last_seen_at":{"type":["string","null"]},"attachments":{"type":"array","items":{"type":"string"}}},"required":["id","source","title","summary","body_text","category","agency_name","canonical_url","language","published_at","published_raw","retrieved_at","last_seen_at","attachments"]}},"next_cursor":{"type":["string","null"]}},"required":["items","next_cursor"]}}}},"400":{"description":"Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"array","items":{}},"data":{}},"required":["success","error","data"]}}}},"404":{"description":"Cursor not found","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}},"required":["detail"]}}}},"422":{"description":"Bad limit, date, or cursor","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}},"required":["detail"]}}}}},"parameters":[{"in":"query","name":"source","schema":{"type":"string"}},{"in":"query","name":"agency","schema":{"type":"string"}},{"in":"query","name":"category","schema":{"type":"string"}},{"in":"query","name":"published_from","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"published_to","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"q","schema":{"type":"string","minLength":1,"maxLength":100}},{"in":"query","name":"limit","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"cursor","schema":{"type":"string"}}]}},"/v1/articles/{article_id}":{"get":{"operationId":"getV1ArticlesByArticleId","tags":["articles"],"summary":"Get one article","responses":{"200":{"description":"The article","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"object","properties":{"slug":{"type":"string"},"name_th":{"type":"string"},"homepage_url":{"type":"string"}},"required":["slug","name_th","homepage_url"]},"title":{"type":"string"},"summary":{"type":["string","null"]},"body_text":{"type":"string"},"category":{"type":"string"},"agency_name":{"type":"string"},"canonical_url":{"type":"string"},"language":{"type":"string"},"published_at":{"type":["string","null"]},"published_raw":{"type":"string"},"retrieved_at":{"type":["string","null"]},"last_seen_at":{"type":["string","null"]},"attachments":{"type":"array","items":{"type":"string"}}},"required":["id","source","title","summary","body_text","category","agency_name","canonical_url","language","published_at","published_raw","retrieved_at","last_seen_at","attachments"]}}}},"400":{"description":"Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"array","items":{}},"data":{}},"required":["success","error","data"]}}}},"404":{"description":"Article not found","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}},"required":["detail"]}}}},"422":{"description":"Bad article id","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}},"required":["detail"]}}}}},"parameters":[{"in":"path","name":"article_id","schema":{"type":"string"},"required":true}]}},"/v1/categories":{"get":{"operationId":"getV1Categories","tags":["articles"],"summary":"List categories with counts","responses":{"200":{"description":"Categories scoped by source and q","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"number"}},"required":["value","count"]}}},"required":["items"]}}}},"400":{"description":"Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"array","items":{}},"data":{}},"required":["success","error","data"]}}}}},"parameters":[{"in":"query","name":"source","schema":{"type":"string"}},{"in":"query","name":"q","schema":{"type":"string"}}]}},"/v1/suggest":{"get":{"operationId":"getV1Suggest","tags":["articles"],"summary":"Suggest sources and articles for a query","responses":{"200":{"description":"Suggestions","content":{"application/json":{"schema":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name_th":{"type":"string"},"homepage_url":{"type":"string"}},"required":["slug","name_th","homepage_url"]}},"articles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]}}},"required":["sources","articles"]}}}},"400":{"description":"Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"array","items":{}},"data":{}},"required":["success","error","data"]}}}}},"parameters":[{"in":"query","name":"q","schema":{"default":"","type":"string"}},{"in":"query","name":"limit","schema":{"default":6,"type":"integer","minimum":1,"maximum":20}}]}},"/v1/runs":{"get":{"operationId":"getV1Runs","tags":["ops"],"summary":"Recent collector runs","responses":{"200":{"description":"Runs, newest first","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"started_at":{"type":"string"},"finished_at":{"type":["string","null"]},"status":{"type":"string"},"http_status":{"type":["number","null"]},"found_count":{"type":"number"},"inserted_count":{"type":"number"},"skipped_count":{"type":"number"},"error":{"type":["string","null"]}},"required":["source","started_at","finished_at","status","http_status","found_count","inserted_count","skipped_count","error"]}}},"required":["items"]}}}},"400":{"description":"Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"array","items":{}},"data":{}},"required":["success","error","data"]}}}}},"parameters":[{"in":"query","name":"source","schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}}]}},"/v1/sources":{"get":{"operationId":"getV1Sources","tags":["ops"],"summary":"Configured sources","responses":{"200":{"description":"Sources","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name_th":{"type":"string"},"name_en":{"type":"string"},"collector":{"type":"string"},"enabled":{"type":"boolean"},"last_success_at":{"type":["string","null"]},"last_error":{"type":["string","null"]}},"required":["slug","name_th","name_en","collector","enabled","last_success_at","last_error"]}}},"required":["items"]}}}}}}},"/v1/health":{"get":{"operationId":"getV1Health","tags":["ops"],"summary":"Health check","responses":{"200":{"description":"Database reachable","content":{"application/json":{"schema":{"type":"object","properties":{"db":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"last_success_at":{"type":["string","null"]},"last_error":{"type":["string","null"]}},"required":["slug","last_success_at","last_error"]}}},"required":["db","sources"]}}}},"503":{"description":"Database unreachable","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}},"required":["detail"]}}}}}}}}}