APITube Documentation
Sign inGet started

Get top headlines with /v1/news/top-headlines ​

Use /v1/news/top-headlines for news from publishers with an Open Page Rank of 5 or above. It supports the shared Filters, counts by field, highlighting and exports. The source-rank requirement always applies.

Each request costs 1 point. Using the prompt parameter adds 2 points for the translation step; prompt requires Basic or above.

Endpoint ​

GET  /v1/news/top-headlines
POST /v1/news/top-headlines

Base URL: https://api.apitube.io. GET and POST return the same results. Put filters in the URL with GET or send them as JSON in the request body with POST.

/v1/news/top-headlines/v1/news/everything
Source poolHigh-authority sources only (source.rank.opr ≥ 5)Every indexed source
Typical useA front page, a breaking-news feedFull-archive research, monitoring, exports
FiltersIdenticalIdentical

To choose your own minimum source rank, use /v1/news/everything with source.rank.opr.min.

Parameters ​

See Filters for all shared search filters, sorting, pagination, field selection and other request options.

Response format ​

The response uses the shared Response format. Read articles from results and original article links from href. See API Response Structure for all fields.

Request examples ​

GET with query filters ​

bash
curl "https://api.apitube.io/v1/news/top-headlines?language.code=en&source.country.code=us&per_page=10&api_key=YOUR_API_KEY"
python
import requests

response = requests.get(
    "https://api.apitube.io/v1/news/top-headlines",
    params={"language.code": "en", "source.country.code": "us", "per_page": 10},
    headers={"X-API-Key": "YOUR_API_KEY"},
)

for article in response.json()["results"]:
    print(article["source"]["domain"], article["title"])
javascript
const params = new URLSearchParams({
  'language.code': 'en',
  'source.country.code': 'us',
  per_page: '10'
});

const response = await fetch(`https://api.apitube.io/v1/news/top-headlines?${params}`, {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await response.json();

console.log(data.results.map(a => a.title));
php
$query = http_build_query([
    'language.code' => 'en',
    'source.country.code' => 'us',
    'per_page' => 10,
    'api_key' => 'YOUR_API_KEY',
]);

$data = json_decode(file_get_contents("https://api.apitube.io/v1/news/top-headlines?$query"), true);

print_r(array_column($data['results'], 'title'));

Headlines for one category ​

bash
curl "https://api.apitube.io/v1/news/top-headlines?category.id=medtop:04000000&language.code=en&api_key=YOUR_API_KEY"

Category IDs come from List of Categories or from /v1/suggest/categories.

Limits ​

The same limits as /v1/news/everything apply: results per page, accessible pages and the 31-day title-search window. See Rate limits and quotas.

Errors ​

Same codes as /v1/news/everything, documented in full in HTTP response codes.