{"name":"NBC News Headlines API","description":"Headlines from NBC News section pages, such as Politics, U.S. News and Investigations, with title, summary line, date, topic label, image and article link.","api_id":"generated_e1edf6c2f9ebc2190f75d362","slug":"nbc-news-headlines-api","source":{"name":"NBC News","domain":"nbcnews.com","url":"https://www.nbcnews.com/"},"category":"news_content","countries":["US"],"languages":["en"],"record_types":[],"tags":[],"limitations":["Choose one of the site's sections with the collection input; each run reads the headlines on that section's page.","Some headlines have no topic label."],"updated":"2026-11-15","note":"Sample records are saved samples, not a live run. CleanedWeb is not affiliated with the source.","version":"1.0","versions":[{"major":1,"latest_minor":"1.0","status":"current","sunset_at":null}],"changelog":[{"version":"1.0","date":"2026-11-14T16:15:34.000Z","kind":"major","changes":[]}],"version_note":"Pin a major with \"version\": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.","endpoints":[{"endpoint_id":"generated_e1edf6c2f9ebc2190f75d362_search","name":"Extract records","description":"Return records within the accepted scope.","definition_version":"ee4382aff6737697a3b79e73ce803274a82647f5c187140c221e61d0ac832c79","method":"POST","path":"/v1/catalog/public/apis/generated_e1edf6c2f9ebc2190f75d362/endpoints/generated_e1edf6c2f9ebc2190f75d362_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_e1edf6c2f9ebc2190f75d362/endpoints/generated_e1edf6c2f9ebc2190f75d362_search/run","authentication":{"type":"bearer","scheme":"Authorization: Bearer <API key>","scope":"run","note":"Reading this file and the live catalog needs no credential. A run needs a CleanedWeb account and uses the credits of its workspace.","docs":"https://cleanedweb.com/docs/run-catalog-api/"},"required_headers":[{"name":"Authorization","value":"Bearer YOUR_API_KEY","description":"An API key with the run scope."},{"name":"Idempotency-Key","value":"UNIQUE_REQUEST_ID","description":"Required. Save it before you send; reuse it only to retry the same request and to read the result. 1-200 characters: letters, numbers, . _ : -"},{"name":"Content-Type","value":"application/json","description":"The body is JSON."}],"request_body":{"input":"An object that follows input_schema.","max_items":"Optional. Stop after this many records.","timeout_seconds":"Optional, 60-86400, default 10800.","wait_seconds":"Optional, 0-86400, default 90. How long the request waits before answering 202.","version":"Optional integer major. Leave it out for the latest major."},"input_schema":{"type":"object","properties":{"collection":{"type":"string","enum":["Politics","U.S. News","Investigations"],"description":"Choose an independently verified source collection/filter route. Omit it to read the pasted collection itself."}},"required":[],"additionalProperties":false},"output_schema":{"type":"object","additionalProperties":false,"required":["title","url"],"properties":{"image_alt":{"type":"string"},"image_url":{"type":"string"},"related_title":{"type":"string"},"related_url":{"type":"string"},"title":{"type":"string"},"unibrow_container":{"type":"string"},"unibrow_text":{"type":"string"},"url":{"type":"string","format":"uri"},"wide_tease_date":{"type":"string","format":"date","x-precision":"day","description":"ISO 8601 value computed from the source's relative date text (such as '3 months ago') at delivery time; precise to about one day."},"wide_tease_dek":{"type":"string"},"wide_tease_headline":{"type":"string"}}},"examples":[{"kind":"saved_validation_records","saved_at":"2026-11-14T16:15:34.722Z","live_verified":false,"request":{"input":{}},"records_shown":2,"records_saved":2,"records":[{"image_alt":"Pope Leo XIV.","image_url":"https://media-cldnry.s-nbcnews.com/image/upload/t_focal-200x200,f_avif,q_auto:best/rockcms/2026-11/2261113-pope-leo-peru-ch-1106-94bd4d.jpg","related_title":"Pope Leo XIV","related_url":"https://www.nbcnews.com/world/pope-leo-xiv","title":"Pope Leo makes emotional return to his ‘beloved diocese of Chiclayo’","unibrow_container":"Pope Leo XIV","unibrow_text":"Pope Leo XIV","url":"https://www.nbcnews.com/world/pope-leo-xiv/pope-leo-peru-emotional-return-diocese-chiclayo-rcna608940","wide_tease_date":"2026-11-13","wide_tease_dek":"While the pope hails from Chicago, it was in the Peruvian city that he made his mark.","wide_tease_headline":"Pope Leo makes emotional return to his ‘beloved diocese of Chiclayo’"},{"image_alt":"A fighter jet on a tarmac.","image_url":"https://media-cldnry.s-nbcnews.com/image/upload/t_focal-200x200,f_avif,q_auto:best/rockcms/2026-11/261113-Lakenheath-england-base-ww-1347-40387f.jpg","title":"Drone activity over U.S. base in Britain prompts security response, U.S. military says","unibrow_container":"United Kingdom","url":"https://www.nbcnews.com/world/united-kingdom/drone-activity-us-base-britain-prompts-security-response-us-military-s-rcna609255","wide_tease_date":"2026-11-13","wide_tease_dek":"Security forces at Royal Air Force Base Lakenheath in eastern England responded to suspected unauthorized drone activity, but no personnel, aircraft or infrastructure have been affected, the U.S. Air Force in Europe said in a statement.","wide_tease_headline":"Drone activity over U.S. base in Britain prompts security response, U.S. military says"}]}],"request_example":{"body":{"input":{"collection":"Politics"},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_e1edf6c2f9ebc2190f75d362/endpoints/generated_e1edf6c2f9ebc2190f75d362_search/run \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Idempotency-Key: UNIQUE_REQUEST_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"input\": {\n    \"collection\": \"Politics\"\n  },\n  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_e1edf6c2f9ebc2190f75d362/endpoints/generated_e1edf6c2f9ebc2190f75d362_search/result","note":"A run that does not end within wait_seconds answers 202. Read the result with the same API key and the same Idempotency-Key."},"links":{"page":"https://cleanedweb.com/catalog/nbc-news-headlines-api/","markdown":"https://cleanedweb.com/catalog/nbc-news-headlines-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_e1edf6c2f9ebc2190f75d362/endpoints/generated_e1edf6c2f9ebc2190f75d362_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/nbc-news-headlines-api/","markdown":"https://cleanedweb.com/catalog/nbc-news-headlines-api/index.md","contract":"https://cleanedweb.com/catalog/nbc-news-headlines-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
