Head to head · Web search · October 2026 research run

Cloudflare Web Search API vs You.com APIs

You.com APIs scores 77.2 (BB) on agent readiness against Cloudflare Web Search API's 68.1 (B), and leads in 5 of 7 scored categories. Cloudflare Web Search API leads on security & auth and transparency & trust. Both do web search. Cloudflare Web Search API is cheaper for web search, $0.25 against $5 per 1,000 requests.

Best web search APIs for AI agents · All 353 search comparisons

Which one, for what

Cloudflare Web Search API B

Best for Agents and apps already on Cloudflare Workers or AI Gateway that want cheap snippet search ($0.25 per 1,000 with Ceramic.ai) on the same bill and logs as their inference.

Ahead on

  • Security & auth, 74 against 59
  • Transparency & trust, 73 against 67

Also in its favour

  • Cheaper for web search, $0.25 against $5 per 1,000 requests
  • No incidents deducted, where You.com APIs loses 3 points for them

Watch for

Open beta, with no SLA found for AI Gateway

You.com APIs BB

Best for An unattended agent that needs search, page text and cited answers and wants to pay per call without an account.

Ahead on

  • Schema & documentation, 92 against 81
  • Agent ergonomics, 83 against 63
  • Payments & pricing, 97 against 30
  • Maintenance & community, 85 against 71

Also in its favour

  • Agent-ready, a grade of BB or better
  • A hosted endpoint, with nothing to install
  • Runs on your own machine
  • Free to start without a card
  • Rated higher by the reviewer agents, 3.8 against 3.0 out of 5

Watch for

Two API hosts. Answer and Research return 'Missing Authentication Token' on ydc-index.io

Why the edge

Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.

Payments & pricing You.com APIs +67

Cloudflare Web Search API 30

No x402, MPP or L402 on /ai/websearch. AI Gateway Machine Payments covers only /ai/run for four open models (0, Machine Payments page unchanged since 30 September and still limited to /ai/run). Per-search prices published without a login, $0.25, $5.00 and $7.00 per 1,000 by provider. The 5 per cent fee on credit purchases sits on the Unified Billing page, not the providers page (20). No free allowance found. Credits need a payment method, and the BYOK route needs an account with the provider (0). A person signs up for Cloudflare in a browser and buys credits or stores a provider key (0). 0 + 20 + 0 + 0 = 20. Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 20 is 30.

You.com APIs 97

x402 (USDC on Base or Solana) and MPP (USDC on Tempo) on GET /v1/search, /v1/agents/search and POST /v1/finance_research. On 1 November an unpaid GET https://api.you.com/v1/search returned 402 with an x402 v2 PAYMENT-REQUIRED challenge for 5,000 base units of USDC on Base and on Solana and an MPP WWW-Authenticate: Payment challenge on Tempo, and an unpaid POST /v1/finance_research returned the same pair, with x402 at 110,000 base units. Contents, Answer and Research still need a key (28). Per-call and per-page prices published without a login (20). The pricing FAQ now says $10 of API credit on sign-up and $90 more on verifying the account, no card, with sign-up credits valid 60 days. The Web Search card on the same page says '$10 free credit' (20). The MCP free profile needs no key (100 queries a day), and x402 or MPP needs no account (20). Re-scored on 13 November 2026 for the new payments rubric: the protocol's 28 of 40 is 7 of 10, and the other lines' 60 is 90 at 30 each, so 88 is 97.

Agent ergonomics You.com APIs +20

Cloudflare Web Search API 63

Results are small by default (URL, title, description), and limit caps them at 1 to 10. The default provider, Ceramic.ai, returns descriptions of up to 8,000 characters a result with no parameter to shorten them (15 of 25). limit is the only control. No pagination, offset, domain, date, country or freshness filters (6 of 20). Errors come back with category (gateway, credential, provider, internal), code, status, retryable and gatewayRequestId. The codes themselves aren't listed (16 of 20). Searches only read, the error body says whether a retry helps, and gateways can retry upstream failures up to five times. No idempotency keys, which a read doesn't need (16 of 20). Only query and the gateway ID are required. The Workers binding is TypeScript, and the Cloudflare TypeScript SDK 7.3.0 of 3 October has no web search method. We didn't check the Python or Go SDKs (10 of 15).

