Developers

Structured web results in one request

The public search endpoint works without registration or an API key. Sparse local results may be supplemented by a clearly labelled external source; full content is available only for locally indexed results.

Read the API docs Try web search

1. Make your first request

q is the only required parameter. The public tier needs no Authorization header and is suitable for evaluation and low-volume use.

curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"

2. Handle sources and content correctly

source=local comes from the TutuSoo index; source=brave is a web fallback when local coverage is thin.

  • Use the returned url for navigation; never derive an external address from the id.
  • Call /api/v1/content/{id} only for local results with a non-empty id.
  • Handle 429, timeouts, offline states and empty results without infinite retries.

3. Pagination and resource limits

The web UI uses 10 results per page and caps deep pagination. The API limits query length, result count and accepted depth so one request cannot monopolise search resources.

  • Queries are limited to 512 characters.
  • limit is capped at 100; 10–20 is recommended.
  • time_range filters by TutuSoo crawl/index time, not the page publication date.
  • Use bounded exponential backoff for 429 or 503 responses to avoid retry storms.