APITube Reference API
The Reference API from APITube — 7 operation(s) for reference.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/apitube-reference-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: APITube News Reference API
version: 1.0.0
summary: Search and filter news articles from thousands of sources worldwide.
description: 'APITube News API provides programmatic access to a comprehensive, real-time news database aggregated from thousands of sources worldwide. Use it to search, filter, and retrieve news articles with advanced query capabilities.
## Key Endpoints
- **Everything** (`/v1/news/everything`) — full-text search across all indexed articles with filters by title, date range, language, country, source, sentiment, category, topic, industry, and named entities (people, organizations, locations, brands, etc.).
- **Top Headlines** (`/v1/news/top-headlines`) — breaking and trending news from high-authority sources ranked by OPR score.
- **Story** (`/v1/news/story/{articleId}`) — retrieve related articles for a given story.
- **Article** (`/v1/news/article`) — fetch one or more articles by ID.
- **Dictionaries** — list available categories, topics, industries, and entities.
- **Trends** — discover trending topics and entities over time.
- **Stream** (`/v1/news/stream`) — real-time Server-Sent Events (SSE) stream of new articles.
- **Webhooks** — subscribe to push notifications for new articles matching your filters.
## Export Formats
JSON (default), CSV, TSV, XML, RSS, XLSX, Parquet, JSONL, and NDJSON.
## Authentication
All requests require an API key passed via the `X-API-Key` header or the `api_key` query parameter.'
contact:
name: APITube Support
url: https://apitube.io
email: support@apitube.io
termsOfService: https://apitube.io/terms/terms-of-service
servers:
- url: https://api.apitube.io
security:
- ApiKeyHeader: []
- ApiKeyQuery: []
tags:
- name: Reference
paths:
/v1/news/event-types:
get:
summary: List valid event types
tags:
- Reference
description: Returns every valid value for the `event.type` and `event.category` filters. Use `event_types[].code` in the `event.type` / `ignore.event.type` filters and `categories[]` in the `event.category` filter.
responses:
'200':
description: Valid event types and the categories they belong to
content:
application/json:
schema:
description: Valid event types and the categories they belong to
type: object
properties:
status:
type: string
description: ok
categories:
type: array
items:
type: string
description: Valid values for the event.category filter
event_types:
type: array
items:
type: object
properties:
code:
type: string
description: Valid value for the event.type filter
category:
type: string
description: Category this event type belongs to
example:
status: ok
categories:
- business
- society
- environment
event_types:
- code: ipo
category: business
- code: layoffs
category: business
- code: election
category: society
- code: earthquake
category: environment
'401':
description: Authentication error
content:
application/json:
schema:
description: Authentication error
type: object
properties:
status:
type: string
enum:
- not_ok
description: Response status
request_id:
type:
- 'null'
- string
description: Unique request identifier
errors:
type: array
items:
type: object
properties:
status:
type: integer
description: HTTP status code
code:
type: string
description: Error code (e.g. ER0201)
message:
type: string
description: Human-readable error message
links:
type: object
properties:
about:
type: string
description: Link to error documentation
timestamp:
type: string
format: date-time
description: Error timestamp
example:
status: not_ok
request_id: req_abc123def456
errors:
- status: 401
code: ER0201
message: Invalid or missing API key.
links:
about: https://docs.apitube.io/platform/news-api/http-response-codes
timestamp: '2026-03-23T14:30:00Z'
/v1/people:
get:
summary: List & search people
tags:
- Reference
description: Directory of known persons (public figures, politicians, executives) with Wikidata-enriched profiles. Filter by name or Wikidata ID. Pivot to coverage via the `links.articles` URL.
parameters:
- schema:
type: string
in: query
name: name
required: false
description: Filter by person name (substring match).
- schema:
type: string
in: query
name: wikidata_id
required: false
description: Filter by Wikidata ID (e.g. Q317521 or 317521).
- schema:
type: integer
in: query
name: page
required: false
description: Page number (default 1).
- schema:
type: integer
in: query
name: per_page
required: false
description: Results per page (default 100, max 250; the Free plan is capped at 10 and Starter at 50).
responses:
'200':
description: Paginated list of people
content:
application/json:
schema:
description: Paginated list of people
type: object
properties:
status:
type: string
enum:
- ok
limit:
type: integer
description: Results per page
page:
type: integer
description: Current page number
has_next_pages:
type: boolean
description: Whether more pages are available
results:
type: array
items:
type: object
properties:
id:
type: integer
description: Person (entity) ID
name:
type: string
description: Person name
type:
type: string
description: Entity type (person)
links:
type: object
properties:
self:
type: string
description: Link to this reference profile
articles:
type: string
description: Link to articles mentioning this entity
wikipedia:
type: string
description: Wikipedia URL (empty if unknown)
wikidata:
type: string
description: Wikidata URL (empty if unknown)
profile:
type:
- object
- 'null'
description: Wikidata-enriched metadata (varies by entity)
additionalProperties: true
'401':
description: Authentication error
content:
application/json:
schema:
description: Authentication error
type: object
properties:
status:
type: string
enum:
- not_ok
description: Response status
request_id:
type:
- 'null'
- string
description: Unique request identifier
errors:
type: array
items:
type: object
properties:
status:
type: integer
description: HTTP status code
code:
type: string
description: Error code (e.g. ER0201)
message:
type: string
description: Human-readable error message
links:
type: object
properties:
about:
type: string
description: Link to error documentation
timestamp:
type: string
format: date-time
description: Error timestamp
example:
status: not_ok
request_id: req_abc123def456
errors:
- status: 401
code: ER0201
message: Invalid or missing API key.
links:
about: https://docs.apitube.io/platform/news-api/http-response-codes
timestamp: '2026-03-23T14:30:00Z'
/v1/people/{id}:
get:
summary: Get a person profile
tags:
- Reference
description: Returns a single person profile with Wikidata-enriched metadata and links to coverage.
parameters:
- schema:
type: string
in: query
name: coverage
required: false
description: Set to "false" to skip the coverage block (article counts, timeline, top sources/topics).
- schema:
type: integer
in: path
name: id
required: true
description: Person (entity) ID.
responses:
'200':
description: A single person profile
content:
application/json:
schema:
description: A single person profile
type: object
properties:
id:
type: integer
description: Person (entity) ID
name:
type: string
description: Person name
type:
type: string
description: Entity type (person)
links:
type: object
properties:
self:
type: string
description: Link to this reference profile
articles:
type: string
description: Link to articles mentioning this entity
wikipedia:
type: string
description: Wikipedia URL (empty if unknown)
wikidata:
type: string
description: Wikidata URL (empty if unknown)
profile:
type:
- object
- 'null'
description: Wikidata-enriched metadata (varies by entity)
additionalProperties: true
coverage:
type:
- object
- 'null'
description: Aggregated coverage stats (omitted when coverage=false, null on error)
properties:
article_count:
type: integer
description: Total articles in coverage scope
first_seen:
type:
- string
- 'null'
description: Date of the earliest article (YYYY-MM-DD)
last_seen:
type:
- string
- 'null'
description: Date of the latest article (YYYY-MM-DD)
sentiment:
type: object
properties:
positive:
type: integer
neutral:
type: integer
negative:
type: integer
momentum:
type: object
properties:
last_30_days:
type: integer
previous_30_days:
type: integer
change_pct:
type:
- integer
- 'null'
description: Percent change vs previous 30 days
timeline:
type: array
items:
type: object
properties:
period:
type: string
description: Month bucket (YYYY-MM-DD)
count:
type: integer
top_sources:
type: array
items:
type: object
properties:
id:
type: integer
name:
type: string
domain:
type: string
count:
type: integer
top_topics:
type: array
items:
type: object
properties:
id:
type:
- integer
- string
description: Item ID
name:
type: string
count:
type: integer
top_countries:
type: array
items:
type: object
properties:
id:
type: integer
name:
type: string
code:
type: string
count:
type: integer
top_languages:
type: array
items:
type: object
properties:
id:
type: integer
name:
type: string
code:
type: string
count:
type: integer
related_entities:
type: array
items:
type: object
properties:
id:
type:
- integer
- string
description: Item ID
name:
type: string
count:
type: integer
recent_articles:
type: array
description: Up to 5 most recent articles (full article objects)
items:
type: object
properties:
id:
type: integer
description: Unique article ID
href:
type:
- string
- 'null'
description: Original article URL
published_at:
type:
- string
- 'null'
format: date-time
description: Publication date in ISO 8601
title:
type:
- string
- 'null'
description: Article title
description:
type:
- string
- 'null'
description: Article description (plain text)
body:
type:
- string
- 'null'
description: Article body (plain text)
body_html:
type:
- string
- 'null'
description: Article body (HTML)
language:
type: string
description: ISO 639-1 language code
translations:
type: object
description: Machine translations of the article title and description. Always present; fields stay null for English articles and for languages without a translation model
properties:
en:
type: object
properties:
title:
type:
- string
- 'null'
description: Title translated to English
description:
type:
- string
- 'null'
description: Description translated to English (plain text)
author:
type: object
properties:
id:
type:
- integer
- 'null'
description: Author ID
name:
type: string
description: Author name
image:
type: string
description: Main article image URL
categories:
type: array
items:
type: object
properties:
id:
type: integer
description: Category ID
name:
type: string
description: Category name
score:
type: number
description: Relevance score
taxonomy:
type: string
description: Taxonomy identifier
links:
type: object
properties:
self:
type: string
description: Link to category endpoint
topics:
type: array
items:
type: object
properties:
id:
type: string
description: Topic ID
name:
type: string
description: Topic name
score:
type: number
description: Relevance score
links:
type: object
properties:
self:
type: string
description: Link to topic endpoint
industries:
type: array
items:
type: object
properties:
id:
type: integer
description: Industry ID
name:
type: string
description: Industry name
links:
type: object
properties:
self:
type: string
description: Link to industry endpoint
entities:
type: array
items:
type: object
properties:
id:
type: integer
description: Entity ID
name:
type: string
description: Entity name
type:
type: string
enum:
- person
- location
- organization
- brand
- product
- natural-disaster
- disease
- event
- sport
- unknown
description: Entity type
frequency:
type: integer
description: Number of mentions in the article
sentiment:
type: object
description: Sentiment toward this entity (aggregated across its mentions)
properties:
score:
type: number
description: Entity sentiment score from -1 (negative) to 1 (positive)
polarity:
type: string
enum:
- positive
- negative
- neutral
- ''
description: Entity sentiment polarity
mentions:
type: object
description: Per-mention polarity breakdown
properties:
positive:
type: integer
neutral:
type: integer
negative:
type: integer
title:
type: object
properties:
pos:
type: array
items:
type: object
properties:
start:
type: integer
description: Start character offset
end:
type: integer
description: End character offset
description: Mention positions in title
body:
type: object
properties:
pos:
type: array
items:
type: object
properties:
start:
type: integer
description: Start character offset
end:
type: integer
description: End character offset
description: Mention positions in body
links:
type: object
properties:
self:
type: string
description: Link to entity endpoint
wikipedia:
type: string
description: Wikipedia URL
wikidata:
type: string
description: Wikidata URL
metadata:
type: object
description: Additional entity metadata (varies by entity type)
additionalProperties: true
locations_mentioned:
type: array
items:
type: object
properties:
name:
type: string
description: Location name
country:
type: string
description: Country code
lat:
type:
- number
- 'null'
description: Latitude
lng:
type:
- number
- 'null'
description: Longitude
type:
type: string
description: Location type
source:
type: object
properties:
id:
type:
- integer
- 'null'
description: Source ID
domain:
type: string
description: Source domain
home_page_url:
type: string
description: Source home page URL
type:
type: string
description: Source type
bias:
type: string
description: Media bias (left, center, right)
rankings:
type: object
properties:
opr:
type: integer
description: Open PageRank score
location:
type: object
properties:
country_name:
type: string
description: Source country name
country_code:
type: string
description: Source country ISO code
favicon:
type: string
description: Source favicon URL
sentiment:
type: object
properties:
overall:
type: object
properties:
score:
type: number
description: Sentiment score from -1 (negative) to 1 (positive)
polarity:
type: string
enum:
- positive
- negative
- neutral
- ''
description: Sentiment polarity
title:
type: object
properties:
score:
type: number
description: Sentiment score from -1 (negative) to 1 (positive)
polarity:
type: string
enum:
- positive
- negative
- neutral
- ''
description: Sentiment polarity
body:
# --- truncated at 32 KB (121 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/apitube/refs/heads/main/openapi/apitube-reference-api-openapi.yml