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.
Article retrieval
Get article content directly.
| Endpoint | Description |
|---|---|
/v1/news/everything | Search all articles with the full filter set. |
/v1/news/raw | Articles before parsing & enrichment (rolling ~24h window) — guide. |
/v1/news/top-headlines | Top headlines. |
/v1/news/article | A single article by Article ID. |
/v1/news/story/{article_id} | A story (cluster of related articles) by Article ID. |
Browse articles by attribute
Get articles filtered by a single taxonomy value.
| Endpoint | Description |
|---|---|
/v1/news/category/{taxonomy}/{category_id} | Articles in a category. |
/v1/news/topic/{topic_id} | Articles for a topic. |
/v1/news/industry/{industry_id} | Articles for an industry. |
/v1/news/entity/{entity_id} | Articles mentioning an entity. |
/v1/news/local | Local news by geo-coordinates or place name. |
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. |
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/sources | Autocomplete sources — guide. |
/v1/suggest/categories | Autocomplete categories — guide. |
/v1/suggest/topics | Autocomplete topics — guide. |
/v1/suggest/industries | Autocomplete industries — guide. |
Real-time delivery
Stream articles in real time as they arrive.
| Endpoint | Description |
|---|---|
/v1/news/stream | Real-time article stream via Server-Sent Events — guide. |
/v1/news/ws | Real-time article stream via WebSocket. |
Analytics & account
| Endpoint | Description |
|---|---|
/v1/news/trends | Trending values for a given field. |
/v1/news/count | Count articles matching filters, without loading content — guide. |
/v1/balance | Check your API key balance. |