Learn to use different techniques when searching for a proper noun
"
) in q
parameter"
) for the exact match.
Example of the search intent
I am looking for articles about Elon Musk.
Query to do it
When you want to search for articles that mention Elon Musk
you should do the
following query:
If you write q=Elon Musk
then, it will be treated as q=Elon AND Musk
. In
that case, every article that mentions both elon
and musk
somewhere in the
text will match.
q
parameter to search with more context-related articlesAND
AND
operator makes tokens from both sides to be present in the text of an
article.
AND
is the default operator. When your **q**
input is more than 1 word,
**AND**
operator is added between each word behind the scenes.
Example of the search intent
I am looking for articles where all three Apple, Microsoft, and Tesla
company names are mentioned
Query to do it
AND
is the default operator, these two queries are exactly the same:
q=Apple AND Microsoft AND Tesla
q=Apple Microsoft Tesla
OR
OR
operator means that either the left or the right sides of OR
have to
be satisfied.
Example of the search intent
I am looking for an article where at least one of these wealthy men
Elon Musk, Tim Cook, Bill Gates is mentioned.
Query to do it
()
AND
and OR
operators can be used together. You can also logically group a
set of words or phrases by using round brackets ()
Example of the search intent
I am looking for articles where either Elon Musk is mentioned with
either Starlink or Tesla.
Query to do it
NOT
NOT
operator when you want the token from its right to not be present.
Example of the search intent
I am looking for articles about Apple and MacBook product series, but I do not
want any news related to iPhone or IPad
Query to do it
[sources]
[sources]
parameter to filter down your search to the articles coming only
from mentioned news sources.
Example of the search intent
I am looking for business-related articles about “Elon Musk”. Personally, I
have already seen relevant news coming from businessinsuder.com,
businessjournaldaily.com, businessreport.com. I want to have articles only from
these sources.
Parameters to use
[not_sources]
[not_sources]
parameter to exclude concrete news domains from your search.
Example of the search intent
I am looking for business-related articles about “Elon Musk”. I am not aware of
any business-related news source. But, I am sure that news coming from
gossipbucket.com, hollywoodlife.com, or hollywoodreporter.com is not the type of
news I would like to get. So I exclude these news domains.
Parameters to use
/v2/sources
endpoint/v2/sources
endpoint to get a list of news sources available in our
database. So, this can give you a hint of where to look for. On
this page, you
will find more info about this endpoint.
Example of the search intent
I would like to search for “Elon Musk” in business-related news sources. But I
do not know any business-oriented source.
Make a call with /v2/sources
endpoint
Check the Quickstart guide to know
how to make a call.
/v2/sources
endpoint the list of news sources is sorted by the number of
articles for the last 24 hours.
to_rank
Or from_rank
To Vary From Global News Sources To More Local Oncerank
parameter is based on the
Majestic Million Rank system.
The smaller the rank, the more popular the news domain. The “popularity” is
measured by the number of backlinks and referrers on the web. Some examples of
ranks:
ranked_only
parameter is set to True
. It means that if a news
domain is not in the Majestic List, we will attribute the value 999,999 to this
domain. If you want to get articles from these unranked domains, you should set
ranked_only=False
team@newscatcherapi.com
.