{"uid":"cap_6gdIpaNv00v36HxDjvhfY","slug":"agents-openwebninja-com-local-headlines-geo-e52d0784","name":"Local Headlines (Geo)","description":"Get local, geo based headlines.","url":"https://agents.openwebninja.com/realtime-news-data/local-headlines?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"limit":{"type":"integer","default":500,"maximum":500,"minimum":1,"description":"Maximum number of news articles to return."},"query":{"type":"string","example":"New York","description":"Area, city or country to fetch news for (e.g. London)."},"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."},"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":"Local headline news articles for the requested locale."},"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_2nH0k4TczFVyFEbmA-sqJ","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":"Fetch real-time, geo-targeted local news headlines for a specified city, region, or country.","exampleAgentPrompt":"What are the latest local headlines in Chicago right now? Give me up to 20 articles in English.","exampleUseCases":[{"title":"Morning local news briefing","prompt":"Pull the top 10 local news headlines for San Francisco this morning so I can see what's going on in the city today."},{"title":"Monitoring news in foreign city","prompt":"I need the latest local news from Tokyo in English — fetch up to 50 articles so I can keep up with what's happening there."},{"title":"Spanish-language regional news","prompt":"Get me the latest local headlines from Mexico City in Spanish, up to 30 articles, so I can see what the local press is covering."}],"resultDescription":"Returns an array of news articles, each containing a headline title, canonical article URL, optional snippet/excerpt, authors, publication datetime in UTC, source name and URL, thumbnail and photo URLs, source logo/favicon, and related Google News topic tags. Also includes a status string and unique request ID.","failureModes":["Empty or vague query returns no results or irrelevant articles","Invalid country code may fall back to default 'us' or return an error","Unsupported language code may return results in a fallback language","Rate limits or payment issues may return 402 or 429 status codes","Very small or obscure localities may return sparse or no results","Limit parameter above 500 is capped at maximum of 500"],"whenToPreferThis":"Choose this endpoint when you need geo-targeted, real-time local news headlines for a specific city, region, or country. It is ideal when the user cares about local relevance rather than global top stories, and when filtering by language and country is important. Prefer this over general news search endpoints when locality is the primary filter rather than topic or keyword.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:02.516Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-local-headlines-geo-e52d0784"}