{"uid":"cap_P2WAwUn_Irupab4LJlc5c","slug":"agents-openwebninja-com-topic-headlines-real-time-news-d5ce5f71","name":"Topic Headlines – Real-Time News","description":"Get the latest news headlines for a topic (World,  Sports, Technology, etc) or publication (e.g. CNN, BBC, etc).","url":"https://agents.openwebninja.com/realtime-news-data/topic-headlines?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["topic"],"properties":{"limit":{"type":"integer","default":500,"maximum":500,"minimum":1,"description":"Maximum number of news articles to return."},"topic":{"enum":["WORLD","NATIONAL","BUSINESS","TECHNOLOGY","ENTERTAINMENT","SPORTS","SCIENCE","HEALTH"],"type":"string","example":"WORLD","description":"Topic or publication for which to get news headlines.  \n  In addition, topic / publication IDs are also accepted and can be taken from a News topic URL as it appears after the topics/ or publications/ path part (e.g. Football Topic - /topics/CAAqJQgKIh9DQkFTRVFvSUwyMHZNREoyZURRU0JXVnVMVWRDS0FBUAE)."},"country":{"type":"string","default":"us","description":"Country code. See all available country codes."},"language":{"type":"string","default":"en","description":"The language to use for the results, specified as a 2-letter language code - see ISO 639-1 alpha-2."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["title","link"],"properties":{"link":{"type":"string","description":"Canonical URL of the article."},"title":{"type":"string","description":"Headline of the news article."},"authors":{"type":"array","items":{"type":"string","description":"A single author name."},"nullable":true,"description":"Author names credited on the article."},"snippet":{"type":"string","nullable":true,"description":"Short excerpt of the article body."},"photo_url":{"type":"string","nullable":true,"description":"URL of the article's lead image."},"source_url":{"type":"string","nullable":true,"description":"Homepage URL of the source publisher."},"source_name":{"type":"string","nullable":true,"description":"Publisher name of the source."},"sub_articles":{"type":"array","items":{"type":"object","required":["title","link"],"properties":{"link":{"type":"string","description":"Canonical URL of the sub-article."},"title":{"type":"string","description":"Headline of the sub-article."},"photo_url":{"type":"string","nullable":true,"description":"URL of the sub-article's lead image."},"thumbnail_url":{"type":"string","nullable":true,"description":"URL of the sub-article's thumbnail image."},"published_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime of the sub-article's publication."}}},"nullable":true,"description":"Related sub-articles that Google News groups with this headline."},"thumbnail_url":{"type":"string","nullable":true,"description":"URL of the article's thumbnail image."},"related_topics":{"type":"array","items":{"type":"object","required":["topic_id","topic_name"],"properties":{"topic_id":{"type":"string","description":"Google News topic ID."},"topic_name":{"type":"string","description":"Topic display name."}}},"nullable":true,"description":"Related Google News topics surfaced for the article."},"source_logo_url":{"type":"string","nullable":true,"description":"URL of the source publisher's logo."},"source_favicon_url":{"type":"string","nullable":true,"description":"URL of the source publisher's favicon."},"source_publication_id":{"type":"string","nullable":true,"description":"Google News publication ID of the source."},"published_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime of original publication."}}},"description":"News article results for the requested topic."},"status":{"type":"string","description":"The status of the response"},"request_id":{"type":"string","description":"A unique identifier for the request"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_gj2PRSUWRgXSBDowExzxD","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Returns the latest news headlines for a given topic category (World, Sports, Technology, etc.) or specific publication, with metadata like title, snippet, author, and source.","exampleAgentPrompt":"Pull the latest TECHNOLOGY news headlines from Google News — up to 50 articles, for the US in English — and give me the title, source, and a short snippet for each.","exampleUseCases":[{"title":"Morning news briefing for agent","prompt":"Give me today's top WORLD news headlines — up to 20 articles in English for the US — with the headline, source name, and a one-line snippet for each so I can do a morning briefing."},{"title":"Sports scores and stories tracker","prompt":"What are the latest SPORTS news headlines right now? Fetch up to 30 stories in English, US, and include the title, source, and article link for each."},{"title":"Tech industry news digest","prompt":"I need the latest TECHNOLOGY news headlines — grab up to 50 articles in English for the US — and list the headline, the publisher name, and a short excerpt for each one."}],"resultDescription":"Returns an array of news article objects, each containing a headline, canonical article URL, optional snippet, author list, source publisher name and URL, thumbnail and photo URLs, related Google News topics, and grouped sub-articles. Up to 500 articles can be returned per call.","failureModes":["Invalid or unsupported topic enum value returns a 400 or empty result","Unsupported country code or language code may return an empty dataset or default-language results","Requesting more than 500 articles (limit > 500) returns a validation error","Payment/authentication failure returns a 402 or 401 response","Network timeout if the upstream Google News scrape is slow"],"whenToPreferThis":"Choose this endpoint when you need categorized, real-time news headlines aligned to Google News topic buckets (World, Sports, Technology, Business, Health, Science, Entertainment, National) or want to filter by country and language. Prefer it over search-based news endpoints when you want curated topic-level aggregation rather than keyword search results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:38.502Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-topic-headlines-real-time-news-d5ce5f71"}