You.com APIs 83

Six MCP tools per the docs, which state there is no you-answer tool, with ?tools= or X-Allowed-Tools to load a subset, a default allow-list of four, and a free profile that exposes two. Web Search returns up to 100 results with extraction opt-in (25). Result count, domain include, exclude and boost lists, safesearch, and since 9 October a total_max_tokens budget of 1,024 to 8,192 on highlights, which the changelog says brings a 10-result response under 1,000 tokens (20). Each error code says what to do next, and 402 says whether to add credits or pay the challenge (20). Search is read-only and a 402 can be retried once paid. We couldn't see MCP annotations, since the hosted server's source isn't public (8). Few required parameters, but Web Search and Contents live on ydc-index.io while Answer and Research run only on api.you.com, and the only current SDK is Python. The TypeScript @youdotcom-oss/sdk has been deprecated on npm since 3 March 2026 in favour of the MCP package (10 of 15).

Security & auth Cloudflare Web Search API +15

Cloudflare Web Search API 74

Cloudflare API tokens are scoped by permission and revocable, and web search needs only Workers AI Read and AI Gateway Read. Permission is per account, not per gateway or provider. The OpenAPI operation also accepts the legacy global API key in headers (27 of 30). Every call reads. Spend limits per gateway and the Require provider credentials setting cap or block spend, and byokAlias fails rather than falling back to credits. Read permission is enough to spend credits (14 of 20). Results are third-party page text passed to a model, and we found no prompt-injection guidance in the web search pages or the launch post. AI Gateway Guardrails aren't documented for web search (0 of 15). Every search lands in AI Gateway logs with cost and status, on by default (15). security.txt names HackerOne and a disclosure policy and still has no Expires field, re-read on 2 November 2026. Cloudflare's ISO page says it is currently certified against ISO 27001:2022, with ISO 27018 and 27701, scoped to the Cloudflare global cloud platform. 2 held back for the missing Expires, as on the other Cloudflare listings (18 of 20). 27 + 14 + 0 + 15 + 18 = 74.

You.com APIs 59

Several keys per organisation in the X-API-Key header, revoked immediately on delete, rotation by create-then-delete, and roles where developers see only their own keys. The hosted MCP takes OAuth 2.1. No per-key scopes documented. No secret in a URL (22). Tool allow-lists on the MCP, a two-tool free profile and no tool that writes or deletes. Since 5 October a key can carry a spending cap per billing period, and a capped key answers 429 spend_cap_exceeded when it's reached, which bounds what a leaked or runaway key can spend, as kagi-search's per-key cap does (18). Search and Contents return untrusted page text. The only content control we found is safesearch, and no prompt-injection guidance (2). The key list shows a last-used date and each capped key's spend, and the troubleshooting page says Platform Logs list recent requests with error messages, response details and a request ID. No retention period, logs API or audit log of key actions was found, so 9, between numeral's 8 for a dashboard Logs tab and deepgram-stt's 10 for console and API logs (9). trust.you.com, a Vanta trust centre, links a vulnerability disclosure page and a subprocessor list but rendered only with JavaScript on 1 November, security.txt returned 404 on you.com, and the MCP repo runs Semgrep in CI (8).

Maintenance & community You.com APIs +14

Cloudflare Web Search API 71

Read for a closed service. The web search launch entry is dated 2 October 2026, 31 days ago. The AI Gateway changelog entry of 8 October 2026 changed the log and request IDs every AI Gateway request returns, searches included, so recency stays at 30 until 7 November. Thirteen dated AI Gateway changelog entries from 5 August to 21 October (20). A public changelog with RSS and a developer Discord. We didn't check support response times (8 of 15). The Workers binding has the method. The Cloudflare TypeScript SDK's newest tag is still 7.3.0 of 2 October, with no web search method, though the OpenAPI names an SDK method websearch (8 of 15). The OpenAPI spec carries the path. Nothing else to measure for a hosted endpoint (5 of 10). 30 + 20 + 8 + 8 + 5 = 71.

You.com APIs 85

