{"uid":"cap_6W5i3TwXp6kl1VsGUlX4D","slug":"agents-openwebninja-com-top-headlines-news-api-e38cc9e0","name":"Top Headlines News API","description":"Get the latest news headlines/top stories for a country.","url":"https://agents.openwebninja.com/realtime-news-data/top-headlines?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":500,"maximum":500,"minimum":1,"description":"Maximum number of news articles to return."},"country":{"type":"string","description":"Country code. See all available country codes. Default: US"},"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."},"authors":{"type":"array","items":{"type":"string","description":"A single sub-article author name."},"nullable":true,"description":"Author names credited on the sub-article."},"photo_url":{"type":"string","nullable":true,"description":"URL of the sub-article's lead image."},"source_url":{"type":"string","nullable":true,"description":"Homepage URL of the sub-article's source publisher."},"source_name":{"type":"string","nullable":true,"description":"Publisher name of the sub-article's source."},"thumbnail_url":{"type":"string","nullable":true,"description":"URL of the sub-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 for the sub-article."},"source_logo_url":{"type":"string","nullable":true,"description":"URL of the sub-article source's logo."},"source_favicon_url":{"type":"string","nullable":true,"description":"URL of the sub-article source's favicon."},"source_publication_id":{"type":"string","nullable":true,"description":"Google News publication ID of the sub-article source."},"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":"Top headline news articles for the requested country / language."},"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_rFhJHgumSv0EKPBn3gnqF","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":"Fetches the latest top news headlines and stories for a given country and language via real-time web data.","exampleAgentPrompt":"What are the top news headlines in the US right now? Grab up to 20 stories in English.","exampleUseCases":[{"title":"Daily news briefing for US users","prompt":"Can you pull the top 10 news headlines in the US in English so I can do a quick morning briefing?"},{"title":"Country-specific news for foreign market","prompt":"Fetch the top 50 news headlines from France in French — I need to see what's trending there right now."},{"title":"Multilingual news monitoring dashboard","prompt":"Get me the latest top headlines from Brazil in Portuguese, up to 100 stories, so I can monitor what's happening there today."}],"resultDescription":"Returns an array of news article objects, each containing the headline title, canonical article URL, optional snippet/excerpt, author names, publisher name and URL, lead image URL, thumbnail URL, and optionally a list of sub-articles with similar fields plus related Google News topic IDs and names.","failureModes":["Invalid or unsupported country code returns empty data or error","Unsupported language code may return no results or default to English","Limit value outside 1-500 range returns validation error","Real-time data unavailability causes empty or stale result sets","Payment/authentication failure returns 402 or 401 error"],"whenToPreferThis":"Choose this endpoint when you need real-time, country-specific top news headlines with rich metadata (authors, images, sub-articles, related topics) rather than keyword-based news search. It is ideal for building news briefings, monitoring current events for a specific country, or aggregating trending stories across multiple countries by making parallel calls. Prefer this over search-based news endpoints when you want the current editorial front-page selection rather than query-matched results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:45.347Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-top-headlines-news-api-e38cc9e0"}