NewsCatcher API Documentation

# NewsCatcher API Documentation > Enterprise APIs for web search, news, and local news data. Three products: CatchAll (Web Search API) for recall-first structured event extraction from 50,000+ web pages per job; News API for 120,000+ source news search with NLP enrichment, clustering, and deduplication; Local News API for hyper-local news with intelligent geographic detection and filtering. - [NewsCatcher documentation](https://www.newscatcherapi.com/docs/home/index): Enterprise APIs for web search, news and local news data ## Web Search API ### Get started - [Meet CatchAll: Our recall-first web search API](https://www.newscatcherapi.com/docs/web-search-api/get-started/introduction): Find all results, not just top candidates - [CatchAll API quickstart guide](https://www.newscatcherapi.com/docs/web-search-api/get-started/quickstart): Get started with CatchAll API. - [CatchAll API changelog](https://www.newscatcherapi.com/docs/web-search-api/get-started/changelog): Track updates, improvements, and fixes to the CatchAll API. ### Guides and concepts - [Jobs](https://www.newscatcherapi.com/docs/web-search-api/guides-and-concepts/jobs): How CatchAll jobs work and how to move from query to results. - [Monitors](https://www.newscatcherapi.com/docs/web-search-api/guides-and-concepts/monitors): Schedule recurring CatchAll jobs with webhook notifications. - [Understanding web index and search depth](https://www.newscatcherapi.com/docs/web-search-api/guides-and-concepts/index-and-search-depth): How CatchAll's web index works and what start_date and end_date actually control. - [Working with dynamic schemas](https://www.newscatcherapi.com/docs/web-search-api/guides-and-concepts/dynamic-schemas): Build integrations that handle variable field names and structures. ### How to - [Write effective queries](https://www.newscatcherapi.com/docs/web-search-api/how-to/write-effective-queries): Construct queries that produce high-quality event records. - [Configure monitors](https://www.newscatcherapi.com/docs/web-search-api/how-to/configure-monitors): Configure reliable, efficient monitors and optimize performance. - [Troubleshoot monitors](https://www.newscatcherapi.com/docs/web-search-api/how-to/troubleshoot-monitors): Diagnose and fix common monitor issues. ### API Reference — Jobs - [Initialize Job](https://www.newscatcherapi.com/docs/web-search-api/api-reference/jobs/initialize-job): Get suggested validators, enrichments, and date ranges for a query. - [Create Job](https://www.newscatcherapi.com/docs/web-search-api/api-reference/jobs/create-job): Submit a query to create a new processing job. - [Continue Job](https://www.newscatcherapi.com/docs/web-search-api/api-reference/jobs/continue-job): Continue an existing job to process more records beyond the initial limit. - [List User Jobs](https://www.newscatcherapi.com/docs/web-search-api/api-reference/jobs/list-user-jobs): Returns all jobs created by the authenticated user. - [Get Job Status](https://www.newscatcherapi.com/docs/web-search-api/api-reference/jobs/get-job-status): Retrieve the current processing status of a job. - [Get Job Results](https://www.newscatcherapi.com/docs/web-search-api/api-reference/jobs/get-job-results): Retrieve the final results for a completed job. - [Company enrichment](https://www.newscatcherapi.com/docs/web-search-api/api-reference/jobs/company-enrichment-dto): Data model for enrichment fields of type company. ### API Reference — Monitors - [Create Monitor](https://www.newscatcherapi.com/docs/web-search-api/api-reference/monitors/create-monitor): Create a scheduled monitor based on a reference job. - [Update Monitor](https://www.newscatcherapi.com/docs/web-search-api/api-reference/monitors/update-monitor): Update the webhook configuration for an existing monitor. - [List Monitors](https://www.newscatcherapi.com/docs/web-search-api/api-reference/monitors/list-monitors): Returns all monitors created by the authenticated user. - [List Monitor Jobs](https://www.newscatcherapi.com/docs/web-search-api/api-reference/monitors/list-monitor-jobs): Return all jobs executed by a monitor. - [Get Monitor Results](https://www.newscatcherapi.com/docs/web-search-api/api-reference/monitors/get-monitor-results): Retrieve aggregated results from all jobs executed by a monitor. - [Enable Monitor](https://www.newscatcherapi.com/docs/web-search-api/api-reference/monitors/enable-monitor): Resume scheduled job execution for a monitor. - [Disable Monitor](https://www.newscatcherapi.com/docs/web-search-api/api-reference/monitors/disable-monitor): Stop scheduled job execution for a monitor. - [Webhook payload](https://www.newscatcherapi.com/docs/web-search-api/api-reference/monitors/webhook-payload): Data model for a payload sent to the webhook URL when a monitor job completes. ### API Reference — Meta - [Health](https://www.newscatcherapi.com/docs/web-search-api/api-reference/meta/health): Check API availability. - [Version](https://www.newscatcherapi.com/docs/web-search-api/api-reference/meta/version): Returns current API version. - [Get Plan Limits](https://www.newscatcherapi.com/docs/web-search-api/api-reference/meta/get-plan-limits): Returns plan features and current usage for the authenticated organization. ### Libraries - [Python SDK](https://www.newscatcherapi.com/docs/web-search-api/libraries/python): Python client library for CatchAll API - [TypeScript SDK](https://www.newscatcherapi.com/docs/web-search-api/libraries/typescript): TypeScript client library for CatchAll API - [Java SDK](https://www.newscatcherapi.com/docs/web-search-api/libraries/java): Java client library for CatchAll API ### Integrations - [CatchAll MCP server](https://www.newscatcherapi.com/docs/web-search-api/integrations/mcp): Connect CatchAll to any MCP-compatible client for structured web research. - [Claude integration](https://www.newscatcherapi.com/docs/web-search-api/integrations/claude): Use CatchAll in Claude with MCP for chat-based research or the Python SDK for programmatic workflows. - [CatchAll API SKILL](https://www.newscatcherapi.com/docs/web-search-api/integrations/skill): Use the CatchAll API SKILL to teach any AI agent how to search, validate, and extract structured data from the web. - [LangChain integration](https://www.newscatcherapi.com/docs/web-search-api/integrations/langchain): Use CatchAll with LangChain for AI-powered web research - [Make.com Integration](https://www.newscatcherapi.com/docs/web-search-api/integrations/make): Use CatchAll in your Make.com scenarios - [n8n Integration](https://www.newscatcherapi.com/docs/web-search-api/integrations/n8n): Use CatchAll in your n8n automations - [Apify integration](https://www.newscatcherapi.com/docs/web-search-api/integrations/apify): Use CatchAll in your Apify workflows. ## News API ### Get started - [Introduction to News API](https://www.newscatcherapi.com/docs/news-api/get-started/introduction): Discover NewsCatcher News API, an enterprise-level solution for large-scale news data retrieval and analysis. - [News API quickstart guide](https://www.newscatcherapi.com/docs/news-api/get-started/quickstart): This guide will help you make your first API call to NewsCatcher News API and start retrieving news data in just a few minutes. - [Libraries](https://www.newscatcherapi.com/docs/news-api/get-started/libraries): News API SDKs - [News API subscription plans](https://www.newscatcherapi.com/docs/news-api/get-started/subscription-plans): Select a News API plan that matches your needs ### Guides and concepts - [Advanced querying techniques](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/advanced-querying): Master advanced querying techniques to enhance the precision and relevance of your searches - [Clustering news articles](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/clustering-news-articles): Group similar articles together to reduce noise and gain insights - [Articles deduplication](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/articles-deduplication): Enhance search efficiency by filtering out duplicate articles. - [NLP features in News API](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/nlp-features): Familiarize yourself with the NLP features available in News API - [Custom tags](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/custom-tags): Filter and classify news articles using your organization's unique taxonomy. - [Entity disambiguation](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/entity-disambiguation): Cut through the clutter with precision - ensure every article pinpoints the exact company or individual you're tracking. - [Breaking news (beta)](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/breaking-news): Learn about breaking news detection and how to access emerging stories through the News API - [Robots.txt compliance](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/robots-txt-compliance): Understand robots.txt compliance fields and parameters in News API to build applications that respect publisher permissions. - [Working with historical data](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/working-with-historical-data): Learn how to efficiently query historical data in News API while maintaining performance and avoiding common pitfalls. ### How to - [How to use boolean operators](https://www.newscatcherapi.com/docs/news-api/how-to/use-boolean-operators): Refine queries with AND, OR, and NOT - [Proximity search with NEAR](https://www.newscatcherapi.com/docs/news-api/how-to/search-with-near): Find articles with related terms in close proximity - [How to search articles by entity](https://www.newscatcherapi.com/docs/news-api/how-to/search-by-entity): Find articles mentioning specific people, organizations, locations, or other named entities - [How to search articles by URL](https://www.newscatcherapi.com/docs/news-api/how-to/search-by-url): Find articles that mention specific URLs or domains using News API - [Search in translations](https://www.newscatcherapi.com/docs/news-api/how-to/search-in-translations): Learn how to search within translated articles and retrieve translated content from News API - [How to paginate large datasets](https://www.newscatcherapi.com/docs/news-api/how-to/paginate-large-datasets): Efficiently retrieve and process large volumes of news data using pagination in News API - [How to retrieve more than 10,000 articles](https://www.newscatcherapi.com/docs/news-api/how-to/retrieve-more-than-10k-articles): Learn how to use time-chunking methods in the Python SDK to retrieve large volumes of articles - [How to check sources coverage](https://www.newscatcherapi.com/docs/news-api/how-to/check-sources-coverage): Learn how to verify the news sources covered by News API - [Validate queries with Python SDK](https://www.newscatcherapi.com/docs/news-api/how-to/validate-queries-python-sdk): Use client-side query validation to catch syntax errors before making API calls ### Troubleshooting - [Interpret and handle API errors](https://www.newscatcherapi.com/docs/news-api/troubleshooting/error-handling): Understand and resolve common API errors - [Request tracing with correlation IDs](https://www.newscatcherapi.com/docs/news-api/troubleshooting/request-tracing-correlation-ids): Learn how to use correlation IDs to debug and troubleshoot API requests - [Report bugs](https://www.newscatcherapi.com/docs/news-api/troubleshooting/report-bugs): How to report bugs and issues with the NewsCatcher APIs ### API Reference - [News API overview](https://www.newscatcherapi.com/docs/news-api/api-reference/overview): Technical reference for News API endpoints, authentication, and data structures. - [Authentication](https://www.newscatcherapi.com/docs/news-api/api-reference/authentication): Learn how to authenticate your API request - [Rate limits and quotas](https://www.newscatcherapi.com/docs/news-api/api-reference/rate-limits): Rate limits and quota management for News API usage - [Errors](https://www.newscatcherapi.com/docs/news-api/api-reference/errors): Quick reference guide for common errors in News API - [HTTP headers](https://www.newscatcherapi.com/docs/news-api/api-reference/http-headers): Understanding request and response headers in the NewsCatcher APIs - [Enumerated parameters](https://www.newscatcherapi.com/docs/news-api/api-reference/enumerated-parameters): Allowed values for API parameters with a fixed set of options ### API Reference — Search - [Search Articles Get (GET)](https://www.newscatcherapi.com/docs/news-api/api-reference/search/search-articles-get): Searches for articles based on specified criteria such as keywords, language, country, source, and more. - [Search Articles Post (POST)](https://www.newscatcherapi.com/docs/news-api/api-reference/search/search-articles-post): Searches for articles based on specified criteria such as keywords, language, country, source, and more. ### API Reference — Latest headlines - [Retrieve Latest Headlines Get (GET)](https://www.newscatcherapi.com/docs/news-api/api-reference/latest-headlines/retrieve-latest-headlines-get): Retrieves the latest headlines for the specified time period. You can filter results by language, country, source, and more. - [Retrieve Latest Headlines Post (POST)](https://www.newscatcherapi.com/docs/news-api/api-reference/latest-headlines/retrieve-latest-headlines-post): Retrieves the latest headlines for the specified time period. You can filter results by language, country, source, and more. ### API Reference — Breaking news - [Retrieve Breaking News Get (GET)](https://www.newscatcherapi.com/docs/news-api/api-reference/breaking-news/retrieve-breaking-news-get): Retrieves breaking news articles and sorts them based on specified criteria. - [Retrieve Breaking News Post (POST)](https://www.newscatcherapi.com/docs/news-api/api-reference/breaking-news/retrieve-breaking-news-post): Retrieves breaking news articles and sorts them based on specified criteria. ### API Reference — Authors - [Search Articles By Author Get (GET)](https://www.newscatcherapi.com/docs/news-api/api-reference/authors/search-articles-by-author-get): Searches for articles written by a specified author. You can filter results by language, country, source, and more. - [Search Articles By Author Post (POST)](https://www.newscatcherapi.com/docs/news-api/api-reference/authors/search-articles-by-author-post): Searches for articles by author. You can filter results by language, country, source, and more. ### API Reference — Search by link - [Search Articles By Links Or Ids Get (GET)](https://www.newscatcherapi.com/docs/news-api/api-reference/search-by-link/search-articles-by-links-or-ids-get): Searches for articles based on specified links or IDs. You can filter results by date range. - [Search Articles By Links Or Ids Post (POST)](https://www.newscatcherapi.com/docs/news-api/api-reference/search-by-link/search-articles-by-links-or-ids-post): Searches for articles using their ID(s) or link(s). ### API Reference — Sources - [Retrieve Sources Get (GET)](https://www.newscatcherapi.com/docs/news-api/api-reference/sources/retrieve-sources-get): Retrieves a list of sources based on specified criteria such as language, country, rank, and more. - [Retrieve Sources Post (POST)](https://www.newscatcherapi.com/docs/news-api/api-reference/sources/retrieve-sources-post): Retrieves the list of sources available in the database. You can filter the sources by language, country, and more. ### API Reference — Aggregation count - [Get Aggregation Count By Interval Get (GET)](https://www.newscatcherapi.com/docs/news-api/api-reference/aggregation/get-aggregation-count-by-interval-get): Retrieves the count of articles aggregated by day or hour based on various search criteria, such as keyword, language, country, and source. - [Get Aggregation Count By Interval Post (POST)](https://www.newscatcherapi.com/docs/news-api/api-reference/aggregation/get-aggregation-count-by-interval-post): Retrieves the count of articles aggregated by day or hour based on various search criteria, such as keyword, language, country, and source. ### API Reference — Subscription - [Retrieve Subscription Plan Information Get (GET)](https://www.newscatcherapi.com/docs/news-api/api-reference/subscription/retrieve-subscription-plan-information-get): Retrieves information about your subscription plan. - [Retrieve Subscription Plan Information Post (POST)](https://www.newscatcherapi.com/docs/news-api/api-reference/subscription/retrieve-subscription-plan-information-post): Retrieves information about your subscription plan. ### Libraries - [Python SDK](https://www.newscatcherapi.com/docs/news-api/libraries/python): Python client library for News API - [TypeScript SDK](https://www.newscatcherapi.com/docs/news-api/libraries/typescript): TypeScript client library for News API - [Java SDK](https://www.newscatcherapi.com/docs/news-api/libraries/java): Java client library for News API ## Local News API ### Get started - [Introduction to Local News API](https://www.newscatcherapi.com/docs/local-news-api/get-started/introduction): Access location-specific news with advanced geographic relevance detection and structured filtering capabilities. - [Local News API quickstart guide](https://www.newscatcherapi.com/docs/local-news-api/get-started/quickstart): Get started with location-specific news data using Local News API. - [Local News API subscription plans](https://www.newscatcherapi.com/docs/local-news-api/get-started/subscription-plans): Select a Local News API plan that matches your needs - from standard NLP analysis to advanced AI-powered location features. ### Guides and concepts - [Location detection methods](https://www.newscatcherapi.com/docs/local-news-api/guides-and-concepts/location-detection-methods): Understand how Local News API uses different methods to detect and validate location mentions in news articles, helping you filter and interpret location-specific content. - [GeoNames filtering](https://www.newscatcherapi.com/docs/local-news-api/guides-and-concepts/geonames-filtering): Use structured geographic data to filter local news with precise administrative hierarchy, coordinates, localization and confidence scores. ### API Reference — Search - [Search Articles Post (POST)](https://www.newscatcherapi.com/docs/local-news-api/api-reference/search/search-articles-post): Searches for local news based on specified criteria such as keywords, geographic locations, language, country, source, and more. - [Search Advanced Post (POST)](https://www.newscatcherapi.com/docs/local-news-api/api-reference/search/search-advanced-post): Searches for local news using structured GeoNames filtering with administrative hierarchy, coordinates, localization and confidence scores. ### API Reference — Latest headlines - [Retrieve Latest Headlines Post (POST)](https://www.newscatcherapi.com/docs/local-news-api/api-reference/latest-headlines/retrieve-latest-headlines-post): Retrieves the most recent news headlines for the specific locations and times. You can filter results by language, source, theme, and more. - [Latest Headlines Advanced Post (POST)](https://www.newscatcherapi.com/docs/local-news-api/api-reference/latest-headlines/latest-headlines-advanced-post): Retrieves the most recent news headlines using structured GeoNames filtering with administrative hierarchy, coordinates, localization and confidence scores. ### API Reference — Sources - [Retrieve Sources Post (POST)](https://www.newscatcherapi.com/docs/local-news-api/api-reference/sources/retrieve-sources-post): Retrieves the list of local news sources available in the database. Filterable by language, country, and theme. ### API Reference — Search by identifiers - [Search Articles By Identifiers Post (POST)](https://www.newscatcherapi.com/docs/local-news-api/api-reference/search-by/search-articles-by-identifiers-post): Search for local news using article links, IDs, or RSS GUIDs. ## API Specifications - [catch-all-api](https://github.com/NewscatcherAPI/docs/blob/main/web-search-api/api-reference/catch-all-api.yml): CatchAll is a web search API that generates unique datasets that don't exist anywhere else on the web. - [news-api-v3](https://github.com/NewscatcherAPI/docs/blob/main/news-api/api-reference/news-api-v3.yml): NewsCatcher News API provides programmatic access to a continuously updated global news index. - [local-news-api](https://github.com/NewscatcherAPI/docs/blob/main/local-news-api/api-reference/local-news-api.yml): The Local News API provides access to local news articles with location-specific filtering capabilities.