Skip to main content

Documentation Index

Fetch the complete documentation index at: https://newscatcherinc-docs.mintlify.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

News API lets you find articles that mention specific URLs or domains using two dedicated parameters:
ParameterWhat it matches
all_linksArticles containing a specific full URL — for example, a particular report or article page
all_domain_linksArticles containing any URL from a specific domain — for example, all mentions of nvidia.com
URL-based search is available on the following endpoints:
  • /search
  • /latest_headlines
  • /authors
  • /aggregation_count
In GET requests, specify multiple URLs or domains as comma-separated strings. POST requests support both comma-separated strings and arrays.

​
Before you begin

Make sure you have the following:
  • An active News API key
  • The Newscatcher SDK installed for your language, or cURL for quick testing

​
Steps

1

Make a URL-based search request

This example finds English-language articles about AI that mention the NVIDIA website:
curl -X POST "https://v3-api.newscatcherapi.com/api/search" \
  -H "x-api-token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "AI",
    "all_domain_links": "nvidia.com",
    "lang": "en"
  }'
2

Review the response

The response includes the standard article fields plus all_links and all_domain_links arrays showing every URL mentioned in each article:
{
  "status": "ok",
  "total_hits": 264,
  "page": 1,
  "total_pages": 3,
  "page_size": 100,
  "articles": [
    {
      "title": "NVIDIA 'Powering Advanced AI' Is The New Tagline For GeForce RTX GPUs",
      "author": "Hassan Mujtaba",
      "published_date": "2024-09-02",
      "link": "https://wccftech.com/nvidia-powering-advanced-ai-new-tagline-geforce-rtx-gpus",
      "domain_url": "wccftech.com",
      "all_links": [
        "https://www.nvidia.com",
        "https://www.amazon.com/dp/B082L36ZRY"
      ],
      "all_domain_links": [
        "nvidia.com",
        "youtube.com",
        "techpowerup.com"
      ]
    }
  ]
}
3

Refine with advanced queries

Combine URL parameters with keywords, date ranges, and other filters for more targeted searches:
{
  "q": "AI report",
  "all_links": [
    "https://aiindex.stanford.edu/report/",
    "https://www.stateof.ai/",
    "https://www2.deloitte.com/us/en/pages/consulting/articles/state-of-generative-ai-in-enterprise.html"
  ],
  "from_": "2024-01-01",
  "lang": "en"
}

{
  "q": "AI AND (healthcare OR medicine)",
  "all_domain_links": ["who.int", "nih.gov"],
  "all_links": ["https://www.nature.com/articles/s41591-023-02448-8"],
  "lang": "en",
  "from_": "2024-01-01"
}

{
  "q": "AI regulation",
  "all_domain_links": ["europa.eu", "whitehouse.gov", "gov.uk"],
  "lang": "en",
  "from_": "2024-01-01"
}

​
Best practices

  • Use all_links to find mentions of specific pages or articles.
  • Use all_domain_links to track mentions of a website regardless of the specific page.
  • Combine URL search with date ranges to focus on recent coverage or track changes over time.
  • Add keyword filters to narrow down broad domain searches that return too many results.

​
See also