{"uid":"cap_IFTbCvuXx0qBq86XoRsRx","slug":"agents-openwebninja-com-openweb-ninja-real-time-news-search-1ba5da78","name":"OpenWeb Ninja Real-Time News Search","description":"Search news articles by query with an option to limit the results to a specific time range.","url":"https://agents.openwebninja.com/realtime-news-data/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"limit":{"type":"integer","default":10,"maximum":500,"minimum":1,"description":"Maximum number of news articles to return."},"query":{"type":"string","example":"Elon Musk","description":"Search query for which to get news."},"source":{"type":"string","description":"Domain of the source from which to return news articles."},"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."},"time_published":{"type":"string","default":"anytime","description":"Find news articles published in a specific time range."}}},"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":"News article results matching the search query."},"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_FQh-7DuzcE-y3BsLwJo-A","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 real-time news articles by keyword query with optional filters for time range, source domain, country, and language.","exampleAgentPrompt":"Search for the latest news articles about artificial intelligence regulation published in the last 24 hours, give me up to 20 results in English from US sources.","exampleUseCases":[{"title":"Breaking news monitoring for a brand","prompt":"Find me the latest 15 news articles mentioning Tesla published in the past 24 hours — I want titles, snippets, and source names so I can see what's being reported today."},{"title":"Country-specific news research","prompt":"Search for news about the 2024 French election, limit results to 25 articles, only from French sources, in French, published in the last week."},{"title":"Journalist source tracking","prompt":"Pull up to 30 news articles about climate change published anytime, but only from the domain nytimes.com — I need the headlines, publication dates, and article links."}],"resultDescription":"Returns an array of news article objects, each containing the article headline, canonical URL, short snippet, author list, publication datetime in UTC, source publisher name and URL, related Google News topics, and image URLs (photo and thumbnail). Also includes a request status string and unique request ID.","failureModes":["Missing required 'query' parameter returns a validation error","Invalid country code or language code may return empty results or an error","Requesting more than 500 articles (limit maximum) returns a validation error","Source domain filter with no matching articles returns an empty data array","Service unavailability or upstream Google News issues may return a non-200 status"],"whenToPreferThis":"Choose this endpoint when you need real-time, keyword-searchable news articles with rich metadata (authors, snippets, images, related topics) and need to filter by time range, country, language, or specific publisher domain. It is ideal for news monitoring, media research, or feeding current events into an AI pipeline. Prefer it over generic web search APIs when you specifically need structured news article data rather than general web results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:11.310Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-openweb-ninja-real-time-news-search-1ba5da78"}