Search with Octen

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

Pinned to Octen, answered in 354 ms.

Results from Octen

1
Hummus: Ingredients, Recipe, and Benefits webmd.com
2
Hummus en.wikipedia.org
3
What Is Hummus? Ingredients, Taste, Health Benefits & How To Eat It Right pitahousesd.com
4
Hummus Recipe (2 Ways!) themediterraneandish.com
5
Hummus | Ingredients, Nutrition, & Countries | Britannica britannica.com

Recorded from live searches on 8 October 2026.

Pin a query to Octen

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

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": "main ingredients in hummus",
    "top_k": 5,
    "requested_provider": "octen"
  }'

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": "main ingredients in hummus",
        "top_k": 5,
        "requested_provider": "octen",
    },
    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: "main ingredients in hummus",
    top_k: 5,
    requested_provider: "octen",
  }),
})

const { results } = await res.json()

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

Filters Octen 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": "main ingredients in hummus",
  "top_k": 5,
  "requested_provider": "octen",
  "filters": {
    "domains": { "values": ["webmd.com"] }
  }
}