Endpoints for News API
All endpoints are served over HTTPS from the base URL https://api.apitube.io and require a valid API key (via the X-API-Key header or the api_key query parameter). Endpoints are grouped below by purpose.
Each endpoint has its own page with the complete list of parameters it accepts, request examples and its response shape — follow the guide link in the tables below.
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 high-authority sources. |
| Everything about one category, topic, industry or entity | Browse endpoints | The taxonomy value goes in the path instead of a filter. |
| 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 corpus | Fact check | Paid plans only, separate rate limit. |
| Resolve a name to an ID for filtering | Suggest endpoints | Typeahead over entities, categories, topics, industries. |
| Articles the moment they are discovered, unparsed | Raw articles (Lite) | Discovery stage, no enrichment; rolling ~24h window. |
Browse articles by attribute
Get articles filtered by a single taxonomy value.
| 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
Searchable directories of the entities behind the news — each profile includes a coverage block 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
Static lookup lists for filter values — fetch the allowed values programmatically.
| Endpoint | Description |
|---|---|
/v1/news/event-types | Valid values for the event.type and event.category filters — guide. |
Autocomplete (Suggest)
Typeahead search for building filter UIs; each id maps to the matching 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. |