{"uid":"cap_S2pgxM8jV5OLdQmKLVyQe","slug":"pulse402-news-search-api-6cf07cf1","name":"Pulse402 News Search API","description":"Machine-readable paid news search and pulse intelligence over x402 v2.","url":"https://pulse402.6ynqsr8bxd.workers.dev/v1/news/search","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"as_of":"2026-09-01T04:02:00.000Z","query":"nvidia","window":"24h","results":[{"url":"https://example.com/article","tone":null,"title":"Example result title","country":null,"language":"English","source_name":null,"published_at":"2026-09-01T04:02:00.000Z","source_domain":"example.com"}],"request_id":"00000000-0000-4000-8000-000000000000","attribution":{"provider":"GDELT Project (Static Web NGrams)"},"result_count":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","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":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qEG8LUrxlVJTlV16Hff_g","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches recent news articles by keyword query with tone, language, source, and country metadata, paid per-call via x402 micropayment protocol.","exampleAgentPrompt":"Search Pulse402 for the latest news about Nvidia from the past 24 hours and give me the article titles, sources, and tone for each result.","exampleUseCases":[{"title":"Real-time earnings coverage tracker","prompt":"Search for all news articles mentioning 'Apple earnings' from the last 24 hours and summarize the headlines and their tones — I want to know if coverage is positive or negative."},{"title":"Competitor brand monitoring","prompt":"Find recent news articles about Tesla over the past day, including which countries and languages they're in, so I can see how international press is covering them."},{"title":"Breaking geopolitical event lookup","prompt":"Pull the latest news results about the Taiwan Strait from the past 24 hours — I need the article titles, source domains, and publication times."}],"resultDescription":"A JSON object containing the search query, time window, and a list of news article results. Each result includes the article URL, title, publication timestamp, source domain, source name, language, country, and tone (when available). Also includes a result count, request ID, an as_of timestamp, and attribution to the underlying provider (GDELT Project).","failureModes":["Payment not processed or x402 handshake fails — request is rejected before search executes","Query returns zero results if the topic has no indexed coverage in the requested time window","Tone and country fields may be null for many results depending on GDELT data availability","Invalid or missing query parameter causes a 400-level error","Time window parameter not recognized — defaults or errors depending on implementation","Service unavailability on the Cloudflare Workers host returns 5xx errors"],"whenToPreferThis":"Choose this endpoint when you need machine-readable, structured news search results with source metadata (domain, language, country, tone) suitable for AI agent pipelines, and when you want micropayment-based access without API key subscription overhead. Prefer it over traditional news APIs when you need GDELT-backed global coverage or when operating in an x402 payment environment. It is especially useful for agents that need to search news on demand without committing to a subscription tier.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:37:57.942Z","isFirstParty":false}