Skip to main content
POST
/
api
/
search
Search articles
curl --request POST \
  --url https://v3-api.newscatcherapi.com/api/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: <api-key>' \
  --data '{
  "q": "\"supply chain\" AND Amazon NOT China",
  "page_size": 1
}'
{
  "status": "<string>",
  "total_hits": 123,
  "page": 123,
  "total_pages": 123,
  "page_size": 123,
  "articles": [],
  "user_input": {}
}

Authorizations

​
x-api-token
string
header
required

Body

application/json
​
q
string
required
Example:
​
search_in
string
default:title_content
Example:
​
include_translation_fields
boolean
default:false
Example:
​
predefined_sources
Example:
​
source_name
Example:
​
sources
Example:
​
not_sources
Example:
​
lang
Example:
​
not_lang
Example:
​
countries
Example:
​
not_countries
Example:
​
not_author_name
Example:
​
from_
default:7 days ago
Example:
​
to_
Example:
​
published_date_precision
enum<string>
Available options:
full,
timezone unknown,
date
Example:
​
by_parse_date
boolean
default:false
Example:
​
sort_by
enum<string>
default:relevancy
Available options:
relevancy,
date,
rank
Example:
​
ranked_only
boolean
default:true
Example:
​
from_rank
integer
default:1
Required range: 1 <= x <= 999999
Example:
​
to_rank
integer
default:999999
Required range: 1 <= x <= 999999
Example:
​
is_headline
boolean
Example:
​
is_opinion
boolean
Example:
​
is_paid_content
boolean
Example:
​
parent_url
Example:
​
all_links
Example:
​
all_domain_links
Example:
​
additional_domain_info
boolean
Example:
​
is_news_domain
boolean
Example:
​
news_domain_type
enum<string>
Available options:
Original Content,
Aggregator,
Press Releases,
Republisher,
Other
Example:
​
news_type
Example:
​
word_count_min
integer
Required range: x >= 0
Example:
​
word_count_max
integer
Required range: x >= 0
Example:
​
page
integer
default:1
Required range: x >= 1
Example:
​
page_size
integer
default:100
Required range: 1 <= x <= 1000
Example:
​
clustering_enabled
boolean
default:false
Example:
​
clustering_variable
enum<string>
default:content
Available options:
content,
title,
summary
Example:
​
clustering_threshold
number
default:0.6
Required range: 0 < x <= 1
Example:
​
include_nlp_data
boolean
default:false
Example:
​
has_nlp
boolean
default:false
Example:
​
theme
Example:
​
not_theme
Example:
​
ORG_entity_name
string
Example:
​
PER_entity_name
string
Example:
​
LOC_entity_name
string
Example:
​
MISC_entity_name
string
Example:
​
title_sentiment_min
number
Required range: -1 <= x <= 1
Example:
​
title_sentiment_max
number
Required range: -1 <= x <= 1
Example:
​
content_sentiment_min
number
Required range: -1 <= x <= 1
Example:
​
content_sentiment_max
number
Required range: -1 <= x <= 1
Example:
​
iptc_tags
Example:
​
not_iptc_tags
Example:
​
iab_tags
Example:
​
not_iab_tags
Example:
​
custom_tags
Example:
​
exclude_duplicates
boolean
Example:
​
robots_compliant
boolean
Example:

Response

  • Search Response
  • Clustered Articles Response
​
status
string
required
​
total_hits
integer
required
​
page
integer
required
​
total_pages
integer
required
​
page_size
integer
required
​
articles
Article Object · object[]
​
user_input
object