Search with Perplexity

Perplexity searches a real-time index of the web. Pin a query to Perplexity with one field, and its results come back in the same shape as every other provider’s.

Pinned to Perplexity, answered in 507 ms.

Results from Perplexity

1
What are the northern lights? The aurora borealis explained nhm.ac.uk
2
Northern lights (aurora borealis): What they are and how to ... space.com
3
What are the Northern Lights? And how can you see them? - BBC bbc.com
4
The Science of the Northern Lights ontariosciencecentre.ca
5
What causes the northern lights? | Ask Dr. Universe askdruniverse.wsu.edu

Recorded from live searches on 8 October 2026.

Pin a query to Perplexity

Over HTTP, send "requested_provider": "perplexity" with the query.
In an agent connected over MCP, ask it to search with Perplexity.

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": "what causes the northern lights",
    "top_k": 5,
    "requested_provider": "perplexity"
  }'

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": "what causes the northern lights",
        "top_k": 5,
        "requested_provider": "perplexity",
    },
    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: "what causes the northern lights",
    top_k: 5,
    requested_provider: "perplexity",
  }),
})

const { results } = await res.json()

claude mcp add --transport http grounder \
  https://api.grounder.net/mcp
# then /mcp, grounder, Authenticate

Filters Perplexity 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": "what causes the northern lights",
  "top_k": 5,
  "requested_provider": "perplexity",
  "filters": {
    "domains": { "values": ["nhm.ac.uk"] }
  }
}