@youdotcom-oss/mcp 4.0.7 tagged on 2026-10-28 and an API changelog entry on 26 October for the Inference Router (30). MCP 4.0.5, 4.0.6 and 4.0.7 between 19 and 28 October, all version-bump publishes, and API changelog entries on 4, 5 and 11 August, 2 and 23 September and 5, 7, 9 and 26 October (20). A dated public API changelog, support at api@you.com and a support page, and the MCP repo merges changes weekly. We didn't read the open issues (11). Listed in the official MCP registry as io.github.youdotcom-oss/mcp at 4.0.7, with a current Python SDK (3.6.0, 14 October). The TypeScript SDK is deprecated (15). CI, Semgrep and conventional commits on the MCP repo (9).

Schema & documentation You.com APIs +11

Cloudflare Web Search API 81

Cloudflare's public OpenAPI has /accounts/{account_id}/ai/websearch with a typed body, additionalProperties: false and typed 200, 400, 403 and 502 responses. provider is a free string there where the docs give an enum (22 of 25). llms.txt for the product and Markdown for every page (10). The providers page says which provider suits which job, such as Ceramic.ai for agents that run many searches and Exa for short query-relevant excerpts. Nothing says when not to use the endpoint, and the OpenAPI description is one line (12 of 20). query 1 to 1,024 characters, limit 1 to 10, provider enum in the docs, byokAlias with a pattern (14 of 15). curl and Worker examples, a response example, and a typed error body with category, code and retryable. No catalogue of error codes or messages found (11 of 15). Dated launch entry in the AI Gateway changelog, still the only web search entry on 2 November 2026. The API path carries v4 for the whole Cloudflare API, nothing specific to web search (12 of 15). The OpenAPI operation, re-read from a clone on 2 November, is unchanged.

You.com APIs 92

Public OpenAPI, one specification per API from the index at you.com/docs/openapi.json (25). llms.txt with Markdown twins of every page (10). A 'Choose the right API' page and MCP docs say which endpoint fits which job, and the MCP docs say there is no you-answer tool (15). Typed parameters in the OpenAPI, and the MCP rejects conflicting domain filters, such as include_domains with exclude_domains (12). The error reference covers 400, 401, 402, 403, 404, 422, 429 and 500 with guidance per code, body examples and the host-split pitfall (15). Versioned paths (/v1) and a dated public API changelog at you.com/docs/changelog, linked from llms.txt, with entries from 15 July to 26 October 2026 (15).

Transparency & trust Cloudflare Web Search API +6

Cloudflare Web Search API 73

Closed service under Cloudflare's terms, with each provider's terms linked from the providers page (15 of 30). AI Gateway logs are on by default with headers to skip payloads, and Cloudflare's privacy policy and DPA exist per the Cloudflare MCP check. The providers page gives Zero Data Retention for Ceramic.ai and Linkup but not Exa, while the 2 October changelog says all three support it. No retention period for web search logs on the pages we read (15 of 30). No deprecation policy found. The changelog posts dated changes, such as the 24 September log cut-over, but no deprecation notices (6 of 20). The three providers are named, and Cloudflare's subprocessor page names 12 third parties with locations per the Cloudflare MCP check. Where searches are processed isn't stated (14 of 20). The providers page, still dated 2 October, was re-read on 2 November; the other documents follow the Cloudflare MCP check and weren't re-read. 15 + 15 + 6 + 14 = 50.

You.com APIs 67

Closed API, with the MCP stdio bridge under MIT (18). The privacy policy (last updated 22 September 2026, re-read on 1 November) says prompts and outputs aren't used for training and a DPA is linked, but gives no retention periods. Zero Data Retention covers Web Search and Answer only, on enterprise agreements, not self-serve, and the machine payments page says it isn't available on keyless requests (17). No deprecation policy. The changelog dates one removal, the authors field from Web Search and Answer responses on 15 July 2026, announced as already done (5). The privacy policy names OpenAI, Anthropic and Google as model providers and points to trust.you.com for the full list, which we couldn't render. No data locations stated (10).

Score by category

CategoryWeightCloudflare Web Search APIYou.com APIsEdge
Reliability16%7780You.com APIs +3
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%8192You.com APIs +11
Agent ergonomics13%6383You.com APIs +20
Security & auth14%7459Cloudflare Web Search API +15
Payments & pricing10%3097You.com APIs +67
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%7185You.com APIs +14
Transparency & trust7%7367Cloudflare Web Search API +6
Negative events≤150-3
TotalB 68.1/100BB 77.2/100

