{"uid":"cap_1R3Vd8K2BU_J-DI-Gk__N","slug":"squeezeos-web-research-api-single-call-b93f1d23","name":"SqueezeOS Web Research API — Single Call","description":"Web research API for AI agents — search the public web and safely extract source evidence in one $0.003 accepted-delivery x402 call.","url":"https://squeezeos-api.onrender.com/api/web/research/once","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","const":"GET"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":400,"minLength":1,"description":"General-web research query Search intents: web research api, web research api for ai agents, ai research api, web search api, search and extract, agent research."},"max_chars":{"type":"string","description":"Maximum extracted characters per source Search intents: web research api, web research api for ai agents, ai research api, web search api, search and extract, agent research."},"fetch_count":{"type":"string","description":"Public source pages to safely extract, 1-3 Search intents: web research api, web research api for ai agents, ai research api, web search api, search and extract, agent research."},"search_count":{"type":"string","description":"Search results to inspect Search intents: web research api, web research api for ai agents, ai research api, web search api, search and extract, agent research."}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object"}},"additionalProperties":false}},"additionalProperties":false},"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_Jp465p__U_bI_JaRD-UM5","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":"Searches the public web and extracts source content for a given query in a single x402-paid API call","exampleAgentPrompt":"Search the web for 'latest FDA drug approval process changes 2024' and extract the full text from the top 2 sources so I can read the actual evidence.","exampleUseCases":[{"title":"Competitive intelligence research for a product","prompt":"Look up 'best AI coding assistants 2024 comparison' on the web and pull the content from the top 3 pages so I can see what reviewers are actually saying."},{"title":"Fact-checking a news claim","prompt":"Search the web for 'EU AI Act enforcement timeline' and extract the text from 2 sources — I need the real evidence to verify what I heard."},{"title":"Market background research for an investment memo","prompt":"Research 'lithium battery supply chain bottlenecks 2024' on the web and give me extracted content from 2 pages, up to 3000 characters each."}],"resultDescription":"A JSON object containing extracted text content from one to three public web pages that matched the query, along with source URLs and evidence snippets suitable for agent reasoning or citation.","failureModes":["Query string missing or empty — 400 error returned","fetch_count or search_count out of supported range (1-3) — parameter ignored or clamped","Target page blocks automated access — extraction returns empty or partial content","Payment not accepted or x402 handshake fails — 402 response, no content returned","Service cold-start latency on Render free tier — occasional timeout on first request"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to ground its reasoning in real, live public web sources with a single low-cost call. It is ideal for one-shot research tasks where both search and content extraction are needed together, rather than calling a search API and a scraper separately. At $0.003 per call with x402 micropayment support, it suits agentic workflows that need pay-per-use economics without subscriptions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:54.968Z","isFirstParty":false}