# 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. - [Company Watchlist](https://www.newscatcherapi.com/docs/web-search-api/guides-and-concepts/company-search): Track specific companies across CatchAll jobs with per-company relevance scores. - [Projects](https://www.newscatcherapi.com/docs/web-search-api/guides-and-concepts/projects): Organize jobs, monitors, and datasets into named groups for easier management and sharing. - [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. - [Set up webhooks](https://www.newscatcherapi.com/docs/web-search-api/how-to/set-up-webhooks): Create and manage webhooks to receive real-time notifications when jobs and monitors complete. - [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 - [Validate Query](https://www.newscatcherapi.com/docs/web-search-api/api-reference/jobs/validate-query): Checks whether a query is well-formed and likely to produce good results before submitting a job. Returns a quality assessment with a status level, identified issues, and actionable suggestions. - [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. - [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. - [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. - [Delete Job](https://www.newscatcherapi.com/docs/web-search-api/api-reference/jobs/delete-job): Soft-deletes a job. The job is flagged as deleted and no longer appears in list results. The underlying data is retained. Only the job owner can delete a job. Returns `404` if the job is not found or does not belong to the authenticated user. Deleting an already-deleted job returns `200`. - [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. - [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. - [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 Status History](https://www.newscatcherapi.com/docs/web-search-api/api-reference/monitors/get-monitor-status-history): Returns the full execution history of a monitor as a list of status entries, ordered from newest to oldest. - [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. - [Update Monitor](https://www.newscatcherapi.com/docs/web-search-api/api-reference/monitors/update-monitor): Update the webhook configuration for an existing monitor. - [Delete Monitor](https://www.newscatcherapi.com/docs/web-search-api/api-reference/monitors/delete-monitor): Soft-deletes a monitor. The monitor is flagged as deleted, stops executing scheduled jobs immediately, and no longer appears in list results. Only the monitor owner can delete a monitor. Returns `404` if the monitor is not found or does not belong to the authenticated user. Deleting an already-deleted monitor returns `200`. ### API Reference — Webhooks - [Create Webhook](https://www.newscatcherapi.com/docs/web-search-api/api-reference/webhooks/create-webhook): Creates a new webhook endpoint for the organization. - [List Webhooks](https://www.newscatcherapi.com/docs/web-search-api/api-reference/webhooks/list-webhooks): Returns a paginated list of webhooks belonging to the organization. - [Get Webhook](https://www.newscatcherapi.com/docs/web-search-api/api-reference/webhooks/get-webhook): Returns the full configuration of a single webhook by ID. - [Update Webhook](https://www.newscatcherapi.com/docs/web-search-api/api-reference/webhooks/update-webhook): Updates one or more fields of an existing webhook. - [Delete Webhook](https://www.newscatcherapi.com/docs/web-search-api/api-reference/webhooks/delete-webhook): Permanently deletes a webhook and removes all resource assignments. Assigned jobs and monitors no longer trigger delivery to this webhook. This operation cannot be undone. - [Test Webhook](https://www.newscatcherapi.com/docs/web-search-api/api-reference/webhooks/test-webhook): Sends a test HTTP request to the webhook URL using the webhook's configured method, headers, and auth. Returns the response from the target endpoint. Use this to verify URL reachability and authentication before attaching the webhook to a live job or monitor. - [Assign Resource](https://www.newscatcherapi.com/docs/web-search-api/api-reference/webhooks/assign-resource): Attaches a job, monitor, or monitor group to the webhook. When the resource completes, the webhook receives a delivery. A single webhook can be assigned to multiple resources. Each resource can have up to 5 webhooks assigned. - [List Webhook Resources](https://www.newscatcherapi.com/docs/web-search-api/api-reference/webhooks/list-webhook-resources): Returns a paginated list of resources currently assigned to this webhook. - [Remove Resource](https://www.newscatcherapi.com/docs/web-search-api/api-reference/webhooks/remove-resource): Detaches a resource from this webhook. Completions of the resource no longer trigger delivery to this webhook. The webhook and the resource itself are not deleted. - [List Resource Webhooks](https://www.newscatcherapi.com/docs/web-search-api/api-reference/webhooks/list-resource-webhooks): Returns all webhooks currently assigned to the given resource. - [Get Delivery History](https://www.newscatcherapi.com/docs/web-search-api/api-reference/webhooks/get-delivery-history): Returns a paginated delivery log for a given resource, ordered by timestamp descending. Each record shows the webhook dispatched, the HTTP status code returned, delivery outcome, and any error or warning messages. Use this to debug failed deliveries or audit dispatch activity. - [Webhook payload](https://www.newscatcherapi.com/docs/web-search-api/api-reference/webhooks/webhook-payload): Data model for the payload delivered to a webhook when a monitor job completes. ### API Reference — Entities - [List Entities](https://www.newscatcherapi.com/docs/web-search-api/api-reference/entities/list-entities): Returns a paginated list of entities belonging to the authenticated organization. Supports filtering by status and entity type, and sorting by name, status, or creation date. - [Create Entity](https://www.newscatcherapi.com/docs/web-search-api/api-reference/entities/create-entity): Creates a new company entity and begins background enrichment. The entity status starts as `pending` and transitions to `ready` once enrichment completes. Provide as much identifying information as possible — `domain` is the highest-signal field because it is unambiguous. - [Create Entities Batch](https://www.newscatcherapi.com/docs/web-search-api/api-reference/entities/create-entities-batch): Creates multiple entities in a single request. Each entity is processed independently — a failure in one does not affect others. Returns an array of `{id, status}` objects in the same order as the input array. - [Get Entity](https://www.newscatcherapi.com/docs/web-search-api/api-reference/entities/get-entity): Returns a single entity by ID with all attributes and current status. - [Update Entity](https://www.newscatcherapi.com/docs/web-search-api/api-reference/entities/update-entity): Updates one or more fields of an existing entity. - [Delete Entity](https://www.newscatcherapi.com/docs/web-search-api/api-reference/entities/delete-entity): Permanently deletes an entity. The entity is removed from all datasets and the search index. This operation cannot be undone. ### API Reference — Datasets - [List Datasets](https://www.newscatcherapi.com/docs/web-search-api/api-reference/datasets/list-datasets): Returns a paginated list of datasets belonging to the authenticated organization. Supports filtering by status and sorting by name, status, or creation date. - [Create Dataset](https://www.newscatcherapi.com/docs/web-search-api/api-reference/datasets/create-dataset): Creates a new dataset from a list of existing entity IDs. If any of the provided entity IDs do not exist or do not belong to your organization, the request fails with `400`. All entity IDs must be valid before the dataset is created. To create a dataset and entities in one step, use the [`Create dataset from CSV`](https://www.newscatcherapi.com/docs/web-search-api/api-reference/datasets/create-dataset-from-csv) endpoint instead. - [Create Dataset From Csv](https://www.newscatcherapi.com/docs/web-search-api/api-reference/datasets/create-dataset-from-csv): Creates a new dataset by uploading a CSV file. Each row in the CSV becomes an entity. The `name` and `domain`columns are required; all other columns are optional. **CSV format:** ```csv name,description,domain,alternative_names,key_persons NewsCatcher,"AI-powered news data provider",newscatcherapi.com,"NC;NewsCatcher API","Artem Bugara;Maksym Sugonyaka" OpenAI,"Artificial intelligence research company",openai.com,"Open AI","Sam Altman" ``` Use semicolons (`;`) to separate multiple values in `alternative_names` and `key_persons`. Rows with empty `name` are skipped and reported in `validation_report`. **Note**: The response shape differs from the JSON dataset creation endpoint: it returns `dataset_id` (not `id`) and includes a `validation_report` with details on skipped rows. - [Get Dataset](https://www.newscatcherapi.com/docs/web-search-api/api-reference/datasets/get-dataset): Returns a single dataset by ID including entity count and current status. - [Update Dataset](https://www.newscatcherapi.com/docs/web-search-api/api-reference/datasets/update-dataset): Updates the name or description of a dataset. - [Delete Dataset](https://www.newscatcherapi.com/docs/web-search-api/api-reference/datasets/delete-dataset): Permanently deletes a dataset. The entities within the dataset are not deleted — only the dataset itself. This operation cannot be undone. - [List Entities In Dataset](https://www.newscatcherapi.com/docs/web-search-api/api-reference/datasets/list-entities-in-dataset): Returns a paginated list of entities in a dataset. Supports filtering by status, entity type, and name search. - [Add Entities To Dataset](https://www.newscatcherapi.com/docs/web-search-api/api-reference/datasets/add-entities-to-dataset): Adds one or more existing entities to a dataset. Returns the number of entities added. - [Remove Entities From Dataset](https://www.newscatcherapi.com/docs/web-search-api/api-reference/datasets/remove-entities-from-dataset): Removes one or more entities from a dataset. The entities themselves are not deleted — they are only removed from this dataset. Returns the number of entities removed. - [Get Dataset Status History](https://www.newscatcherapi.com/docs/web-search-api/api-reference/datasets/get-dataset-status-history): Returns the full status change history for a dataset, ordered chronologically from oldest to newest. - [Upload Csv To Dataset](https://www.newscatcherapi.com/docs/web-search-api/api-reference/datasets/upload-csv-to-dataset): Appends new companies to an existing dataset by uploading a CSV file. Uses the same CSV format as the dataset creation endpoint. The response omits `dataset_name` compared to the create-from-CSV endpoint since the dataset already exists. ### API Reference — Projects - [List Projects](https://www.newscatcherapi.com/docs/web-search-api/api-reference/projects/list-projects): Returns all projects visible to the authenticated user. - [Create Project](https://www.newscatcherapi.com/docs/web-search-api/api-reference/projects/create-project): Creates a new project. - [Get Project](https://www.newscatcherapi.com/docs/web-search-api/api-reference/projects/get-project): Returns a single project by ID. - [Update Project](https://www.newscatcherapi.com/docs/web-search-api/api-reference/projects/update-project): Updates the name or description of an existing project. - [Delete Project](https://www.newscatcherapi.com/docs/web-search-api/api-reference/projects/delete-project): Deletes a project. By default, assigned resources are unassigned but not deleted. - [Get Project Overview](https://www.newscatcherapi.com/docs/web-search-api/api-reference/projects/get-project-overview): Returns resource counts for a project, grouped by type and status. For `jobs` and `monitors`, counts are broken down by status (for example, `completed`, `failed`). For `datasets` and `monitor_groups`, only a `total` count is returned. - [List Resources](https://www.newscatcherapi.com/docs/web-search-api/api-reference/projects/list-resources): Returns all resources assigned to a project, with optional filtering by type. - [Add Resource](https://www.newscatcherapi.com/docs/web-search-api/api-reference/projects/add-resource): Assigns one or more existing resources to a project in a single request. - [Remove Resource](https://www.newscatcherapi.com/docs/web-search-api/api-reference/projects/remove-resource): Removes a resource from a project. The resource itself is not deleted — it becomes unassigned and continues to exist. ### 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. - [CatchAll Skills](https://www.newscatcherapi.com/docs/web-search-api/integrations/skill): Give any AI agent specialized, task-specific capabilities for web data extraction — from general-purpose search to competitive intelligence, funding, and M&A tracking. - [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. - [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): Programmatic access to a continuously updated index of news articles from sources worldwide. - [Quickstart](https://www.newscatcherapi.com/docs/news-api/get-started/quickstart): Make your first News API call in under five minutes. - [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): Query syntax reference for the News API q parameter. - [Clustering news articles](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/clustering-news-articles): Group related articles together to identify trends and reduce noise in large volumes of news data. - [Articles deduplication](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/articles-deduplication): How News API identifies and filters near-identical articles, and how to use deduplication in your queries. - [NLP features](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/nlp-features): NLP fields available on indexed articles and how to use them in News API requests. - [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. - [Breaking news](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/breaking-news): Discover emerging stories with significant coverage traction using the breaking news endpoint. - [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): Strategies for efficiently querying large volumes of historical news data while avoiding common performance pitfalls. ### How to - [Build search queries](https://www.newscatcherapi.com/docs/news-api/how-to/build-search-queries): Use boolean operators and proximity search to construct precise queries for News API - [Filter by date](https://www.newscatcherapi.com/docs/news-api/how-to/filter-by-date): Control which articles the API returns using publication date, parse date, and date precision filters. - [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): Search across language barriers using English keywords and entity names - [Retrieve large datasets](https://www.newscatcherapi.com/docs/news-api/how-to/retrieve-more-than-10k-articles): Retrieve all articles for a query that exceeds the 10,000 article limit using time-chunking across Python, TypeScript, and Java - [Check sources coverage](https://www.newscatcherapi.com/docs/news-api/how-to/check-sources-coverage): Query the sources index to verify coverage and identify uncovered sources. - [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 in News API - [Report bugs](https://www.newscatcherapi.com/docs/news-api/troubleshooting/report-bugs): How to report bugs and issues with the NewsCatcher APIs - [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 ### API Reference - [API reference overview](https://www.newscatcherapi.com/docs/news-api/api-reference/overview): Base URL, authentication, request format, and endpoints for News API. - [Authentication](https://www.newscatcherapi.com/docs/news-api/api-reference/authentication): How to authenticate requests to News API. - [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): Request and response headers for News API - [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-count/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-count/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.