How many news sources does APITube cover?#

APITube aggregates news from more than 500,000 sources — the news websites and publishers it crawls worldwide. That is the headline number, but for most projects the useful question is narrower: are the specific publishers I care about covered? Because APITube deliberately does not expose a single “download every source” endpoint, you confirm coverage by probing for the sources you need rather than pulling one giant list.

This page gives you the coverage figure, explains what counts as a source, and shows the three practical ways to check whether a given publisher — or a whole set of them — is in the pool.

How big is the source pool?#

The pool is 500,000+ news websites. A “source” in APITube is one publisher domain that the pipeline discovers and crawls — a site like reuters.com or bbc.co.uk, not an individual article. Each source carries its own metadata: a name, a domain, a type, a political bias label, and an OPR authority rank. Those sources publish across many languages and countries — for the language and country breakdown, see which languages and countries are supported.

Is there an endpoint that lists every source?#

No. There is no directory endpoint that dumps the full source list — a plain /v1/sources route is intentionally not available. With half a million publishers, a list-all call would be unusable anyway. Instead, you filter your search to a specific domain, or aggregate the sources inside a result set with facets. The two sections below cover each approach.

How do I check whether a specific source is covered?#

Filter any search by the exact publisher domain with source.domain. A tracked domain returns that publisher’s articles; a domain APITube does not track fails fast with 400 and error ER0214 (source domain name '…' not found) — so the response itself is a definitive coverage check:

curl "https://api.apitube.io/v1/news/everything?source.domain=bloomberg.com&per_page=1&api_key=YOUR_API_KEY"

You supply the domain yourself (the publisher’s website address); there is no name-based lookup endpoint. Every article that comes back carries a source object with the publisher’s stable numeric id, domain, type, home_page_url and OPR rank — read the id there to switch to source.id filtering, which survives a publisher changing its domain.

How do I restrict a search to specific sources?#

To read several publishers at once, filter with source.domain and pass up to three domains as a comma-separated list:

curl "https://api.apitube.io/v1/news/everything?source.domain=bbc.co.uk,reuters.com&api_key=YOUR_API_KEY"

If any domain you pass is not in the pool, the request fails fast with 400 and error ER0214 (source domain name '…' not found), so one unknown domain blocks the whole call. To go the other direction and exclude sources, use ignore.source.domain. The full filter is documented in how to filter news by source or domain.

How do I see which sources appear in my results?#

To measure the source diversity of a query — how many different publishers cover a topic and which ones dominate — add a facet on source.id. Set facet=true and name the field with facet.field:

curl "https://api.apitube.io/v1/news/everything?title=tesla&facet=true&facet.field=source.id&facet.limit=20&api_key=YOUR_API_KEY"

The response includes a facets block that counts articles per source for that query. facet.limit defaults to 10 and caps at 100, and facet.field is required when facet=true (otherwise ER0310). This turns “how many sources cover this?” into a number you can read straight off a single request.

Common Questions#

• Can I download the full list of sources?
• What counts as one source?
• What if the source I need is not covered?
• How current is the 500,000+ figure?

Can I download the full list of sources?#

No. APITube does not offer a list-all sources endpoint, so there is no single call that returns all 500,000+ publishers. The supported pattern is to check the publishers you need with the source.domain filter — a tracked domain returns articles, an unknown one returns ER0214 — and filter searches to them. If you want to profile the sources behind a topic instead of a fixed list, facet a search on source.id and read the per-source counts.

What counts as one source?#

One source is one publisher domain that APITube crawls — a website such as reuters.com, counted once regardless of how many articles it publishes. Each source has a stable id, a domain, a resource type, and an OPR authority rank, which you can read from the source object on any returned article or use as search filters (source.id, source.domain).

What if the source I need is not covered?#

If source.domain rejects the domain with ER0214, the publisher is not yet in the pool — but you can ask for it to be added. See how to request a new news source. New sources are added over time, so a domain that is missing today may be covered later.

How current is the 500,000+ figure?#

500,000+ is the coverage figure APITube publishes, and the pool grows as new publishers are discovered, so treat it as a floor rather than a fixed cap. Because coverage changes, the reliable check for any single project is always to probe the exact publishers you need with the source.domain filter rather than rely on a headline count.