{"uid":"cap_8sKLu64ktPasdpfYAx1Rw","slug":"agents-openwebninja-com-google-news-real-time-search-682e486c","name":"Google News Real-Time Search","description":"Search Google News for any query and get real-time news results. Returns a top stories cluster (when available for the query), main news results with article metadata, source info, thumbnails, and published dates (both localized relative text and ISO 8601 UTC). Supports pagination, filtering by time period or custom date range, country, language, sort order, and safe search.","url":"https://agents.openwebninja.com/real-time-news-search/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"page":{"type":"integer","default":1,"minimum":1,"description":"Page number for pagination. Each page returns up to 10 news results.\n\n**Allowed values:** `1` and above."},"safe":{"enum":["off","active"],"type":"string","default":"off","description":"Safe search setting to filter explicit content.\n\n**Allowed values:** `off`, `active`\n\n**Default:** `off`"},"query":{"type":"string","description":"The news search query.\n\n**Examples:**\n\n`climate change`\n\n`artificial intelligence startups`\n\n`bitcoin price 2026`"},"country":{"type":"string","default":"us","description":"Country code of the country to return news results for. See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 for supported values.\n\n**Default:** `us`"},"date_to":{"type":"string","description":"End date for a custom date range filter, in `MM/DD/YYYY` format. Must be provided together with `date_from`.\n\n**Example:** `04/10/2026`"},"sort_by":{"enum":["relevance","date"],"type":"string","default":"relevance","description":"Sort order for the results.\n\n**Allowed values:** `relevance`, `date`\n\n**Default:** `relevance`"},"language":{"type":"string","default":"en","description":"The language of the results, specified as a 2-letter language code - see ISO 639-1.\n\n**Default:** `en`"},"location":{"type":"string","description":"Geographic area for news."},"date_from":{"type":"string","description":"Start date for a custom date range filter, in `MM/DD/YYYY` format. Must be provided together with `date_to`. Cannot be used together with `time_period` (other than `any`).\n\n**Example:** `01/01/2026`"},"time_period":{"enum":["any","last_hour","last_day","last_week","last_month","last_year"],"type":"string","default":"any","description":"Filter results to a specific time period. Cannot be used together with `date_from`/`date_to`.\n\n**Allowed values:** `any`, `last_hour`, `last_day`, `last_week`, `last_month`, `last_year`\n\n**Default:** `any`"}}},"responseSchema":{"type":"object","required":["status","request_id","parameters","data"],"properties":{"data":{"type":"object","required":["news"],"properties":{"news":{"type":"array","items":{"type":"object","required":["title","link","position"],"properties":{"link":{"type":"string","description":"Canonical URL of the article."},"title":{"type":"string","description":"Headline of the news article."},"snippet":{"type":"string","nullable":true,"description":"Short excerpt of the article body."},"position":{"type":"integer","description":"Position of the result within the news list (1-based)."},"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":"Base64 data URL of the article's lead image, when available."},"published_date":{"type":"string","nullable":true,"description":"Localized relative publication date as displayed by Google News."},"source_favicon_url":{"type":"string","nullable":true,"description":"Base64 data URL of the source publisher's favicon."},"published_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime of original publication."}}},"description":"Main news results for the query."},"top_stories":{"type":"array","items":{"type":"object","required":["position","title","link"],"properties":{"link":{"type":"string","description":"Canonical URL of the article."},"title":{"type":"string","description":"Headline of the news article."},"position":{"type":"integer","description":"Position of the story within the top stories cluster (1-based)."},"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":"Base64 data URL of the article's lead image, when available."},"published_date":{"type":"string","nullable":true,"description":"Localized relative publication date as displayed by Google News."},"source_favicon_url":{"type":"string","nullable":true,"description":"Base64 data URL of the source publisher's favicon."},"published_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime of original publication."}}},"nullable":true,"description":"Top stories cluster for the query, when available."}}},"status":{"type":"string","description":"The status of the API response."},"parameters":{"type":"object","properties":{"page":{"type":"integer","description":"Page number for pagination as received."},"safe":{"type":"string","description":"Safe search setting as received. Values: off, active."},"query":{"type":"string","description":"The news search query as received."},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code used for the search."},"date_to":{"type":"string","nullable":true,"description":"End date of the custom date range filter (MM/DD/YYYY), when provided."},"sort_by":{"type":"string","description":"Sort order as received. Values: relevance, date."},"language":{"type":"string","description":"ISO 639-1 language code used for the search."},"date_from":{"type":"string","nullable":true,"description":"Start date of the custom date range filter (MM/DD/YYYY), when provided."},"time_period":{"type":"string","description":"Time window filter as received. Values: any, last_hour, last_day, last_week, last_month, last_year."}},"description":"The parameters the API received and used for this request, echoed back."},"request_id":{"type":"string","description":"A unique ID to trace the API request."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unknown_unparsed","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_bQdkCnYQAqUyX_sONfks_","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":"Searches Google News for any query and returns real-time news articles with metadata including headlines, sources, thumbnails, snippets, and publication dates.","exampleAgentPrompt":"Search Google News for 'electric vehicle battery breakthrough' from the last week, sorted by date, and give me the top 10 results with headlines, sources, and publication timestamps.","exampleUseCases":[{"title":"Breaking news monitoring for a brand","prompt":"Search Google News for 'OpenAI' from the last 24 hours, sorted by date, and show me every article title, source name, and when it was published so I can see what's being said about them right now."},{"title":"Research news within a custom date range","prompt":"Find me Google News articles about 'inflation interest rates' published between 01/01/2026 and 03/31/2026, in English, sorted by relevance — I need the headlines, snippets, and links."},{"title":"Country-specific news in a foreign language","prompt":"Pull the latest Google News results for 'elezioni politiche' in Italy, in Italian, from the last month — give me the top stories with headlines, source names, and publication dates."}],"resultDescription":"Returns a JSON object containing a 'data' field with two arrays: 'news' (main news results, up to 10 per page) and 'top_stories' (a curated top stories cluster when available). Each article includes title, canonical URL, snippet, source name, source URL, source favicon, thumbnail image (base64), localized relative published date, and ISO 8601 UTC publication datetime. Also includes request metadata like status and request_id.","failureModes":["Missing required 'query' parameter returns a 400 validation error","Providing both 'time_period' (non-'any') and 'date_from'/'date_to' simultaneously causes a conflict error","Invalid country code or language code may return empty or unexpected results","Query with no matching news returns an empty news array","Pagination beyond available results returns an empty news array","Service unavailability or upstream Google News changes may return 5xx errors"],"whenToPreferThis":"Choose this endpoint when you need real-time Google News results with rich article metadata (thumbnails, ISO timestamps, source info) and flexible filtering by time period, custom date range, country, language, and sort order. Prefer it over generic web search endpoints when the use case is specifically news discovery, media monitoring, or journalism research. It is especially useful when you need structured, machine-readable news data rather than raw HTML scraping.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:41.961Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-google-news-real-time-search-682e486c"}