What is APITube News API?#

APITube News API is a REST API that returns news articles as structured JSON over HTTPS. You send an HTTP request with your API key, optionally narrow it with filters, and get back ready-to-use article objects — each enriched with the language, sentiment, named entities and topic labels that APITube adds automatically. There is no scraping, no HTML parsing and no feed wrangling on your side: the data arrives clean and machine-readable.

In one sentence: it turns the world’s news into a queryable, filterable dataset you reach with a single HTTP call. The rest of this article covers what the data contains, what you can do with it, and how you get it out.

What does the APITube News API do?#

The APITube News API collects articles from across the web, processes each one, and serves the result through a single HTTP base URL, https://api.apitube.io. Every endpoint speaks JSON and authenticates with an API key, so any language or tool that can make an HTTP request can use it — curl, a browser, a backend service, a spreadsheet, or an AI assistant.

A request to the main search endpoint returns a JSON envelope: a status, a results array of article objects, paging fields (page, has_next_pages, next_page), a request_id, and an export block of links that re-run the same query in other formats. You read the results array and you have the news. To see this end to end, follow how to run your first news search.

What data does each article include?#

Each article is a rich object, not just a headline and a link. Alongside the title, body, URL, publish date and source, APITube attaches the enrichment it computes for every article:

• Language — the detected language code of the text.
• Sentiment — an overall positive/neutral/negative reading, and sentiment toward individual entities.
• Entities — the people, organizations, locations, products and other names mentioned, with their positions in the text.
• Classification — category, topic and industry labels.
• Source and media metadata — the publisher, plus images and other media attached to the article.

For a field-by-field tour of an article object, see what’s inside a news article; for the vocabulary used across the API — articles, sources, entities, stories — see key concepts.

What can you do with the API?#

The API is a family of endpoints, all under the same base URL and key. The main groups are:

• Search — /v1/news/everything queries the whole index with filters for keyword, language, country, date, source, sentiment, entities and more.
• Headlines and local — /v1/news/top-headlines for the day’s leading stories and /v1/news/local for geo-targeted news.
• Single items — /v1/news/article for one article, /v1/news/story/:id for every article covering the same story, and /v1/news/raw for the raw body and HTML.
• Counting and trends — /v1/news/count returns how many articles match without downloading them, and /v1/news/trends surfaces trending topics and entities over time.
• Directories and lookups — /v1/people, /v1/companies and /v1/journalists profiles, plus /v1/suggest/* autocomplete for entities, sources, categories, topics and industries.
• Fact-checking — /v1/fact-check checks a claim against the news index.

Because every news query accepts the same filter parameters, you learn the filters once and reuse them across endpoints.

How do you get the data out?#

APITube delivers news three ways, so you can pull, stream or be pushed to:

• Pull (REST + exports). Request data on demand. Beyond JSON, a search can be returned as CSV, TSV, XML, RSS, XLSX, Parquet or JSONL — useful for spreadsheets, RSS readers and data pipelines alike.
• Real-time streaming. Subscribe to a live feed over Server-Sent Events (/v1/news/stream) or WebSocket and receive matching articles as they are indexed.
• Webhooks. Have APITube push new matching articles to your own URL, so your system reacts without polling.

You authenticate the same way on all of them: send your key as an Authorization: Bearer token, an X-API-Key header, or an api_key query parameter.

How do you start using it?#

Three steps: create an account, copy your API key from the dashboard, and send a request. A first call needs nothing but the endpoint and your key:

curl "https://api.apitube.io/v1/news/everything" \
  -H "X-API-Key: YOUR_API_KEY"

That returns the latest news, newest first. From there you add filters to narrow it. The complete list of parameters lives in the official News API parameter reference.

Common Questions#

• Is APITube News API a REST API?
• What formats can I receive news in?
• Do I need an API key to use it?
• Is the data real-time?

Is APITube News API a REST API?#

Yes. It is an HTTP REST API served from https://api.apitube.io. You make standard GET or POST requests, pass your filters as query-string parameters or a JSON body, and receive a JSON response. No SDK is required — any HTTP client works — though official client libraries exist to make it more convenient.

What formats can I receive news in?#

JSON is the default. The same search can also be returned as CSV, TSV, XML, RSS, XLSX (Excel), Parquet or JSONL by changing the export format, so the API fits spreadsheets, RSS readers and data pipelines without extra conversion on your side.

Do I need an API key to use it?#

Yes. Almost every endpoint requires a valid API key, sent as an Authorization: Bearer token, an X-API-Key header, or an api_key query parameter. You create a key in your APITube dashboard. A request with no key — or an invalid one — is rejected with a 401 before any work is done.

Is the data real-time?#

It can be. As well as on-demand REST requests, APITube offers a live Server-Sent Events stream and a WebSocket feed that push matching articles as they are indexed, plus webhooks that deliver new articles to a URL you control. Choose pull for periodic jobs and streaming or webhooks when you need news the moment it arrives.