# NBC News All-in-One API (`romy/nbc-news-all-in-one-api`) Actor Unofficial always-on REST API for live NBC News data: category feeds (Home, Politics, U.S. News, World, Business, Sports, Health, Science, Culture & Trends, Discover), full-text search with real pagination, video/live listings, and audio/podcast stations. No account needed. - **URL**: https://apify.com/romy/nbc-news-all-in-one-api.md - **Developed by:** [Romy](https://apify.com/romy) (community) - **Categories:** News - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event + usage This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### What does NBC News All-in-One API do? **NBC News All-in-One API** is a REST endpoint for NBC News's live data — category content feeds (Home, Politics, U.S. News, World, Business, Sports, Health, Science, Culture & Trends, Discover), full-text search with real pagination, video/live listings, and audio/podcast stations. All from a single always-on API powered by [Apify Standby](https://docs.apify.com/platform/actors/development/programming-interface/standby). It talks directly to the same internal API the official [NBC News](https://www.nbcnews.com/) Android app uses (`mobileapi.nbcnews.com`), reverse-engineered by live MITM capture against a real device — every endpoint below is a real REST call the app itself sends (captured live, never guessed). No NBC News account, no API key, no scraping setup — call the endpoint, get JSON back. Every endpoint works fully anonymously (confirmed by inspecting real request headers — no Authorization header, no cookie, no session token needed). ### Why use NBC News All-in-One API? - **10 real category feeds** — Home, Politics, U.S. News, World, Business, Sports, Health, Science, Culture & Trends, and a curated Discover feed - **Real, working pagination on search** — confirmed live against the app's own "Load more" button, with a real total-results count - **Video & audio listings** — the app's Watch and Listen tabs, including live station data (audio backed by TuneIn) - **Always-on** — Standby mode means no cold start, responds in milliseconds - **No account needed** — every endpoint works fully anonymously - **Zero competition** — this is the only NBC News data API on Apify Store at the time of writing - **Use cases:** news aggregation, media monitoring, politics/business tracking bots, content pipelines ### Endpoints | Method | Path | Description | | ------ | --------- | -------------------------------------------------------------- | | `GET` | `/news` | Content feed for one category (Home, Politics, U.S. News, ...) | | `GET` | `/search` | Full-text search across articles and videos, with pagination | | `GET` | `/watch` | Video and live-stream listing | | `GET` | `/listen` | Audio/podcast station listing | ### How to use NBC News All-in-One API 1. Open this Actor's Standby API URL (shown on the Actor's page, under the API tab). 2. Call any endpoint — for example: ```bash curl "https://romy--nbc-news-all-in-one-api.apify.actor/news?category=cover" curl "https://romy--nbc-news-all-in-one-api.apify.actor/news?category=us-news" curl "https://romy--nbc-news-all-in-one-api.apify.actor/search?query=trump&page=1" curl "https://romy--nbc-news-all-in-one-api.apify.actor/watch" curl "https://romy--nbc-news-all-in-one-api.apify.actor/listen" ``` Every call needs your Apify API token, either as `Authorization: Bearer ` or `?token=` — the Actor's page API tab has a ready-to-copy version with your token filled in. 3. Read the JSON response — no setup required. ### Parameters **`GET /news`** — `category` required. | Param | Type | Example | Meaning | | ---------- | ---- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `category` | enum | `cover` | `cover` (Home) | `discover` | `politics` | `us-news` | `world-news` | `business` | `sports` | `health` | `science` | `culture-matters`. Any other real category id also works, not restricted to this list. | **`GET /search`** — `query` required. | Param | Type | Example | Meaning | | ------- | -------------- | ------- | ---------------------------------------------------------------------------- | | `query` | string | `trump` | Search text | | `page` | int, default 1 | `1` | 1-indexed page number — real pagination, confirmed via the app's "Load more" | **`GET /watch`** — no parameters. **`GET /listen`** — no parameters. ### Output Every response is returned directly over HTTP — this Actor does not write to an Apify dataset. Responses pass through NBC News's own real (deeply nested) JSON data. Real responses (trimmed to the most relevant fields for readability): `GET /news?category=cover`: ```json { "success": true, "feed": { "data": [ { "type": "SnackMenu", "items": [ { "id": "curation/mobile/news/politics", "header": "Politics" }, { "id": "curation/mobile/news/us-news", "header": "U.S. News" } ] }, { "id": "taxonomy/nbcnews/section/news/us-news", "header": "U.S. News", "items": [ { "id": "rcna593612", "type": "article", "headline": "16-year-old Tennessee girl runs on field and tackles football player mid-game", "url": "https://www.nbcnews.com/news/us-news/16-year-old-tennessee-girl-runs-field-tackles-football-player-game-cha-rcna593612", "published": "2026-08-20T20:13:00Z" } ] } ] } } ``` `GET /search?query=trump&page=1`: ```json { "success": true, "results": { "id": "search", "pagination": { "totalItems": 101566 }, "items": [ { "id": "mmvo268610117573", "type": "video", "headline": "'I am not running for president,' Attorney General Todd Blanche says", "url": "https://www.nbcnews.com/meet-the-press/video/...", "published": "2026-08-20T20:36:44Z", "duration": "00:05:24" } ] } } ``` `GET /listen`: ```json { "success": true, "stations": { "liveSections": [ { "header": "Listen Live", "streams": [{ "station": "NBC News NOW", "description": "Breaking News and In-Depth Analysis" }] } ] } } ``` ### Data notes - **`/news`'s `category` list is confirmed real, not guessed** — captured live from the `cover` feed's own navigation menu, which returns the exact list of category ids the app itself links to. - **`/search`'s `page` param is real, working pagination** — confirmed by tapping the app's own "Load more" button and observing page 1 vs page 2 return genuinely different results. This is different from `/news`, which has none. - **`sort` exists on the underlying search endpoint but does nothing** — confirmed live by comparing results across several values, including a nonsense one, all returning identical date-descending order. Deliberately not exposed here since a parameter with zero real effect would be misleading. - **Article full-text isn't retrievable through this API.** Every item includes a `url` field pointing to the real nbcnews.com article/video page — this Actor doesn't scrape that page's HTML, only the app's own structured metadata (headline, image, published date, category, etc). See Known limitations. - **The app itself has a confirmed navigation bug** in the exact build researched, where tapping most category-tagged content (on both Home and Search) opens a blank page — reproduced live and confirmed to be a pure client-side bug, not a network issue, by calling the same underlying endpoint directly and getting full data back every time. Doesn't affect this Actor since it calls the API directly. ### Pricing Pay-per-event, billed on each successful call. Tiered by your Apify plan (Free/Bronze/Silver/Gold/Platinum/Diamond) — see the Actor's Pricing tab for your exact rate. | Event | Free tier price | | -------- | ---------------- | | `news` | $0.003 | | `search` | $0.004 | | `watch` | $0.003 | | `listen` | $0.002 | ### Known limitations - **No dedicated article-detail endpoint was found.** `/news` and `/search` return rich metadata (headline, image, summary, published date, category) but not full article body text — each item's `url` field points to the real NBC News website if you need the full text. - This is an unofficial, reverse-engineered integration, not affiliated with or endorsed by NBC News or NBCUniversal. Behavior may change if NBC News changes its API. Found a bug or have a feature request? Use the Issues tab on this Actor's page. # Actor input Schema ## Actor input object example ```json {} ``` # Actor output Schema ## `api` (type: `string`): This Actor doesn't write to a dataset — every response is returned directly over HTTP by its Standby web server. See the README / web server OpenAPI schema (webServerSchema) for the full endpoint list and response shapes (GET /news). # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("romy/nbc-news-all-in-one-api").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("romy/nbc-news-all-in-one-api").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call romy/nbc-news-all-in-one-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,romy/nbc-news-all-in-one-api" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/aTj04MdW0S6vyquBC/builds/rRuFmgxcpRH0ucavI/openapi.json