APITube Documentation
Sign inGet started

Glossary ​

Definitions of the terms used in the News API documentation.

News API ​

The APITube News API gives you access to articles from more than 300,000 verified sources worldwide. Each article includes fields such as language, category, topic, industry, entities, sentiment and publisher details. Use these fields to search and analyse news.

API key ​

Your API key gives you access to the News API. Get it from your APITube account and include it in every request, either in the X-API-Key header or the api_key URL parameter.

Bearer token ​

You can send your API key in the Authorization: Bearer YOUR_API_KEY header. This works as an alternative to the X-API-Key header or a URL parameter.

Endpoint ​

An endpoint is a URL path for a specific API operation. For example, /v1/news/everything searches articles, /v1/news/top-headlines returns headlines, /v1/news/story finds related articles, and /v1/news/article looks up articles by ID. Other endpoints include /v1/news/trends, /v1/news/stream, /v1/suggest/* and /v1/balance.

Article ​

An article is one news item in the API response. It includes a title, body, URL, publication date, author, language and source details. Use its unique article ID to fetch it again or find related articles.

Story ​

A story is a group of articles about the same event. Pass an article ID to /v1/news/story to find related coverage from other publishers or keep one article per event in your feed.

Entity ​

An entity is a person, place, organization, brand, product, disaster, disease, event or sport mentioned in an article. Each has an entity.id, an entity.type and a Wikidata ID. Use entity filters to search for a specific subject.

Sentiment ​

Sentiment describes the tone of an article. sentiment.overall.polarity is positive, negative or neutral. sentiment.overall.score gives a numeric score. You can filter and sort articles by these values.

Category ​

A category groups articles by subject using IPTC Media Topics. Use category.id with a medtop: code, such as medtop:04000000 for finance.

Topic ​

A topic is a specific subject, such as cryptocurrency, green energy or artificial intelligence. Use topic.id, for example industry.crypto_news, to search for it.

Industry ​

An industry is the business sector an article relates to, such as technology, healthcare or energy. Use industry.id to follow news about that sector.

Source ​

A source is the publisher or website behind an article. Use source.id, source.domain or source.country.code to include or exclude publishers.

Source rank ​

Source rank measures a publisher's domain authority using Open Page Rank. The response field is source.rankings.opr; the filter is source.rank.opr.min. A higher value means a higher-ranked source.

The /v1/news/trends endpoint counts how often entities, categories, topics, industries or sources appear in matching articles. Use it to rank common subjects, see growth or compare periods.

Pagination ​

Pagination splits results into pages. per_page sets the number of items in a response, and offset sets how many to skip. Request pages in sequence to work through larger result sets.

Sort order ​

Use sort.by to choose a field, such as published_at or sentiment.overall.score. Set sort.order to asc for ascending order or desc for descending order.

Language code ​

Use a two-letter language.code, such as en for English. Codes follow ISO 639-1, with Belarusian using by instead of be. The directory also includes un for undetermined language. Send up to three codes separated by commas to match any of them. See the list of languages.

Credit and balance ​

Credits pay for API requests. Check /v1/balance to see the remaining credits for your API key.

Rate limit ​

Your rate limit sets how many requests you can send in a time window. Check X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset in responses to stay within the limit.

SSE stream ​

Server-Sent Events (SSE) deliver new matching articles over one open HTTP connection at /v1/news/stream. You receive articles as they become available without repeatedly checking the API.

Reference endpoints ​

Search profiles of people, companies and journalists with /v1/people, /v1/companies and /v1/journalists. Each profile includes background details, a coverage summary and recent articles.

Coverage ​

The coverage object summarises news about a person or company. It includes article counts, first and last mention dates, sentiment, a monthly timeline, momentum, and top sources, topics, countries, languages and related entities.

Momentum ​

Momentum compares mentions in the last 30 days with the previous 30 days. change_pct shows the percentage increase or decrease.

The related_entities field lists people, companies and other subjects often mentioned alongside the profile's subject. For example, it can show a company's partners or competitors.

Open PageRank (OPR) ​

Open PageRank is a domain authority score from 0 to 10. Read it from source.rankings.opr in article responses, and filter with source.rank.opr.min. It is the score used for source rank.

Journalist name matching ​

A journalist record groups bylines with the same name and lists their outlets. Different people with the same name, or generic bylines such as admin, may appear in one record.