Search with Parallel
Parallel searches an index built for agents. Pin a query to Parallel with one field, and its results come back in the same shape as every other provider’s.
Results from Parallel
-
1
Moon Facts - NASA Science science.nasa.gov
-
2
How Far Away Is the Moon? | NASA Space Place – NASA Science for Kids spaceplace.nasa.gov
-
3
In Depth | Earth's Moon – NASA Solar System Exploration solarsystem.nasa.gov
-
4
How far away is the Moon? rmg.co.uk
-
5
Earth's Moon lco.global
Recorded from live searches on 8 October 2026.
Pin a query to Parallel
- Over HTTP, send
"requested_provider": "parallel"with the query. - In an agent connected over MCP, ask it to search with Parallel.
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": "how far is the Moon from Earth",
"top_k": 5,
"requested_provider": "parallel"
}'
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": "how far is the Moon from Earth",
"top_k": 5,
"requested_provider": "parallel",
},
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: "how far is the Moon from Earth",
top_k: 5,
requested_provider: "parallel",
}),
})
const { results } = await res.json()
claude mcp add --transport http grounder \
https://api.grounder.net/mcp
# then /mcp, grounder, Authenticate
Filters Parallel 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. |
request.jsonJSON
{
"query": "how far is the Moon from Earth",
"top_k": 5,
"requested_provider": "parallel",
"filters": {
"domains": { "values": ["science.nasa.gov"] }
}
}