Endpoints for News API

Send requests to https://api.apitube.io with your API key in the X-API-Key header or api_key parameter. Find an endpoint by task below.

Each guide lists the endpoint's parameters, request examples and response format.

Which endpoint do I need?

What you need	Use this	Notes
Search or monitor the news	Search articles	The full filter set. Every other article endpoint is a narrowed version of it.
A front page or breaking-news feed	Top headlines	Same filters, restricted to highly ranked sources.
Everything about one category, topic, industry or entity	Browse endpoints	Put the category, topic, industry or entity ID in the URL path.
One article, or up to 100, by ID	Get an article by ID	Lookup by ID; no search.
Every outlet that covered the same event	Get a story	Cluster of articles related to one article.
Only a number, not the articles	Count articles	Same filters, returns just the total.
A ranking of who or what is being talked about	Trends	Aggregates instead of returning articles.
News near a point on the map	Local news	Adds geo search, distance sorting and local insights.
Verify a claim against the archive	Fact check	Paid plans only, separate rate limit.
Find the ID for a name	Suggest endpoints	Suggest names as a user types: entities, categories, topics and industries.
The earliest available articles in a basic format	Raw articles (Lite)	No detected language, entities or sentiment. Covers roughly the last 24 hours.

Browse articles by attribute

Get articles in one category, topic or industry, or about one entity.

Endpoint	Description
/v1/news/category/{taxonomy}/{category_id}	Articles in a category — guide.
/v1/news/topic/{topic_id}	Articles for a topic — guide.
/v1/news/industry/{industry_id}	Articles for an industry — guide.
/v1/news/entity/{entity_id}	Articles mentioning an entity — guide.
/v1/news/local	Local news by geo-coordinates or place name — guide.

Reference directories

Search profiles of people, companies and journalists. Each profile includes a coverage summary and recent articles.

Endpoint	Description
/v1/people · /v1/people/{id}	People (public figures) — guide.
/v1/companies · /v1/companies/{id}	Companies & brands — guide.
/v1/journalists · /v1/journalists/{id}	Journalists (bylines) — guide.

Reference lists

Get the list of allowed filter values from the API.

Endpoint	Description
/v1/news/event-types	Valid values for the event.type and event.category filters — guide.

Autocomplete (Suggest)

Suggest matches as a user types, then use the selected id in a filter.

Endpoint	Description
/v1/suggest/entities	Autocomplete entities — guide.
/v1/suggest/categories	Autocomplete categories — guide.
/v1/suggest/topics	Autocomplete topics — guide.
/v1/suggest/industries	Autocomplete industries — guide.