# APITube Documentation > APITube Documentation - Worldwide News API for your Products Documentation for APITube News API: guides, API reference, common workflows and integrations. ## Table of Contents ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Shell - [cURL for Shell](https://docs.apitube.io/platform/news-api/integrations/shell/http-client.md): Integrate APITube News API with shell scripts using the cURL command-line tool for making HTTP requests - [HTTPie for Shell](https://docs.apitube.io/platform/news-api/integrations/shell/httpie-client.md): Integrate APITube News API with shell scripts using the HTTPie command-line HTTP client for human-friendly interactions - [Wget for Shell](https://docs.apitube.io/platform/news-api/integrations/shell/wget-client.md): Integrate APITube News API with shell scripts using the Wget utility for retrieving content from web servers #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Python - [Requests Library for Python](https://docs.apitube.io/platform/news-api/integrations/python/requests-client.md): Integrate APITube News API with Python applications using the Requests HTTP library - [HTTP Client for Python](https://docs.apitube.io/platform/news-api/integrations/python/http-client.md): Integrate APITube News API with Python applications using the built-in http.client module for low-level HTTP operations - [Django Framework for Python](https://docs.apitube.io/platform/news-api/integrations/python/django-framework.md): Integrate APITube News API with Django Python applications using the requests library in view functions - [Flask Framework for Python](https://docs.apitube.io/platform/news-api/integrations/python/flask-framework.md): Integrate APITube News API with Flask Python applications using the requests library in route handlers #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Node.js - [Fetch API for Node.js](https://docs.apitube.io/platform/news-api/integrations/node-js/fetch-client.md): Integrate APITube News API with Node.js applications using the Fetch API for making HTTP requests - [Axios Client for Node.js](https://docs.apitube.io/platform/news-api/integrations/node-js/axios-client.md): Integrate APITube News API with Node.js applications using the Axios promise-based HTTP client - [HTTP Module for Node.js](https://docs.apitube.io/platform/news-api/integrations/node-js/http-client.md): Integrate APITube News API with Node.js applications using the built-in HTTP module for network communication - [Request Client for Node.js](https://docs.apitube.io/platform/news-api/integrations/node-js/request-client.md): Integrate APITube News API with Node.js applications using the Request library for simplified HTTP calls - [Unirest Client for Node.js](https://docs.apitube.io/platform/news-api/integrations/node-js/unirest-client.md): Integrate APITube News API with Node.js applications using the Unirest library for lightweight HTTP requests - [RapidQL Client for Node.js](https://docs.apitube.io/platform/news-api/integrations/node-js/rapidql-client.md): Integrate APITube News API with Node.js applications using the RapidQL library for unified API queries #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### JavaScript - [Fetch API for JavaScript](https://docs.apitube.io/platform/news-api/integrations/javascript/fetch-client.md): Integrate APITube News API with JavaScript applications using the native Fetch API for making HTTP requests - [Axios Client for JavaScript](https://docs.apitube.io/platform/news-api/integrations/javascript/axios-client.md): Integrate APITube News API with JavaScript applications using the Axios HTTP client library - [jQuery AJAX for JavaScript](https://docs.apitube.io/platform/news-api/integrations/javascript/jquery-client.md): Integrate APITube News API with JavaScript applications using jQuery's AJAX functionality for simplified HTTP requests - [XMLHttpRequest for JavaScript](https://docs.apitube.io/platform/news-api/integrations/javascript/xml-http-request.md): Integrate APITube News API with JavaScript applications using the XMLHttpRequest object for making HTTP requests #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### TypeScript - [Fetch for TypeScript](https://docs.apitube.io/platform/news-api/integrations/typescript/fetch-client.md): Integrate APITube News API with TypeScript applications using the built-in Fetch API with typed responses - [Axios for TypeScript](https://docs.apitube.io/platform/news-api/integrations/typescript/axios-client.md): Integrate APITube News API with TypeScript applications using the Axios HTTP client - [Got for TypeScript](https://docs.apitube.io/platform/news-api/integrations/typescript/got-client.md): Integrate APITube News API with TypeScript applications using the Got HTTP client - [node-fetch for TypeScript](https://docs.apitube.io/platform/news-api/integrations/typescript/node-fetch-client.md): Integrate APITube News API with TypeScript applications using the node-fetch package #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### PHP - [cURL Client for PHP](https://docs.apitube.io/platform/news-api/integrations/php/curl-client.md): Integrate APITube News API with PHP applications using the cURL extension for HTTP requests - [Guzzle Client for PHP](https://docs.apitube.io/platform/news-api/integrations/php/guzzle-client.md): Integrate APITube News API with PHP applications using the Guzzle HTTP client library for making HTTP requests - [Laravel Framework for PHP](https://docs.apitube.io/platform/news-api/integrations/php/laravel-framework.md): Integrate APITube News API with Laravel PHP applications using the HTTP client provided by the framework - [Symfony Framework for PHP](https://docs.apitube.io/platform/news-api/integrations/php/symfony-framework.md): Integrate APITube News API with Symfony PHP applications using the HttpClient component - [Yii Framework for PHP](https://docs.apitube.io/platform/news-api/integrations/php/yii-framework.md): Integrate APITube News API with Yii PHP applications using the framework's HTTP client extension #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Java - [HttpClient for Java](https://docs.apitube.io/platform/news-api/integrations/java/http-client.md): Integrate APITube News API with Java applications using the modern HttpClient introduced in Java 11 - [OkHttp Client for Java](https://docs.apitube.io/platform/news-api/integrations/java/ok-http-client.md): Integrate APITube News API with Java applications using the OkHttp library for efficient HTTP requests - [AsyncHttpClient for Java](https://docs.apitube.io/platform/news-api/integrations/java/async-http-client.md): Integrate APITube News API with Java applications using the AsyncHttpClient library for asynchronous HTTP requests - [HttpRequest for Java](https://docs.apitube.io/platform/news-api/integrations/java/http-request-client.md): Integrate APITube News API with Java applications using the HttpRequest class for building HTTP requests - [Unirest Client for Java](https://docs.apitube.io/platform/news-api/integrations/java/unirest-client.md): Integrate APITube News API with Java applications using the Unirest library for simplified HTTP requests #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Go - [HTTP Client for Go](https://docs.apitube.io/platform/news-api/integrations/go/new-request-client.md): Integrate APITube News API with Go applications using the standard net/http package #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Ruby - [HTTParty Client for Ruby](https://docs.apitube.io/platform/news-api/integrations/ruby/httparty-client.md): Integrate APITube News API with Ruby applications using the HTTParty gem for simplified HTTP requests - [Net::HTTP Client for Ruby](https://docs.apitube.io/platform/news-api/integrations/ruby/unirest-client.md): Integrate APITube News API with Ruby applications using the standard Net::HTTP library for HTTP requests #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### C# - [HttpClient for C#](https://docs.apitube.io/platform/news-api/integrations/csharp/http-client.md): Integrate APITube News API with C# applications using the HttpClient class from the .NET framework - [RestSharp Client for C#](https://docs.apitube.io/platform/news-api/integrations/csharp/rest-client.md): Integrate APITube News API with C# applications using the RestSharp library for simplified REST API calls #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Rust - [Reqwest Client for Rust](https://docs.apitube.io/platform/news-api/integrations/rust/reqwest-client.md): Integrate APITube News API with Rust applications using the reqwest crate for asynchronous HTTP requests #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Swift - [URLSession for Swift](https://docs.apitube.io/platform/news-api/integrations/swift/url-session.md): Integrate APITube News API with Swift applications using the URLSession networking API for iOS and macOS - [Alamofire Client for Swift](https://docs.apitube.io/platform/news-api/integrations/swift/alamofire-client.md): Integrate APITube News API with Swift applications using the Alamofire HTTP networking library #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Kotlin - [OkHttp Client for Kotlin](https://docs.apitube.io/platform/news-api/integrations/kotlin/okhttp-client.md): Integrate APITube News API with Kotlin applications using the OkHttp client library #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### C - [Libcurl Client for C/C++](https://docs.apitube.io/platform/news-api/integrations/c/libcurl-client.md): Integrate APITube News API with C/C++ applications using the Libcurl library for HTTP requests #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Clojure - [clj-http Client for Clojure](https://docs.apitube.io/platform/news-api/integrations/clojure/clj-http-client.md): Integrate APITube News API with Clojure applications using the clj-http library for HTTP requests #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Crystal - [Crest for Crystal](https://docs.apitube.io/platform/news-api/integrations/crystal/crest-client.md): Integrate APITube News API with Crystal applications using the Crest HTTP client - [HTTP::Client for Crystal](https://docs.apitube.io/platform/news-api/integrations/crystal/http-client.md): Integrate APITube News API with Crystal applications using the built-in HTTP::Client #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Dart - [HTTP Package for Dart](https://docs.apitube.io/platform/news-api/integrations/dart/http-client.md): Integrate APITube News API with Dart applications using the HTTP package for making network requests #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Elixir - [HTTP Client for Elixir](https://docs.apitube.io/platform/news-api/integrations/elixir/http-client.md): Integrate APITube News API with Elixir applications using the HTTPoison library for making HTTP requests - [HTTPoison Client for Elixir](https://docs.apitube.io/platform/news-api/integrations/elixir/http-poison-client.md): Integrate APITube News API with Elixir applications using the HTTPoison library for simplified HTTP requests #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Erlang - [HTTPC Client for Erlang](https://docs.apitube.io/platform/news-api/integrations/erlang/httpc-client.md): Integrate APITube News API with Erlang applications using the built-in HTTPC module for HTTP requests #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### F# - [HttpClient for F#](https://docs.apitube.io/platform/news-api/integrations/fsharp/http-client.md): Integrate APITube News API with F# applications using the .NET HttpClient - [FSharp.Data for F#](https://docs.apitube.io/platform/news-api/integrations/fsharp/fsharp-data-client.md): Integrate APITube News API with F# applications using the FSharp.Data library #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Groovy - [HttpURLConnection for Groovy](https://docs.apitube.io/platform/news-api/integrations/groovy/http-url-connection-client.md): Integrate APITube News API with Groovy applications using the standard HttpURLConnection - [RESTClient for Groovy](https://docs.apitube.io/platform/news-api/integrations/groovy/rest-client.md): Integrate APITube News API with Groovy applications using the HTTPBuilder RESTClient #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Haskell - [HTTP-conduit Client for Haskell](https://docs.apitube.io/platform/news-api/integrations/haskell/http-conduit-client.md): Integrate APITube News API with Haskell applications using the HTTP-conduit library for secure HTTP requests #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Julia - [HTTP.jl for Julia](https://docs.apitube.io/platform/news-api/integrations/julia/http-client.md): Integrate APITube News API with Julia applications using the HTTP.jl package - [Downloads.jl for Julia](https://docs.apitube.io/platform/news-api/integrations/julia/downloads-client.md): Integrate APITube News API with Julia applications using the standard Downloads module #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Lua - [HTTP Client for Lua](https://docs.apitube.io/platform/news-api/integrations/lua/http-client.md): Integrate APITube News API with Lua applications using the socket.http module for making HTTP requests - [LuaSocket Client for Lua](https://docs.apitube.io/platform/news-api/integrations/lua/lua-socket-client.md): Integrate APITube News API with Lua applications using the LuaSocket library for network connectivity #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Nim - [HttpClient for Nim](https://docs.apitube.io/platform/news-api/integrations/nim/http-client.md): Integrate APITube News API with Nim applications using the std/httpclient module - [AsyncHttpClient for Nim](https://docs.apitube.io/platform/news-api/integrations/nim/async-http-client.md): Integrate APITube News API with Nim applications using the asynchronous AsyncHttpClient #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Objective-C - [NSURLSession for Objective-C](https://docs.apitube.io/platform/news-api/integrations/objective-c/ns-url-session.md): Integrate APITube News API with Objective-C applications using the native NSURLSession API for network requests - [AFNetworking Client for Objective-C](https://docs.apitube.io/platform/news-api/integrations/objective-c/afnetworking-client.md): Integrate APITube News API with Objective-C applications using the AFNetworking library for network requests #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### OCaml - [CoHTTP Client for OCaml](https://docs.apitube.io/platform/news-api/integrations/ocaml/co-http-client.md): Integrate APITube News API with OCaml applications using the CoHTTP library for asynchronous HTTP requests #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Perl - [LWP for Perl](https://docs.apitube.io/platform/news-api/integrations/perl/lwp-client.md): Integrate APITube News API with Perl applications using the LWP::UserAgent module - [HTTP::Tiny for Perl](https://docs.apitube.io/platform/news-api/integrations/perl/http-tiny-client.md): Integrate APITube News API with Perl applications using the core HTTP::Tiny module - [Mojo::UserAgent for Perl](https://docs.apitube.io/platform/news-api/integrations/perl/mojo-client.md): Integrate APITube News API with Perl applications using the Mojo::UserAgent client #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### PowerShell - [Invoke-RestMethod for PowerShell](https://docs.apitube.io/platform/news-api/integrations/powershell/client.md): Integrate APITube News API with PowerShell scripts using the Invoke-RestMethod cmdlet for HTTP requests #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### R - [httr Package for R](https://docs.apitube.io/platform/news-api/integrations/r/httr-client.md): Integrate APITube News API with R applications using the httr package for HTTP requests and responses #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Scala - [Akka HTTP Client for Scala](https://docs.apitube.io/platform/news-api/integrations/scala/akka-http-client.md): Integrate APITube News API with Scala applications using the Akka HTTP library for building high-performance HTTP services #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required ### User Guide - [Make Your First API Call](https://docs.apitube.io/guides/user-guide/make-your-first-api-call.md): A step-by-step guide to making your first request to the APITube News API, from getting an API key to understanding the response - [General FAQs (Frequently Asked Questions)](https://docs.apitube.io/guides/user-guide/general-faqs.md): Frequently asked questions about APITube News API — pricing, credits, supported websites, filters, integrations, and usage. - [Changelog](https://docs.apitube.io/platform/changelog.md): APITube Changelog ### News API - [Article Endpoints](https://docs.apitube.io/platform/news-api/articles.md): Every APITube endpoint that returns articles — search, top headlines, browse by category, topic, industry or entity, local news, raw feed, lookup by ID and story clusters — and which one to pick. - [Insights Endpoints](https://docs.apitube.io/platform/news-api/insights.md): APITube endpoints that answer questions about the news corpus instead of returning a feed — trends aggregation, article counts, and retrieval-grounded fact checking. - [Directories](https://docs.apitube.io/platform/news-api/reference.md): Searchable APITube directories of people, companies and journalists — Wikidata-enriched profiles with a coverage block and the latest articles for each entity. - [Real-time Delivery](https://docs.apitube.io/platform/news-api/real-time.md): Three ways to receive APITube articles as they are indexed instead of polling — the SSE stream, the WebSocket stream, and webhooks — and how to choose between them. - [Reference Data](https://docs.apitube.io/platform/news-api/reference-data.md): The allowed values behind APITube filters — country, language, category, topic and industry lists, event types, and the autocomplete endpoints that resolve a name to an ID. - [Using News API with AI](https://docs.apitube.io/platform/news-api/ai.md): Connect APITube News API to AI assistants and code editors — MCP server, code editor setup, and agent skills, all in one place. - [Tools](https://docs.apitube.io/platform/news-api/tools.md): Tools for working with the APITube News API — the interactive query builder, the OpenAPI explorer, the Postman collection, official SDKs and no-code integrations. - [Help](https://docs.apitube.io/platform/news-api/help.md): Where to look when an APITube request does not behave — the glossary, technical FAQ, debugging guide, error codes and the live API status page. #### Getting started - [Endpoints](https://docs.apitube.io/platform/news-api/endpoints.md): The News API provides a set of endpoints that allow you to access news articles from various sources. - [Authentication](https://docs.apitube.io/platform/news-api/authentication.md): Authentication API key and Bearer token - [API Response Structure](https://docs.apitube.io/platform/news-api/response-structure.md): Detailed description of the structure and fields of the APITube API response - [Rate Limits and Quotas](https://docs.apitube.io/platform/news-api/rate-limits.md): Learn about the rate limits and quotas for the APITube News API. - [Balance and Usage — /v1/balance](https://docs.apitube.io/platform/news-api/balance.md): Check remaining points and the current plan for an APITube API key with GET /v1/balance — a free call that never consumes points. - [HTTP Response Codes](https://docs.apitube.io/platform/news-api/http-response-codes.md): Learn about the HTTP response codes returned by the APITube News API. #### Articles - [Search Articles — /v1/news/everything](https://docs.apitube.io/platform/news-api/everything.md): Search the whole APITube news archive with GET /v1/news/everything — the complete filter set, sorting, pagination, faceting and export, every parameter listed. - [Top Headlines — /v1/news/top-headlines](https://docs.apitube.io/platform/news-api/top-headlines.md): Get breaking and important news from high-authority sources with GET /v1/news/top-headlines, with the full APITube filter set and every parameter listed. - [Articles by Category — /v1/news/category](https://docs.apitube.io/platform/news-api/category.md): Get articles in an IPTC Media Topics category with GET /v1/news/category/{taxonomy}/{category_id}, with the full APITube filter set and every parameter listed. - [Articles by Topic — /v1/news/topic](https://docs.apitube.io/platform/news-api/topic.md): Get articles for a topic with GET /v1/news/topic/{topic_id}, with the full APITube filter set and every parameter listed. - [Articles by Industry — /v1/news/industry](https://docs.apitube.io/platform/news-api/industry.md): Get articles for an industry with GET /v1/news/industry/{industry_id}, with the full APITube filter set and every parameter listed. - [Articles by Entity — /v1/news/entity](https://docs.apitube.io/platform/news-api/entity.md): Get articles mentioning a person, organization, brand or place with GET /v1/news/entity/{entity_id}, with the full APITube filter set. - [Local News](https://docs.apitube.io/platform/news-api/local.md): Get news around a geographic point ranked by distance, with per-article distance and an optional local insights dashboard - [Raw Articles](https://docs.apitube.io/platform/news-api/raw.md): Get raw articles straight from the discovery stage, before HTML parsing and NLP enrichment - [Get an Article by ID — /v1/news/article](https://docs.apitube.io/platform/news-api/article.md): Fetch one or up to 100 articles by their IDs with GET /v1/news/article, including the full article object and every supported parameter. - [Get a Story — /v1/news/story](https://docs.apitube.io/platform/news-api/story.md): Get the cluster of articles covering the same event as a given article with GET /v1/news/story/{article_id}, with the full APITube filter set. #### Insights - [Trends — /v1/news/trends](https://docs.apitube.io/platform/news-api/trends.md): Aggregate the most mentioned entities, categories, topics and sources with GET /v1/news/trends — counts, growth rate, trending score and period comparison. - [Count Articles](https://docs.apitube.io/platform/news-api/count.md): Get the number of articles matching your filters without loading any content - [Fact Check](https://docs.apitube.io/platform/news-api/fact-check.md): Verify factual claims against the live news corpus and get per-claim verdicts with supporting evidence #### Directories - [People](https://docs.apitube.io/platform/news-api/reference/people.md): Directory of people (public figures) with Wikidata-enriched profiles and coverage - [Companies](https://docs.apitube.io/platform/news-api/reference/companies.md): Directory of companies and brands with Wikidata-enriched profiles and coverage - [Journalists](https://docs.apitube.io/platform/news-api/reference/journalists.md): Directory of journalists with their outlets and coverage activity #### Real-time delivery - [SSE Stream](https://docs.apitube.io/platform/news-api/sse-stream.md): Receive news articles in real time as APITube indexes them, using the Server-Sent Events (SSE) streaming endpoint - [WebSocket Stream](https://docs.apitube.io/platform/news-api/websocket-stream.md): Receive news articles in real time over a full-duplex WebSocket connection as APITube indexes them, with a typed message protocol - [Webhooks](https://docs.apitube.io/platform/news-api/webhooks.md): Get notified by HTTP POST when new articles match your filters — push delivery instead of polling, with signed payloads and automatic retries #### Data & reference - [List of Countries](https://docs.apitube.io/platform/news-api/list-of-countries.md): The News API provides a set of countries that you can use to filter news articles. - [List of Languages](https://docs.apitube.io/platform/news-api/list-of-languages.md): The News API provides a set of languages that you can use to filter news articles. - [List of Topics](https://docs.apitube.io/platform/news-api/list-of-topics.md): The News API provides a set of topics that you can use to filter news articles. - [Event Types](https://docs.apitube.io/platform/news-api/reference/event-types.md): List every valid value for the event.type and event.category filters - [Suggest Entities](https://docs.apitube.io/platform/news-api/suggest/entities.md): Autocomplete search for entities by name prefix - [Suggest Categories](https://docs.apitube.io/platform/news-api/suggest/categories.md): Autocomplete search for categories by name prefix - [Suggest Topics](https://docs.apitube.io/platform/news-api/suggest/topics.md): Autocomplete search for topics by name prefix - [Suggest Industries](https://docs.apitube.io/platform/news-api/suggest/industries.md): Autocomplete search for industries by name prefix #### AI - [Natural Language Search](https://docs.apitube.io/platform/news-api/ai/natural-language-search.md): Send a plain-language sentence in the prompt parameter and the News API turns it into filters, returning the interpretation in meta.prompt - [MCP Server](https://docs.apitube.io/platform/news-api/ai/mcp-server.md): Connect AI assistants like Cursor and Claude Desktop directly to News API using Model Context Protocol - [Set Up News API in Your Code Editor](https://docs.apitube.io/platform/news-api/ai/code-editors.md): Step-by-step MCP setup for Cursor, Claude Desktop, Claude Code, VS Code, and Windsurf using the hosted APITube MCP server. - [APITube Agent Skills](https://docs.apitube.io/platform/news-api/ai/agent-skills.md): Discoverable Agent Skills for the APITube News API and hosted MCP server, served from /.well-known/ for agents to find and use on their own. #### Tools - [Interactive Query Builder](https://docs.apitube.io/platform/news-api/query-builder.md): Build a News API request in the browser — pick an endpoint, set filters, then copy the generated URL or cURL command. #### Help - [Glossary of APITube News API Terms](https://docs.apitube.io/platform/news-api/glossary.md): Plain definitions of the core APITube News API concepts — articles, stories, entities, sentiment, categories, topics, industries, sources, source rank, trends, pagination, credits, and rate limits. - [Technical FAQ](https://docs.apitube.io/platform/news-api/technical-faq.md): Answers to frequently asked technical questions about working with APITube - [Debugging API Requests](https://docs.apitube.io/platform/news-api/debugging.md): Tips and tricks for debugging your API requests ### Common Workflows - [Getting Started](https://docs.apitube.io/platform/news-api/common-workflows/getting-started.md): The basics of using the News API examples library - [News API Usage Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples.md): Library of News API usage examples for various scenarios - [Recipes](https://docs.apitube.io/platform/news-api/common-workflows/recipes.md): End-to-end APITube News API recipes — person dossiers, company monitoring, journalist discovery, faceted dashboards, event tracking, reading-level feeds and raw ingestion. #### Examples - [Title Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/title-examples.md): Examples of using title parameters in News API - [Language Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/language-examples.md): Examples of using language parameters in News API - [Category Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/category-examples.md): Examples of using categories in News API - [Entity Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/entity-examples.md): Examples of using entities in News API - [Sentiment Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sentiment-examples.md): Examples of using sentiment in News API - [Source Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/source-examples.md): Examples of using sources in News API - [Date and Time Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/date-time-examples.md): Examples of using date and time parameters in News API - [Person Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/person-examples.md): Examples of using person parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/organization-examples.md): Examples of using organization parameters in News API - [Organization Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/brand-examples.md): Examples of using organization parameters in News API - [Author Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/author-examples.md): Examples of using author parameters in News API - [Search by Location](https://docs.apitube.io/platform/news-api/common-workflows/examples/search-by-location.md): Search for news articles by location. - [Media Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/media-examples.md): Examples of using media parameters in News API - [Topic Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/topic-examples.md): Examples of using topic parameters in News API - [Industry Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/industry-examples.md): Examples of using industry parameters in News API - [Sorting Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/sorting-examples.md): Examples of using sorting parameters in News API - [Pagination Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/pagination-examples.md): Examples of using pagination parameters in News API - [Additional Filter Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/filter-examples.md): Examples of using additional filtering parameters in News API - [Export Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/export-examples.md): Examples of using export parameters in News API - [Article Query Examples](https://docs.apitube.io/platform/news-api/common-workflows/examples/article-examples.md): Examples of retrieving specific articles by ID in News API #### Recipes - [Build a Person Dossier](https://docs.apitube.io/platform/news-api/common-workflows/recipes/person-dossier.md): Look up a public figure and assemble a profile, coverage and recent articles - [Monitor a Company](https://docs.apitube.io/platform/news-api/common-workflows/recipes/company-monitoring.md): Track a company's coverage volume, sentiment and momentum over time - [Find Journalists on a Beat](https://docs.apitube.io/platform/news-api/common-workflows/recipes/journalists-by-beat.md): Discover journalists, see their outlets, beats and who they cover - [Build an Autocomplete Search Box](https://docs.apitube.io/platform/news-api/common-workflows/recipes/autocomplete-search.md): Turn keystrokes into entity suggestions, then pivot to the matching news feed - [Ingest Raw Articles in Near Real Time](https://docs.apitube.io/platform/news-api/common-workflows/recipes/raw-ingestion.md): Poll the discovery feed for freshly found articles and run your own parsing - [Build a Faceted News Dashboard](https://docs.apitube.io/platform/news-api/common-workflows/recipes/faceted-dashboard.md): Turn one search into dashboard widgets — category and country breakdowns, a publication timeline, and a sentiment histogram - [Track Data Breaches and Lawsuits](https://docs.apitube.io/platform/news-api/common-workflows/recipes/breach-feed.md): Build a security incident feed from news — filter breaches by event type, scope them to an industry or company, and follow a case into litigation - [Filter News by Reading Level](https://docs.apitube.io/platform/news-api/common-workflows/recipes/reading-level-feed.md): Serve news matched to your readers — pick a difficulty band, tune it with Flesch-Kincaid grade or reading age, then cap the reading time - [Monitor the Automotive and EV Industry](https://docs.apitube.io/platform/news-api/common-workflows/recipes/automotive-ev-monitor.md): Track carmakers, EV charging and vehicle sales coverage — scope by industry ID, narrow to one manufacturer, then watch recalls and launches - [Track the Real Estate Market](https://docs.apitube.io/platform/news-api/common-workflows/recipes/real-estate-market.md): Follow property news by market — scope the sector with industry IDs, split coverage by country with facets, then watch sentiment turn ### Migrations - [Migrating from NewsAPI.org](https://docs.apitube.io/platform/migrations/from-newsapi-org.md): Move from NewsAPI.org v2 to APITube — parameter mapping for /v2/everything and /v2/top-headlines, full article text instead of 200-character excerpts, and no 24-hour delay - [Migrating from GNews](https://docs.apitube.io/platform/migrations/from-gnews.md): Move from GNews.io v4 to APITube — parameter mapping for /api/v4/search, up to 250 articles per request instead of 10, and no pagination depth limit - [Migrating from NewsCatcher](https://docs.apitube.io/platform/migrations/from-newscatcher.md): Move from NewsCatcher News API v3 to APITube — parameter mapping for /api/search, IPTC tags without a plan upgrade, and self-serve signup instead of a sales call - [Migrating from NewsData.io](https://docs.apitube.io/platform/migrations/from-newsdata-io.md): Move from NewsData.io v1 to APITube — parameter mapping for /api/1/latest, sentiment and AI entities on every plan instead of $349 and $1,299 tiers - [Migrating from Mediastack](https://docs.apitube.io/platform/migrations/from-mediastack.md): Move from Mediastack v1 to APITube — parameter mapping for /v1/news, full article text instead of excerpts, and enrichment Mediastack does not offer at any price - [Migrating from NewsAPI.ai](https://docs.apitube.io/platform/migrations/from-newsapi-ai.md): Move from NewsAPI.ai / Event Registry to APITube — Wikipedia URI translation, sentiment in every language instead of English only, and plain values instead of identifier lookups - [Migrating from The News API](https://docs.apitube.io/platform/migrations/from-thenewsapi.md): Move from The News API (thenewsapi.com) to APITube — parameter mapping for /v1/news/all, 250 articles per request instead of 3 (10 on Free, 50 on Starter, 200 on Basic), and enrichment on every plan - [Migrating from World News API](https://docs.apitube.io/platform/migrations/from-worldnewsapi.md): Move from World News API (worldnewsapi.com) to APITube — entity filters map one-to-one, geo search carries over, and the operator precedence inverts in a way that changes results silently - [Migrating from Marketaux](https://docs.apitube.io/platform/migrations/from-marketaux.md): Move from Marketaux (api.marketaux.com) to APITube — why ticker filters have no equivalent, how entity sentiment maps precisely, and when this migration is the wrong idea - [Migrating from Perigon](https://docs.apitube.io/platform/migrations/from-perigon.md): Move from Perigon (goperigon.com) to APITube — parameter mapping for /v1/all, the 0-indexed paging trap, the inverted default operator, and how the two sentiment models convert - [Migrating from SerpApi Google News](https://docs.apitube.io/platform/migrations/from-serpapi.md): Move from SerpApi's engine=google_news to APITube — operator mapping for site:/when:, pagination that SerpApi does not have, and the article body that removes your scraping stage - [Migrating from ScrapingBee](https://docs.apitube.io/platform/migrations/from-scrapingbee.md): Move news collection from ScrapingBee to APITube — what converts, what stays a scrape, and the credit arithmetic behind the decision - [Migrating from Quantexa (Aylien) News API](https://docs.apitube.io/platform/migrations/from-quantexa.md): Move from Quantexa News API v6 to APITube — AQL entity blocks rewritten as parameters, cursor paging replaced by page numbers, and the three endpoints that need rebuilding - [Migrating from Bing News Search API](https://docs.apitube.io/platform/migrations/from-bing-news.md): The Bing Search APIs were retired in August 2025 — move from /v7.0/news to APITube with parameter mapping, a compatibility shim, and no Azure project required - [Migrating from the GDELT DOC 2.0 API](https://docs.apitube.io/platform/migrations/from-gdelt.md): Move from GDELT's free research dataset to APITube — what converts, what GDELT still does better, and the rate limit that decides your timeline ### Integration Guide - [Integration Guide — Getting Started](https://docs.apitube.io/platform/news-api/integrations/getting-started.md): Learn how to integrate APITube News API into your application using 30+ programming languages and frameworks - [Code Examples in 32 Languages](https://docs.apitube.io/platform/news-api/integrations/code-examples.md): Ready-to-run APITube News API requests for cURL, Python, Node.js, PHP, Java, Go and 26 more languages. Pick a language once and every code sample in the docs opens on it. - [OpenAPI Specification](https://docs.apitube.io/platform/news-api/integrations/openapi.md): APITube News API OpenAPI 3.0 specification for code generation, documentation, and client SDK building #### Code examples ##### Zig - [std.http for Zig](https://docs.apitube.io/platform/news-api/integrations/zig/http-client.md): Integrate APITube News API with Zig applications using the standard library HTTP client #### No-code platforms - [n8n Integration](https://docs.apitube.io/platform/news-api/integrations/n8n.md): Automate news monitoring workflows with APITube News API and n8n — no coding required - [Zapier Integration](https://docs.apitube.io/platform/news-api/integrations/zapier.md): Automate news monitoring workflows with APITube News API and Zapier — no coding required - [Make (Integromat) Integration](https://docs.apitube.io/platform/news-api/integrations/make.md): Automate news monitoring workflows with APITube News API and Make (formerly Integromat) — no coding required