{"uid":"cap_oIEbYt5D0dEXztHY5NDH-","slug":"newsapi-top-headlines-af5e4e36","name":"NewsAPI Top Headlines","description":"Breaking headlines by country, category or keyword.","url":"https://gateway.apiosk.com/newsapi/top-headlines","method":"GET","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.066","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XWifS_4ZsVPEQJmP7GDH-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches top news headlines filtered by keyword, country, and/or category via the NewsAPI service","exampleAgentPrompt":"Can you get me the top news headlines in the US for the technology category right now?","exampleUseCases":[{"title":"Breaking news monitoring for a topic","prompt":"What are the latest top headlines about artificial intelligence right now? I want to see what's currently being reported."},{"title":"Country-specific daily news briefing","prompt":"Pull the top headlines from Germany for me this morning so I can get a quick news briefing before my meeting."},{"title":"Category-filtered news for business research","prompt":"Fetch the top business news headlines right now — I need to catch up on what's moving in markets and corporate news today."}],"resultDescription":"Returns a list of top news headline articles matching the query, country, and/or category filters. Each article typically includes a title, source name, description, publication date, and URL to the full article.","failureModes":["Invalid or unsupported country code returns empty results or error","Category value not in accepted enum list causes bad request","No results found for very niche keyword queries","Rate limiting or payment failure returns 402 or 429 error","API key or gateway authentication issues return 401/403"],"whenToPreferThis":"Use this endpoint when you need current, real-time top news headlines filtered by country, topic keyword, or category. Prefer it over general web search when you specifically want structured news article metadata (title, source, URL, date) from established news outlets rather than raw web results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:47:36.448Z","isFirstParty":false}