{"uid":"cap_mibepGjUJvxCjLmt0bAHd","slug":"web-search-ranked-results-24652c8c","name":"Web Search: Ranked Results","description":"Web search: ranked results (title + url) for a query. ?q=x402+agent+payments&limit=8","url":"https://pyfile-agent.taile3ff35.ts.net:10000/data/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","properties":{"q":{"type":"string"},"limit":{"type":"number"}}}}},"output":{"type":"object","properties":{"query":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ul6yEWTY4eX3Ln2NVGrlb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ranked web search results (title + URL) for a given query string, with optional result count limit.","exampleAgentPrompt":"Search the web for 'x402 agent payments' and give me the top 8 ranked results with their titles and URLs.","exampleUseCases":[{"title":"Research a niche crypto topic","prompt":"Search the web for 'DeFi yield aggregators 2024' and return up to 10 results with titles and URLs so I can review the top sources."},{"title":"Find competitor product pages","prompt":"Can you search the web for 'AI agent payment protocols' and give me the first 5 results — just the page titles and links?"},{"title":"Verify coverage of a news event","prompt":"Search the web for 'Base network outage June 2024' and show me up to 8 ranked results with titles and URLs."}],"resultDescription":"A JSON object containing the original query string and an array of ranked result objects, each with a 'title' (page title) and 'url' (page URL) field.","failureModes":["Missing or empty 'q' parameter returns an error or empty results","Very high 'limit' values may be capped or ignored","Queries returning no results yield an empty results array","Network or upstream search provider downtime returns a 5xx error","Malformed query strings may return unexpected results"],"whenToPreferThis":"Use this endpoint when you need lightweight, fast web search results consisting of ranked page titles and URLs — ideal for agent workflows that need to discover relevant web pages, gather links for further processing, or surface current information without full page content. Prefer it over heavier scraping or content-extraction endpoints when just titles and URLs suffice.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T07:02:03.120Z","isFirstParty":false}