Unique categories, entities, and regions for filtering articles
List article category topics
Discover valid values for the categories filter on article endpoints.
Returns a paginated array of unique topic labels extracted from indexed articles (e.g. "Artificial Intelligence", "Cybersecurity", "Politics").
When to use: call before searchArticles or feed endpoints when you need exact, case-sensitive category strings.
Related tools: listEntities, listRegions, searchArticles.
Pagination: use offset to walk the full catalog when limit < total count.
query Parameters
limitPage size. Default 16, max 128.
offsetNumber of items to skip. Default 0.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
List article category topics › Responses
JSON array of category label strings
List named entities
Discover valid values for the entities filter on article endpoints.
Returns a paginated array of unique named entities (people, organizations, products, places) extracted via NLP from article text.
When to use: call before searchArticles when filtering by specific people, companies, or places with exact spelling.
Related tools: listCategories, listRegions, searchArticles.
query Parameters
limitPage size. Default 16, max 128.
offsetNumber of items to skip. Default 0.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
List named entities › Responses
JSON array of entity label strings
List geographic regions
Discover valid values for the regions filter on article endpoints.
Returns a paginated array of unique geographic region labels (e.g. "North America", "Europe", "India", "Middle East").
When to use: call before searchArticles when filtering by geography with exact, case-sensitive region strings.
Related tools: listCategories, listEntities, searchArticles.
query Parameters
limitPage size. Default 16, max 128.
offsetNumber of items to skip. Default 0.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
List geographic regions › Responses
JSON array of region label strings