Search

Base URL https://api.tilion.dev. Every request needs Authorization: Bearer $TILION_API_KEY.

POST /v1/search

Unlike Fetch, Search needs no session; session_id is optional. All fields go in the JSON body.

curl -X POST https://api.tilion.dev/v1/search \
  -H "Authorization: Bearer $TILION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"cloud browser","count":10}'

Request

Field	Type	Default	Notes
`query`	string	required	Minimum length 1
`engine`	string	default engine	See `GET /v1/search/engines`
`count`	int	10	Bounded by the engine maximum
`offset`	int	0	Result offset for paging
`session_id`	string	`null`	Drive an existing session
`collapse_domains`	bool	`false`	One hit per domain

Response

{
  "query": "cloud browser", "engine": "...", "count": 10, "offset": 0,
  "total_found": 128, "has_more": true, "status": "ok",
  "results": [
    { "title": "...", "url": "https://...", "snippet": "...", "rank": 1, "engine": "..." }
  ],
  "knowledge_graph": null, "people_also_ask": [], "related_searches": [], "answer_box": null
}

Engines

GET /v1/search/engines

The endpoint lists the engines available to POST /v1/search. Omit engine on the search call to use the default.

Get started

MCP

Sessions

Fetch & jobs

Content

Agent & tasks

Live view & recordings

Account

Reference

Request

Response

Engines

​Request

​Response

​Engines

Request

Response

Engines