How to request a new news source#

To request a new news source, email the APITube team at [email protected] with the website you would like added. APITube reviews the site and replies with the next steps — sources are added per request, so there is no self-serve form to fill in. Before you write, it is worth checking whether the site is already indexed, because APITube already aggregates from a large pool of sources and yours may be covered.

This article shows both halves: how to confirm coverage with the API, and how to send the request if the source is genuinely missing.

How do you request a new source?#

Send a short email to [email protected] naming the website you want indexed. The team reviews the site and gets back to you with the next steps — that review step is why a request is a message to a person, not an instant API call. If you are not sure which address to use, [email protected] is the right one for source requests; [email protected] is the general contact for the account and everything else.

Include the site’s homepage URL so the reviewer can find it quickly. There is no published turnaround time, so treat the reply as the confirmation that the source is (or is not) being added.

How do you check whether APITube already covers a source?#

Before requesting, test the domain against the live index with the source.domain filter on /v1/news/everything. If the domain is indexed you get matching articles back; if it is not indexed, the request fails with HTTP 400 and error ER0214 (source domain name '…' not found). That error is the clearest signal that a site is missing and worth requesting:

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

source.domain accepts up to three comma-separated domains, each 1 to 255 characters (a value outside that range returns ER0057). The mirror parameter ignore.source.domain excludes a domain instead (ER0059 for a bad length). See how to filter news by source or domain for the full filter.

How do you look up a source by name?#

If you know the publisher’s name but not its exact domain, use the autocomplete endpoint /v1/suggest/sources. Pass a prefix and it returns the indexed sources that match by name — a quick way to see whether a publication is already there under a domain you did not expect. A request with no prefix returns error ER0346:

curl "https://api.apitube.io/v1/suggest/sources?prefix=Reuters&api_key=YOUR_API_KEY"

An empty result means nothing in the index matches that name, which — like the ER0214 above — tells you the source is a good candidate to request.

Why might a source not be indexed yet?#

APITube does not index every website automatically; sources are curated, and coverage is built out over time and by request. If a site returns ER0214 or no autocomplete match, it simply has not been added yet — requesting it is exactly how new publications enter the pipeline. To understand how APITube selects and vets the sources it does carry, see how APITube ensures data quality. For the full list of source-related parameters, the official parameters reference is the canonical source.

Common Questions#

• Which email should I use to request a source?
• How do I confirm a source is missing before requesting it?
• Is there a form or dashboard button to add a source?
• Can I request a feature the same way?

Which email should I use to request a source?#

Use [email protected] to request a new news source, and include the website you want added. APITube reviews the site and replies with the next steps. The general account contact is [email protected], but for adding a publication [email protected] is the address that goes to the right place.

How do I confirm a source is missing before requesting it?#

Query the domain with source.domain on /v1/news/everything. Indexed domains return articles; a domain that is not indexed returns HTTP 400 with error ER0214. You can also search by name with GET /v1/suggest/sources?prefix=… — an empty response means no indexed source matches. Either result confirms the site is a valid candidate to request.

Is there a form or dashboard button to add a source?#

No. New sources are added per request by the APITube team, so the process is an email to [email protected] rather than a self-serve form. The team reviews each requested website before it is added to the index.

Can I request a feature the same way?#

Yes. Feature requests and suggestions also go to [email protected] — the same address handles both new-source requests and product feedback. Describe what you need and the team will factor it into their planning.