{"uid":"cap_HCwVwNelLKzHYgfUyExX0","slug":"web-search-with-serp-results-optional-llm-answer-3822d417","name":"Web Search with SERP Results & Optional LLM Answer","description":"Real-time web search for AI agents — search the web and get ranked SERP-style results as clean JSON: title, URL, snippet, relevance score, optional LLM-generated answer. Find up-to-date information online — latest news, current events, finance. Date, domain and exact-phrase filters.","url":"https://websearch.use.x402atlas.com/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"query":{"type":"string","maxLength":1000,"description":"The search query to execute"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","query","results"],"properties":{"note":{"type":"string","description":"Present only on a sample response (empty/omitted query): a hint to pass a real query. The paid request ran; no upstream call was made."},"query":{"type":"string","description":"The upstream-normalized query that was executed"},"answer":{"type":"string","description":"LLM-generated answer grounded in the results (only when include_answer was set)"},"results":{"type":"array","items":{"type":"object","required":["title","url","content","score"],"properties":{"url":{"type":"string"},"score":{"type":"number","description":"Relevance score"},"title":{"type":"string"},"content":{"type":"string","description":"Relevant snippet from the page"},"raw_content":{"type":"string","description":"Cleaned full page content (only when include_raw_content was set)"}}}},"queried_at":{"type":"string","format":"date-time","description":"Time the search was executed (UTC)"}}}}}}},"responseSchema":{"type":"json","example":{"query":"latest developments in AI agents","results":[{"url":"https://example.com/ai-agents-2026","score":0.87,"title":"AI agents in 2026: what changed","content":"A short, relevant snippet from the page..."}],"queried_at":"2026-07-01T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Bn_8Gs0pw-iSktSxUcKAI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Executes a real-time web search query and returns ranked SERP-style results as structured JSON, with optional LLM-generated answer synthesis.","exampleAgentPrompt":"Search the web for the latest news about OpenAI's newest model release and give me a ranked list of results with a short answer summarizing what you find.","exampleUseCases":null,"resultDescription":"A JSON object containing the normalized query string, a UTC timestamp of when the search ran, an array of ranked results (each with title, URL, snippet/content, and relevance score), and optionally an LLM-generated answer grounded in those results when requested.","failureModes":["Empty query string returns a 400 error","Query exceeding 1000 characters is rejected","No results found for highly niche or misspelled queries returns an empty results array","Network timeouts or upstream search provider outages return 5xx errors","Rate limiting or insufficient payment balance returns a 402 Payment Required error"],"whenToPreferThis":"Choose this endpoint when you need real-time, up-to-date web search results that go beyond LLM training data cutoffs — especially for current events, breaking news, live financial data, or recent product information. Prefer this over static knowledge retrieval when freshness matters, and over raw URL fetching when you need ranked discovery across multiple sources rather than content from a known URL.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:39:22.469Z","isFirstParty":false}