Search with You.com
You.com searches its web and news index. Pin a query to You.com with one field, and its results come back in the same shape as every other provider’s.
Results from You.com
-
1
The Best Restaurants in West Loop Chicago - Tripadvisor tripadvisor.com
- 2
-
3
23 Best Ramen Shops in Chicago, Ranked timeout.com
-
4
Gyuro Ramen gyuroramen.com
Recorded from live searches on 8 October 2026.
Pin a query to You.com
- Over HTTP, send
"requested_provider": "you"with the query. - In an agent connected over MCP, ask it to search with You.com.
Results come back in the same shape for every provider, as the docs describe. Leave the field out, and Grounder routes each query to the provider most likely to answer it well.
search.shShell
curl https://api.grounder.net/v1/search \
-H "Authorization: Bearer $GROUNDER_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "ramen restaurants in Chicago West Loop",
"top_k": 5,
"requested_provider": "you"
}'
import os
import httpx
KEY = os.environ["GROUNDER_KEY"]
r = httpx.post(
"https://api.grounder.net/v1/search",
headers={"Authorization": f"Bearer {KEY}"},
json={
"query": "ramen restaurants in Chicago West Loop",
"top_k": 5,
"requested_provider": "you",
},
timeout=30,
).json()
for hit in r["results"]:
print(hit["rank"], hit["title"], hit["url"])
const res = await fetch("https://api.grounder.net/v1/search", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.GROUNDER_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
query: "ramen restaurants in Chicago West Loop",
top_k: 5,
requested_provider: "you",
}),
})
const { results } = await res.json()
claude mcp add --transport http grounder \
https://api.grounder.net/mcp
# then /mcp, grounder, Authenticate
Filters You.com applies
Set them under filters. A filter a provider can’t apply returns 400 unsupported_filter.
| Filter | Keeps |
|---|---|
domains | Only these sites, or with "mode": "exclude", none of them. |
recency | The last so many days, or a range of dates. |
language | One language, by its code. |
request.jsonJSON
{
"query": "ramen restaurants in Chicago West Loop",
"top_k": 5,
"requested_provider": "you",
"filters": {
"domains": { "values": ["tripadvisor.com"] }
}
}