{"openapi":"3.1.0","info":{"title":"NaijaPress API","description":"\n**Nigerian news, made accessible.**\n\nAccess Nigerian news through a single API for research, analytics, business intelligence, and software\ndevelopment. NaijaPress ingests news from approved Nigerian and relevant international publishers,\nclassifies each article into one of 12 fixed categories, and adds canonical entities, topics and geography.\n\n* Authenticate with `Authorization: Bearer <your API key>`.\n* Always attribute and link to the original publisher (`source.url`).\n* Each plan sets a monthly request quota (one credit per call, not per article), a per-minute rate limit,\n  a maximum number of articles per call, free-text search query length limits and a news access window.\n  These apply on every endpoint. Fields not included in your plan are omitted from responses.\n","version":"1.0.0"},"paths":{"/v1/news":{"get":{"tags":["News"],"summary":"List news","description":"Newest-first list of enriched articles within your plan's access window (calendar days, Nigeria time). Cursor pagination;\npage size is capped at your plan's articles-per-call maximum.","operationId":"list_news_v1_news_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Articles per call; values above your plan's maximum are capped to it","default":20,"title":"Limit"},"description":"Articles per call; values above your plan's maximum are capped to it"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"description":"Cursor from a previous response","title":"Cursor"},"description":"Cursor from a previous response"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"description":"Optional free-text filter; 3 characters minimum, up to your plan's maximum search query length","title":"Q"},"description":"Optional free-text filter; 3 characters minimum, up to your plan's maximum search query length"},{"name":"sort","in":"query","required":false,"schema":{"enum":["published_desc","published_asc"],"type":"string","default":"published_desc","title":"Sort"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"description":"Category slug, e.g. `economy`","title":"Category"},"description":"Category slug, e.g. `economy`"},{"name":"subcategory","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Subcategory"}},{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Topic id or slug","title":"Topic"},"description":"Topic id or slug"},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Entity id or slug","title":"Entity"},"description":"Entity id or slug"},{"name":"location","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Location id or slug (includes child places)","title":"Location"},"description":"Location id or slug (includes child places)"},{"name":"location_role","in":"query","required":false,"schema":{"anyOf":[{"enum":["mentioned","event"],"type":"string"},{"type":"null"}],"description":"Restrict location matches to a role (advanced)","title":"Location Role"},"description":"Restrict location matches to a role (advanced)"},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"description":"Source id or slug","title":"Source"},"description":"Source id or slug"},{"name":"language","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Language"}},{"name":"geographic_scope","in":"query","required":false,"schema":{"anyOf":[{"enum":["local","state","national","regional","global"],"type":"string"},{"type":"null"}],"description":"Advanced filter","title":"Geographic Scope"},"description":"Advanced filter"},{"name":"published_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601; inclusive","title":"Published After"},"description":"ISO 8601; inclusive"},{"name":"published_before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601; inclusive","title":"Published Before"},"description":"ISO 8601; inclusive"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_Article_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]}]}},"/v1/news/{slug}":{"get":{"tags":["News"],"summary":"Get an article","description":"Fetch one article by slug or id. Articles outside your plan's access window return 404.","operationId":"get_news_v1_news__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemResponse_Article_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"}},"security":[{"ApiKey":[]}]}},"/v1/news/{slug}/related":{"get":{"tags":["News"],"summary":"Related news","description":"Articles related through the same event cluster or shared canonical entities/topics (±14 days).","operationId":"related_v1_news__slug__related_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_ScoredArticle_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"}},"security":[{"ApiKey":[]}]}},"/v1/search":{"get":{"tags":["Search"],"summary":"Keyword search","description":"Full-text keyword search (supports quotes, `or` and `-exclusion`). Works without embeddings.","operationId":"search_v1_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","maxLength":300,"description":"Free-text query. Trimmed; 3 characters minimum, up to your plan's maximum search query length","title":"Q"},"description":"Free-text query. Trimmed; 3 characters minimum, up to your plan's maximum search query length"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Articles per call; values above your plan's maximum are capped to it","default":20,"title":"Limit"},"description":"Articles per call; values above your plan's maximum are capped to it"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"description":"Cursor from a previous response","title":"Cursor"},"description":"Cursor from a previous response"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"description":"Category slug, e.g. `economy`","title":"Category"},"description":"Category slug, e.g. `economy`"},{"name":"subcategory","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Subcategory"}},{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Topic id or slug","title":"Topic"},"description":"Topic id or slug"},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Entity id or slug","title":"Entity"},"description":"Entity id or slug"},{"name":"location","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Location id or slug (includes child places)","title":"Location"},"description":"Location id or slug (includes child places)"},{"name":"location_role","in":"query","required":false,"schema":{"anyOf":[{"enum":["mentioned","event"],"type":"string"},{"type":"null"}],"description":"Restrict location matches to a role (advanced)","title":"Location Role"},"description":"Restrict location matches to a role (advanced)"},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"description":"Source id or slug","title":"Source"},"description":"Source id or slug"},{"name":"language","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Language"}},{"name":"geographic_scope","in":"query","required":false,"schema":{"anyOf":[{"enum":["local","state","national","regional","global"],"type":"string"},{"type":"null"}],"description":"Advanced filter","title":"Geographic Scope"},"description":"Advanced filter"},{"name":"published_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601; inclusive","title":"Published After"},"description":"ISO 8601; inclusive"},{"name":"published_before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601; inclusive","title":"Published Before"},"description":"ISO 8601; inclusive"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_ScoredArticle_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]}]}},"/v1/search/semantic":{"get":{"tags":["Search"],"summary":"Semantic search","description":"Meaning-based search over article embeddings. `score` is cosine similarity in [−1, 1].","operationId":"search_semantic_v1_search_semantic_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","maxLength":300,"description":"Free-text query. Trimmed; 3 characters minimum, up to your plan's maximum search query length","title":"Q"},"description":"Free-text query. Trimmed; 3 characters minimum, up to your plan's maximum search query length"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Articles per call; values above your plan's maximum are capped to it","default":20,"title":"Limit"},"description":"Articles per call; values above your plan's maximum are capped to it"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"description":"Cursor from a previous response","title":"Cursor"},"description":"Cursor from a previous response"},{"name":"min_similarity","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1.0,"minimum":-1.0},{"type":"null"}],"title":"Min Similarity"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"description":"Category slug, e.g. `economy`","title":"Category"},"description":"Category slug, e.g. `economy`"},{"name":"subcategory","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Subcategory"}},{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Topic id or slug","title":"Topic"},"description":"Topic id or slug"},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Entity id or slug","title":"Entity"},"description":"Entity id or slug"},{"name":"location","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Location id or slug (includes child places)","title":"Location"},"description":"Location id or slug (includes child places)"},{"name":"location_role","in":"query","required":false,"schema":{"anyOf":[{"enum":["mentioned","event"],"type":"string"},{"type":"null"}],"description":"Restrict location matches to a role (advanced)","title":"Location Role"},"description":"Restrict location matches to a role (advanced)"},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"description":"Source id or slug","title":"Source"},"description":"Source id or slug"},{"name":"language","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Language"}},{"name":"geographic_scope","in":"query","required":false,"schema":{"anyOf":[{"enum":["local","state","national","regional","global"],"type":"string"},{"type":"null"}],"description":"Advanced filter","title":"Geographic Scope"},"description":"Advanced filter"},{"name":"published_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601; inclusive","title":"Published After"},"description":"ISO 8601; inclusive"},{"name":"published_before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601; inclusive","title":"Published Before"},"description":"ISO 8601; inclusive"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_ScoredArticle_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]}]}},"/v1/search/hybrid":{"get":{"tags":["Search"],"summary":"Hybrid search","description":"Keyword + semantic retrieval fused with Reciprocal Rank Fusion (k=60).\n`score` = Σ 1/(60 + rank) over the two rankings; `match` shows each component rank.","operationId":"search_hybrid_v1_search_hybrid_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","maxLength":300,"description":"Free-text query. Trimmed; 3 characters minimum, up to your plan's maximum search query length","title":"Q"},"description":"Free-text query. Trimmed; 3 characters minimum, up to your plan's maximum search query length"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Articles per call; values above your plan's maximum are capped to it","default":20,"title":"Limit"},"description":"Articles per call; values above your plan's maximum are capped to it"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"description":"Cursor from a previous response","title":"Cursor"},"description":"Cursor from a previous response"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"description":"Category slug, e.g. `economy`","title":"Category"},"description":"Category slug, e.g. `economy`"},{"name":"subcategory","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Subcategory"}},{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Topic id or slug","title":"Topic"},"description":"Topic id or slug"},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Entity id or slug","title":"Entity"},"description":"Entity id or slug"},{"name":"location","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Location id or slug (includes child places)","title":"Location"},"description":"Location id or slug (includes child places)"},{"name":"location_role","in":"query","required":false,"schema":{"anyOf":[{"enum":["mentioned","event"],"type":"string"},{"type":"null"}],"description":"Restrict location matches to a role (advanced)","title":"Location Role"},"description":"Restrict location matches to a role (advanced)"},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"description":"Source id or slug","title":"Source"},"description":"Source id or slug"},{"name":"language","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Language"}},{"name":"geographic_scope","in":"query","required":false,"schema":{"anyOf":[{"enum":["local","state","national","regional","global"],"type":"string"},{"type":"null"}],"description":"Advanced filter","title":"Geographic Scope"},"description":"Advanced filter"},{"name":"published_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601; inclusive","title":"Published After"},"description":"ISO 8601; inclusive"},{"name":"published_before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601; inclusive","title":"Published Before"},"description":"ISO 8601; inclusive"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_ScoredArticle_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]}]}},"/v1/categories":{"get":{"tags":["Taxonomy"],"summary":"List categories","operationId":"categories_v1_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_Category_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]}]}},"/v1/categories/{slug}":{"get":{"tags":["Taxonomy"],"summary":"Get a category","operationId":"category_v1_categories__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemResponse_Category_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"}},"security":[{"ApiKey":[]}]}},"/v1/categories/{slug}/subcategories":{"get":{"tags":["Taxonomy"],"summary":"List a category's subcategories","operationId":"category_subcategories_v1_categories__slug__subcategories_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_Subcategory_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"}},"security":[{"ApiKey":[]}]}},"/v1/subcategories/{slug}":{"get":{"tags":["Taxonomy"],"summary":"Get a subcategory","operationId":"subcategory_v1_subcategories__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemResponse_Subcategory_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"}},"security":[{"ApiKey":[]}]}},"/v1/entities":{"get":{"tags":["Entities"],"summary":"List or search entities","operationId":"entities_v1_entities_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Articles per call; values above your plan's maximum are capped to it","default":20,"title":"Limit"},"description":"Articles per call; values above your plan's maximum are capped to it"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"description":"Cursor from a previous response","title":"Cursor"},"description":"Cursor from a previous response"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Name or alias prefix","title":"Q"},"description":"Name or alias prefix"},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_Entity_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]}]}},"/v1/entities/{entity_id}":{"get":{"tags":["Entities"],"summary":"Get an entity","operationId":"entity_v1_entities__entity_id__get","parameters":[{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","title":"Entity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemResponse_Entity_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"}},"security":[{"ApiKey":[]}]}},"/v1/entities/{entity_id}/news":{"get":{"tags":["Entities"],"summary":"News mentioning an entity","operationId":"entity_news_v1_entities__entity_id__news_get","parameters":[{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","title":"Entity Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Articles per call; values above your plan's maximum are capped to it","default":20,"title":"Limit"},"description":"Articles per call; values above your plan's maximum are capped to it"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"description":"Cursor from a previous response","title":"Cursor"},"description":"Cursor from a previous response"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_Article_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]}]}},"/v1/topics":{"get":{"tags":["Topics"],"summary":"List or search topics","operationId":"topics_v1_topics_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Articles per call; values above your plan's maximum are capped to it","default":20,"title":"Limit"},"description":"Articles per call; values above your plan's maximum are capped to it"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"description":"Cursor from a previous response","title":"Cursor"},"description":"Cursor from a previous response"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Q"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_Topic_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]}]}},"/v1/topics/{topic_id}":{"get":{"tags":["Topics"],"summary":"Get a topic","operationId":"topic_v1_topics__topic_id__get","parameters":[{"name":"topic_id","in":"path","required":true,"schema":{"type":"string","title":"Topic Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemResponse_Topic_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"}},"security":[{"ApiKey":[]}]}},"/v1/topics/{topic_id}/news":{"get":{"tags":["Topics"],"summary":"News about a topic","operationId":"topic_news_v1_topics__topic_id__news_get","parameters":[{"name":"topic_id","in":"path","required":true,"schema":{"type":"string","title":"Topic Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Articles per call; values above your plan's maximum are capped to it","default":20,"title":"Limit"},"description":"Articles per call; values above your plan's maximum are capped to it"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"description":"Cursor from a previous response","title":"Cursor"},"description":"Cursor from a previous response"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_Article_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]}]}},"/v1/locations":{"get":{"tags":["Locations"],"summary":"List or search locations","operationId":"locations_v1_locations_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Articles per call; values above your plan's maximum are capped to it","default":50,"title":"Limit"},"description":"Articles per call; values above your plan's maximum are capped to it"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"description":"Cursor from a previous response","title":"Cursor"},"description":"Cursor from a previous response"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Q"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"enum":["country","region","state","lga","city","other"],"type":"string"},{"type":"null"}],"title":"Type"}},{"name":"parent","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Parent location id or slug","title":"Parent"},"description":"Parent location id or slug"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_Location_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]}]}},"/v1/locations/{location_id}":{"get":{"tags":["Locations"],"summary":"Get a location","operationId":"location_v1_locations__location_id__get","parameters":[{"name":"location_id","in":"path","required":true,"schema":{"type":"string","title":"Location Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemResponse_Location_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"}},"security":[{"ApiKey":[]}]}},"/v1/locations/{location_id}/news":{"get":{"tags":["Locations"],"summary":"News about a location","operationId":"location_news_v1_locations__location_id__news_get","parameters":[{"name":"location_id","in":"path","required":true,"schema":{"type":"string","title":"Location Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Articles per call; values above your plan's maximum are capped to it","default":20,"title":"Limit"},"description":"Articles per call; values above your plan's maximum are capped to it"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"description":"Cursor from a previous response","title":"Cursor"},"description":"Cursor from a previous response"},{"name":"role","in":"query","required":false,"schema":{"anyOf":[{"enum":["mentioned","event"],"type":"string"},{"type":"null"}],"description":"Advanced: restrict to event location or mentions","title":"Role"},"description":"Advanced: restrict to event location or mentions"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_Article_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]}]}},"/v1/sources":{"get":{"tags":["Sources"],"summary":"List sources","operationId":"sources_v1_sources_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Articles per call; values above your plan's maximum are capped to it","default":50,"title":"Limit"},"description":"Articles per call; values above your plan's maximum are capped to it"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"description":"Cursor from a previous response","title":"Cursor"},"description":"Cursor from a previous response"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_Source_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]}]}},"/v1/sources/{source_id}":{"get":{"tags":["Sources"],"summary":"Get a source","operationId":"source_v1_sources__source_id__get","parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","title":"Source Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemResponse_Source_"}}}},"401":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not included in your plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit or monthly quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"}},"security":[{"ApiKey":[]}]}},"/health/live":{"get":{"tags":["Health"],"summary":"Liveness probe","operationId":"live_health_live_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/ready":{"get":{"tags":["Health"],"summary":"Readiness probe","description":"Reports only up/down per dependency; no internal details.","operationId":"ready_health_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"Article":{"properties":{"id":{"type":"string","title":"Id"},"slug":{"type":"string","title":"Slug"},"title":{"type":"string","title":"Title"},"source":{"$ref":"#/components/schemas/SourceRef"},"published_at":{"type":"string","format":"date-time","title":"Published At"},"ingested_at":{"type":"string","format":"date-time","title":"Ingested At"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary","description":"AI-generated summary of the publisher's reporting (Growth and Enterprise plans)"},"category":{"anyOf":[{"$ref":"#/components/schemas/CategoryRef"},{"type":"null"}]},"subcategory":{"anyOf":[{"$ref":"#/components/schemas/SubcategoryRef"},{"type":"null"}]},"entities":{"anyOf":[{"items":{"$ref":"#/components/schemas/EntityRef"},"type":"array"},{"type":"null"}],"title":"Entities"},"topics":{"anyOf":[{"items":{"$ref":"#/components/schemas/TopicRef"},"type":"array"},{"type":"null"}],"title":"Topics"},"geography":{"anyOf":[{"$ref":"#/components/schemas/Geography"},{"type":"null"}]},"sentiment":{"anyOf":[{"$ref":"#/components/schemas/Sentiment"},{"type":"null"}]},"event_cluster_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Cluster Id"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content","description":"Full text; only for licensed sources on plans that include it"},"attribution":{"type":"string","title":"Attribution","description":"Required attribution text"}},"type":"object","required":["id","slug","title","source","published_at","ingested_at","attribution"],"title":"Article","description":"A news article. Fields not included in your plan are omitted from the response.\n`summary` is included on Growth and Enterprise. Full text is never returned by default; link to `source.url`."},"Category":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"subcategories":{"anyOf":[{"items":{"$ref":"#/components/schemas/SubcategoryRef"},"type":"array"},{"type":"null"}],"title":"Subcategories"}},"type":"object","required":["slug","name","description"],"title":"Category"},"CategoryRef":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"}},"type":"object","required":["slug","name"],"title":"CategoryRef"},"Entity":{"properties":{"id":{"type":"string","title":"Id"},"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"aliases":{"items":{"type":"string"},"type":"array","title":"Aliases","default":[]},"article_count":{"type":"integer","title":"Article Count"}},"type":"object","required":["id","slug","name","type","article_count"],"title":"Entity"},"EntityRef":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"type":{"type":"string","title":"Type"},"salience":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Salience"}},"type":"object","required":["id","name","slug","type"],"title":"EntityRef"},"ErrorBody":{"properties":{"code":{"type":"string","title":"Code","examples":["not_found"]},"message":{"type":"string","title":"Message"},"details":{"anyOf":[{},{"type":"null"}],"title":"Details"}},"type":"object","required":["code","message"],"title":"ErrorBody"},"ErrorResponse":{"properties":{"error":{"$ref":"#/components/schemas/ErrorBody"}},"type":"object","required":["error"],"title":"ErrorResponse"},"Geography":{"properties":{"mentioned_locations":{"items":{"$ref":"#/components/schemas/PlaceRef"},"type":"array","title":"Mentioned Locations","default":[]},"event_location":{"anyOf":[{"$ref":"#/components/schemas/PlaceRef"},{"type":"null"}],"description":"Where the reported event happened, only when determinable"},"geographic_scope":{"anyOf":[{"type":"string","enum":["local","state","national","regional","global"]},{"type":"null"}],"title":"Geographic Scope"}},"type":"object","title":"Geography"},"ItemResponse_Article_":{"properties":{"data":{"$ref":"#/components/schemas/Article"}},"type":"object","required":["data"],"title":"ItemResponse[Article]"},"ItemResponse_Category_":{"properties":{"data":{"$ref":"#/components/schemas/Category"}},"type":"object","required":["data"],"title":"ItemResponse[Category]"},"ItemResponse_Entity_":{"properties":{"data":{"$ref":"#/components/schemas/Entity"}},"type":"object","required":["data"],"title":"ItemResponse[Entity]"},"ItemResponse_Location_":{"properties":{"data":{"$ref":"#/components/schemas/Location"}},"type":"object","required":["data"],"title":"ItemResponse[Location]"},"ItemResponse_Source_":{"properties":{"data":{"$ref":"#/components/schemas/Source"}},"type":"object","required":["data"],"title":"ItemResponse[Source]"},"ItemResponse_Subcategory_":{"properties":{"data":{"$ref":"#/components/schemas/Subcategory"}},"type":"object","required":["data"],"title":"ItemResponse[Subcategory]"},"ItemResponse_Topic_":{"properties":{"data":{"$ref":"#/components/schemas/Topic"}},"type":"object","required":["data"],"title":"ItemResponse[Topic]"},"ListResponse_Article_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Article"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Meta"}},"type":"object","required":["data","pagination"],"title":"ListResponse[Article]"},"ListResponse_Category_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Category"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Meta"}},"type":"object","required":["data","pagination"],"title":"ListResponse[Category]"},"ListResponse_Entity_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Entity"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Meta"}},"type":"object","required":["data","pagination"],"title":"ListResponse[Entity]"},"ListResponse_Location_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Location"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Meta"}},"type":"object","required":["data","pagination"],"title":"ListResponse[Location]"},"ListResponse_ScoredArticle_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ScoredArticle"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Meta"}},"type":"object","required":["data","pagination"],"title":"ListResponse[ScoredArticle]"},"ListResponse_Source_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Source"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Meta"}},"type":"object","required":["data","pagination"],"title":"ListResponse[Source]"},"ListResponse_Subcategory_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Subcategory"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Meta"}},"type":"object","required":["data","pagination"],"title":"ListResponse[Subcategory]"},"ListResponse_Topic_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Topic"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Meta"}},"type":"object","required":["data","pagination"],"title":"ListResponse[Topic]"},"Location":{"properties":{"id":{"type":"string","title":"Id"},"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"parent":{"anyOf":[{"$ref":"#/components/schemas/PlaceRef"},{"type":"null"}]},"aliases":{"items":{"type":"string"},"type":"array","title":"Aliases","default":[]},"article_count":{"type":"integer","title":"Article Count"}},"type":"object","required":["id","slug","name","type","article_count"],"title":"Location"},"Pagination":{"properties":{"limit":{"type":"integer","title":"Limit"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Opaque cursor; pass as `cursor` to fetch the next page"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["limit","has_more"],"title":"Pagination"},"PlaceRef":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"type":{"type":"string","title":"Type"}},"type":"object","required":["id","name","slug","type"],"title":"PlaceRef"},"ScoredArticle":{"properties":{"id":{"type":"string","title":"Id"},"slug":{"type":"string","title":"Slug"},"title":{"type":"string","title":"Title"},"source":{"$ref":"#/components/schemas/SourceRef"},"published_at":{"type":"string","format":"date-time","title":"Published At"},"ingested_at":{"type":"string","format":"date-time","title":"Ingested At"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary","description":"AI-generated summary of the publisher's reporting (Growth and Enterprise plans)"},"category":{"anyOf":[{"$ref":"#/components/schemas/CategoryRef"},{"type":"null"}]},"subcategory":{"anyOf":[{"$ref":"#/components/schemas/SubcategoryRef"},{"type":"null"}]},"entities":{"anyOf":[{"items":{"$ref":"#/components/schemas/EntityRef"},"type":"array"},{"type":"null"}],"title":"Entities"},"topics":{"anyOf":[{"items":{"$ref":"#/components/schemas/TopicRef"},"type":"array"},{"type":"null"}],"title":"Topics"},"geography":{"anyOf":[{"$ref":"#/components/schemas/Geography"},{"type":"null"}]},"sentiment":{"anyOf":[{"$ref":"#/components/schemas/Sentiment"},{"type":"null"}]},"event_cluster_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Cluster Id"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content","description":"Full text; only for licensed sources on plans that include it"},"attribution":{"type":"string","title":"Attribution","description":"Required attribution text"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score","description":"Ranking score; see docs for how it is computed for each endpoint"},"match":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Match","description":"Ranking diagnostics (e.g. keyword and semantic ranks for hybrid search)"}},"type":"object","required":["id","slug","title","source","published_at","ingested_at","attribution"],"title":"ScoredArticle"},"Sentiment":{"properties":{"label":{"type":"string","title":"Label"},"score":{"type":"number","title":"Score","description":"Tone of the reporting in [-1, 1]; not a measure of the underlying event"}},"type":"object","required":["label","score"],"title":"Sentiment"},"Source":{"properties":{"id":{"type":"string","title":"Id"},"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"language":{"type":"string","title":"Language"},"country":{"type":"string","title":"Country"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"article_count":{"type":"integer","title":"Article Count"}},"type":"object","required":["id","slug","name","language","country","article_count"],"title":"Source"},"SourceRef":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"url":{"type":"string","title":"Url","description":"Original article URL at the publisher (always link here for attribution)"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"}},"type":"object","required":["id","name","url"],"title":"SourceRef"},"Subcategory":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"category":{"$ref":"#/components/schemas/CategoryRef"}},"type":"object","required":["slug","name","description","category"],"title":"Subcategory"},"SubcategoryRef":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"}},"type":"object","required":["slug","name"],"title":"SubcategoryRef"},"Topic":{"properties":{"id":{"type":"string","title":"Id"},"slug":{"type":"string","title":"Slug"},"label":{"type":"string","title":"Label"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"aliases":{"items":{"type":"string"},"type":"array","title":"Aliases","default":[]},"parent":{"anyOf":[{"$ref":"#/components/schemas/TopicRef"},{"type":"null"}]},"article_count":{"type":"integer","title":"Article Count"}},"type":"object","required":["id","slug","label","article_count"],"title":"Topic"},"TopicRef":{"properties":{"id":{"type":"string","title":"Id"},"label":{"type":"string","title":"Label"},"slug":{"type":"string","title":"Slug"}},"type":"object","required":["id","label","slug"],"title":"TopicRef"}},"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","description":"Your NaijaPress API key"}}},"servers":[{"url":"https://api.naijapress.com"}]}