POST
/
sources
Get top news sources
curl --request POST \
  --url https://api.newscatcherapi.com/v2/sources \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "lang": "en",
  "countries": "US,CA",
  "topic": "business"
}'
{
  "message": "<string>",
  "sources": [
    "<string>"
  ],
  "user_input": {
    "lang": [
      "<string>"
    ],
    "countries": [
      "<string>"
    ],
    "topic": "<string>"
  }
}

Authorizations

​
x-api-key
string
header
required

API Key to authenticate requests.

To access the API, include your API key in the x-api-key header. To obtain your API key, complete the form or contact us directly.

Body

application/json
​
lang
enum<string>

The language you want to search in.

Available options:
af,
ar,
bg,
bn,
ca,
cn,
cs,
cy,
da,
de,
el,
en,
es,
et,
fa,
fi,
fr,
gu,
he,
hi,
hr,
hu,
id,
it,
ja,
kn,
ko,
lt,
lv,
mk,
ml,
mr,
ne,
nl,
no,
pa,
pl,
pt,
ro,
ru,
sk,
sl,
so,
sq,
sv,
sw,
ta,
te,
th,
tl,
tr,
tw,
uk,
ur,
vi
Example:

"en"

​
countries
string

The countries where the news publisher is located, using the ISO 3166-1 alpha-2 format. Multiple countries can be specified, separated by commas.

Example:

"US,CA"

​
topic
enum<string>

The topic to restrict the articles to.

Available options:
news,
sport,
tech,
world,
finance,
politics,
business,
economics,
entertainment,
beauty,
travel,
music,
food,
science,
gaming
Example:

"business"

Response

OK

The response for a successful sources request.

​
message
string

The message of the response.

​
sources
string[] | null

A list of items. The list of sources returned by the request.

​
user_input
object

The user input for a sources request.