How to exclude keywords or sources#

To remove results you don’t want, the APITube News API gives you a family of ignore.* parameters. ignore.title drops any article whose headline contains a keyword, and ignore.source.domain, ignore.source.id and ignore.source.country.code drop specific publishers. Every ignore.* parameter attaches to /v1/news/everything and runs alongside your positive filters, so you can keep what you want and subtract what you don’t in a single request.

curl "https://api.apitube.io/v1/news/everything?title=AI&ignore.title=layoffs,job losses&api_key=YOUR_API_KEY"

You can send the key as a header (X-API-Key: YOUR_API_KEY) instead of the api_key query parameter. The request above keeps AI headlines but removes the layoffs angle.

How to exclude keywords from results#

ignore.title removes any article whose headline contains the word you pass. This request drops celebrity coverage from a general feed:

curl "https://api.apitube.io/v1/news/everything?ignore.title=celebrity&api_key=YOUR_API_KEY"

List several terms separated by commas, and an article is removed if its title contains any of them:

curl "https://api.apitube.io/v1/news/everything?title=AI&ignore.title=layoffs,job losses&api_key=YOUR_API_KEY"

Two details matter. First, ignore.title checks the article title only — it does not scan the body text, so a word that appears deep in the article but not in the headline will not trigger an exclusion. Second, APITube expands the term against its dictionary before excluding, so close word forms of the keyword (for example a plural or singular variant) are caught as well. The value must be between 2 and 100 characters; anything outside that range returns HTTP 400 with error ER0008.

How to exclude specific sources#

Use ignore.source.domain to drop a publisher by its website address, or ignore.source.id to drop it by numeric ID. Both accept a comma-separated list of up to three values. This request keeps every source except two tabloids:

curl "https://api.apitube.io/v1/news/everything?ignore.source.domain=foxnews.com,nypost.com&api_key=YOUR_API_KEY"

Each domain must be a publisher APITube already tracks. An unknown domain returns HTTP 400 with error ER0215, and the whole request stops on the first bad value, so confirm a domain exists before you exclude it. The full rules for source filtering — including how to look a publisher up with /v1/suggest/sources — are in How to filter news by source or domain.

How to exclude every source from a country#

ignore.source.country.code removes all publishers registered in a country. Pass a two-letter country code, up to three at once:

curl "https://api.apitube.io/v1/news/everything?ignore.source.country.code=fr,de&api_key=YOUR_API_KEY"

A code that is not exactly two characters returns error ER0247, and a country code APITube does not recognise returns ER0213 — both HTTP 400.

How to exclude an author#

ignore.author.name removes articles written under a specific byline. List up to three names, separated by commas:

curl "https://api.apitube.io/v1/news/everything?ignore.author.name=John Smith&api_key=YOUR_API_KEY"

The name must match an author APITube tracks; an unknown name returns ER0205, and a name outside the 1–100 character range returns ER0073. For including authors instead of excluding them, see How to filter news by author.

How exclusion combines with the rest of your query#

Every ignore.* parameter is part of the same shared filter chain as the positive filters, so they stack in one request. This pulls English AI news, drops the layoffs angle, and removes one tabloid — all at once:

curl "https://api.apitube.io/v1/news/everything?title=AI&language.code=en&ignore.title=layoffs&ignore.source.domain=nypost.com&api_key=YOUR_API_KEY"

The positive filters (title, language.code) decide what is eligible, and the ignore.* filters subtract from that set. You can read the canonical list of every parameter on the official News API parameter reference.

Common Questions#

• Does ignore.title also search the article body?
• How many values can each ignore parameter take?
• What happens if I exclude a domain APITube doesn’t track?
• Can I include and exclude in the same request?

Does ignore.title also search the article body?#

No. ignore.title matches the article headline only. If a keyword appears in the body of an article but not in its title, that article is still returned. This is the same field the positive title parameter searches, so keyword inclusion and exclusion both operate on the headline.

How many values can each ignore parameter take?#

ignore.source.domain, ignore.source.id, ignore.source.country.code and ignore.author.name each accept up to three comma-separated values; anything beyond the third is silently dropped. ignore.title accepts multiple comma-separated keywords and removes an article if its headline contains any of them.

What happens if I exclude a domain APITube doesn’t track?#

The request fails with HTTP 400 and error ER0215 (source domain name '…' not found), and it stops on the first unrecognised domain. Validate each domain with /v1/suggest/sources before adding it to ignore.source.domain.

Can I include and exclude in the same request?#

Yes. Positive filters like title, source.domain or language.code define the candidate set, and the ignore.* filters remove from it. You can combine any of them — for example keep source.domain=theguardian.com while still applying ignore.title=opinion to skip opinion pieces from that publisher.