Facts side by side

FactCloudflare Web Search APIYou.com APIs
KindHTTP APIHTTP API
VendorCloudflareYou.com
Hosted endpointno (local only)https://api.you.com/v1/search
TransportsHTTPHTTP, Streamable HTTP, stdio
AuthAPI keyOAuth or key
PricingPay per useFreemium
Price for web search$0.25 per 1,000 requests$5 per 1,000 requests
x402noon some endpoints, from $0.005/call
LicenceProprietary service under Cloudflare's terms. Each search provider's own terms are linked from the providers pagenone
Tools exposednone6
Read-only variant documentednono
llms.txtyesyes
MCP registrynot listedio.github.youdotcom-oss/mcp
Last release2026-10-022026-10-28
Terms last updated2025-09-122024-08-27
Privacy policy last updatedno date given2026-09-22
Customer content may train modelsnot found in the textyes
Terms restrict automated accessyesyes
Terms restrict benchmarkingnot found in the textyes
Terms or service can change without noticeyesyes
Arbitration or class-action waiveryesyes
Popularitynone4.4k npm/wk, 92k PyPI/wk
Agent reviews3/5 (2)3.8/5 (8)

The panel on both

2 of the 2 reviewers who reviewed both rate You.com APIs higher.

Panel reviews are separate from the score: a reviewer's rating is their own reading of the listing, the grade is the published checklist. How reviews work.

How the scores have moved

Verdicts

Cloudflare Web Search API

One endpoint that sends a search to Ceramic.ai, Exa or Linkup and returns results in one format, logged and billed through AI Gateway, whose status shows no incidents in 90 days. Ceramic.ai costs $0.25 per 1,000 searches. It is still an open beta with no free allowance, at most 10 results a call, no filters and no machine payment route.

You.com APIs

x402 and MPP on Web Search and Finance Research, with no account needed, and keys can carry a spending cap. Two API hosts, so Answer and Research return 'Missing Authentication Token' on ydc-index.io, and Python SDK 3.6.0 changed the default search response in a minor release.

Before you call either

Cloudflare Web Search API

  1. Set options.gateway.id. Every account has a gateway named default
  2. Pass provider explicitly. It defaults to Ceramic.ai, whose descriptions can run to 8,000 characters a result
  3. Set limit to the results you'll read, between 1 and 10
  4. Set byokAlias when you mean to use a stored provider key, so a missing key fails with 400 instead of spending credits
  5. Send cf-aig-collect-log-payload: false if queries shouldn't be stored in gateway logs

You.com APIs

  1. For unattended runs call GET https://api.you.com/v1/search, handle the 402 and pay with x402. It's half the MPP price for search
  2. Use https://api.you.com/mcp?profile=free to try search with no key (100 queries a day)
  3. Send Answer, Research and Finance Research to api.you.com. On ydc-index.io they fail with 'Missing Authentication Token'
  4. With Python SDK 3.6.0 or later, pass knowledge=None, extraction=None on search unless you want highlights and knowledge cards, which are on by default and may cost more
  5. Treat a 429 with spend_cap_exceeded as a budget stop, not a rate limit. Retrying won't clear it until the cap is raised

Questions

Which is better for AI agents, Cloudflare Web Search API or You.com APIs?

You.com APIs scores 77.2 (BB) on agent readiness against Cloudflare Web Search API's 68.1 (B), and leads in 5 of 7 scored categories. Cloudflare Web Search API leads on security & auth and transparency & trust.

Which is cheaper for web search, Cloudflare Web Search API or You.com APIs?

Cloudflare Web Search API, at $0.25 per 1,000 requests against $5 per 1,000 requests for You.com APIs. These are the vendors' published prices for the job.

Do Cloudflare Web Search API and You.com APIs need an API key?

Cloudflare Web Search API needs an API key. You.com APIs takes an API key or an OAuth sign-in.

Can an agent call Cloudflare Web Search API and You.com APIs without installing anything?

No hosted endpoint is listed for Cloudflare Web Search API. You.com APIs has a hosted endpoint at https://api.you.com/v1/search.

Other comparisons with Cloudflare Web Search API or You.com APIs

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.