POST
/
search
curl --request POST \
  --url https://api.newscatcherapi.com/v2/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "q": "Elon Musk",
  "lang": "en",
  "not_lang": "en",
  "published_date_precision": "full",
  "from": "2021/05/06",
  "to": "2021/05/06",
  "search_in": "title",
  "countries": "US,CA",
  "not_countries": "<string>",
  "topic": "business",
  "sources": "nytimes.com,theguardian.com",
  "not_sources": "<string>",
  "ranked_only": true,
  "from_rank": 499999,
  "to_rank": 499999,
  "sort_by": "rank",
  "page_size": 100,
  "page": 1
}'
{
  "status": "ok",
  "total_hits": 123,
  "page": 123,
  "total_pages": 123,
  "page_size": 123,
  "articles": [
    {
      "title": "<string>",
      "author": "<string>",
      "published_date": "<string>",
      "published_date_precision": "<string>",
      "link": "<string>",
      "clean_url": "<string>",
      "excerpt": "<string>",
      "summary": "<string>",
      "rights": "<string>",
      "rank": 123,
      "topic": "<string>",
      "country": "<string>",
      "language": "<string>",
      "authors": "<string>",
      "is_opinion": true,
      "twitter_account": "<string>",
      "_score": 123,
      "_id": "<string>"
    }
  ],
  "user_input": {
    "q": "Elon Musk",
    "search_in": [
      "<string>"
    ],
    "lang": [
      "<string>"
    ],
    "not_lang": [
      "<string>"
    ],
    "countries": [
      "<string>"
    ],
    "not_countries": [
      "<string>"
    ],
    "from": "<string>",
    "to": "<string>",
    "ranked_only": "<string>",
    "from_rank": 123,
    "to_rank": 123,
    "sort_by": "<string>",
    "page": 123,
    "size": 123,
    "sources": [
      "<string>"
    ],
    "not_sources": [
      "<string>"
    ],
    "topic": "<string>",
    "published_date_precision": "<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

Response

200
application/json
OK

The response for a successful search request.