{"uid":"cap_pcYJfMiqGWmvCgHjU-INA","slug":"you-com-search-api-8c400414","name":"You.com Search API","description":"You.com Search API: real-time web search returning ranked results grouped by section (results.web, results.news), each with url, title and description; web results also carry snippets. Use when an agent needs fresh, citable web data (news, markets, company facts) to ground a decision. Query params: query (required), count 1-100 (default 10), livecrawl (web|news|all; fetches live page contents, charged per result), country, freshness. Paid per call in USDC.","url":"https://api.you.com/v1/search?utm_source=zero.xyz","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"count":{"type":"integer","default":10,"maximum":100,"minimum":1,"description":"Number of results to return, capped at 100. Also sets the number of pages charged for when livecrawl is enabled."},"query":{"type":"string","maxLength":40000,"description":"The web search query."},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code for geographic focus."},"freshness":{"type":"string","description":"Recency filter: day | week | month | year, or a date range 'YYYY-MM-DDtoYYYY-MM-DD'."},"livecrawl":{"enum":["web","news","all"],"type":"string","description":"Fetch live page contents for the results instead of serving index snippets alone. Priced per result on top of the base call price, so the quoted amount scales with count. Omit for the base price."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["results","metadata"],"properties":{"results":{"type":"object","properties":{"web":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"Result URL."},"title":{"type":"string"},"contents":{"type":"object","description":"Scraped page contents, keyed by requested format (default 'html'). Present only when livecrawl was requested and the fetch succeeded."},"page_age":{"type":"string","description":"Publication timestamp, when the source exposes one. Naive ISO-8601 ('2026-08-01T14:02:00') — no timezone offset and no trailing 'Z'."},"snippets":{"type":"array","items":{"type":"string"},"description":"Index snippets matching the query. Emitted on 'web' results; 'news' results carry 'description' instead and have no snippets."},"description":{"type":"string"},"favicon_url":{"type":"string"},"source_name":{"type":"string"},"thumbnail_url":{"type":"string"},"original_thumbnail_url":{"type":"string"}}}},"news":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"Result URL."},"title":{"type":"string"},"contents":{"type":"object","description":"Scraped page contents, keyed by requested format (default 'html'). Present only when livecrawl was requested and the fetch succeeded."},"page_age":{"type":"string","description":"Publication timestamp, when the source exposes one. Naive ISO-8601 ('2026-08-01T14:02:00') — no timezone offset and no trailing 'Z'."},"snippets":{"type":"array","items":{"type":"string"},"description":"Index snippets matching the query. Emitted on 'web' results; 'news' results carry 'description' instead and have no snippets."},"description":{"type":"string"},"favicon_url":{"type":"string"},"source_name":{"type":"string"},"thumbnail_url":{"type":"string"},"original_thumbnail_url":{"type":"string"}}}}},"description":"Page results keyed by section: 'web' and 'news'. A section is omitted when it returned no results, so do not assume any key is present; an all-empty response is '{}'.","additionalProperties":{"type":"array"}},"metadata":{"type":"object","required":["query","search_uuid","latency"],"properties":{"query":{"type":"string","description":"The query as searched."},"latency":{"type":"number","description":"Server-side latency in seconds."},"search_uuid":{"type":"string","description":"Request identifier, useful when reporting issues."}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"0.5000","medianCents":"0.5000","p90Cents":"0.5000","minCents":"0.5000","maxCents":"0.5000","p95Cents":"0.5000","sampleCount":1,"varies":false,"failureChargeRate":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_HK8wdoC1omu3L2d90BW-m","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Real-time web and news search returning ranked, sectionable results with URLs, titles, descriptions, snippets, and optional live-crawled page contents","exampleAgentPrompt":"Search You.com for the latest news about Nvidia's earnings results from the past week and return the top 10 results with snippets so I can cite specific sources.","exampleUseCases":[{"title":"Breaking news monitoring for analyst","prompt":"Search You.com for news about the Federal Reserve interest rate decision from the last day and give me the top 5 results with snippets — I need fresh, citable sources for a briefing."},{"title":"Company fact-checking before a pitch","prompt":"Look up recent web information about Stripe's latest funding round and valuation — search You.com and pull back 10 results so I can verify the facts before my investor call."},{"title":"Live page content extraction for research","prompt":"Search You.com for 'climate change policy 2025' with livecrawl set to web so I get the actual page contents, not just snippets — return 5 results from the past month."}],"resultDescription":"A JSON object with a 'results' field containing 'web' and/or 'news' arrays. Each web result includes url, title, snippets (index excerpts), optional page_age, and optional 'contents' (scraped page HTML/text when livecrawl is requested). News results include url, title, and description. A 'metadata' field accompanies the results.","failureModes":["Missing required 'query' parameter returns a 400 error","count exceeding 100 is rejected","Invalid country code may return no geographically filtered results","livecrawl fetch failures result in missing 'contents' fields for affected results","Freshness date range in wrong format returns an error","Insufficient USDC balance for per-call or per-livecrawl-result pricing causes payment failure"],"whenToPreferThis":"Choose this endpoint when an agent needs fresh, real-time web or news data with citable URLs and snippets to ground decisions, fact-check claims, or monitor recent events. Prefer it over static knowledge bases when recency matters (news, markets, company updates). The livecrawl option is valuable when full page contents are needed beyond index snippets. The country and freshness filters make it especially useful for geo-targeted or time-bounded research.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-09-24T19:17:41.180Z","lastSuccessfullyRanAt":"2026-09-24T19:17:41.180Z","lastHealthCheckAt":"2026-10-12T06:30:52.086Z","isFirstParty":false,"canonicalSlug":"you-com-search-api-8c400414"}