Tools

You.com

The You.com Search API
View as Markdown

Proxies You.com’s Search API, with You.com’s /v1 base folded into the route:

GET /youcom/search   → https://ydc-index.io/v1/search

GET only. Every control (query, count, livecrawl, …) travels in the query string and is forwarded byte-for-byte.

You.com’s Contents and Research APIs are deliberately not exposed — only the Search API is proxied.

What the gateway injects and strips

  • The X-API-Key header is injected, overwriting any client-supplied one.
  • The Authorization header is stripped before forwarding — You.com has no use for your gateway token.

Example

$curl "$GATEWAY/youcom/search?query=cloudflare+workers" \
>  -H "Authorization: Bearer $TOKEN"

The response is You.com’s JSON, returned unchanged. For request and response fields, follow You.com’s documentation — the gateway does not alter them.