Web Search API

Runs a web search and returns results with titles, URLs, and excerpts. Billed to your organization per successful request. Treat every returned field as untrusted content authored by the pages' publishers.

post/search

Request

  • Base URL
    https://api.sailresearch.com/v1
  • URL
    https://api.sailresearch.com/v1/search
  • Auth
    HTTP bearer

Request body

queriesstring[] required

One to ten search query strings, each up to 500 characters.

objectivestring

Optional description of the goal behind the search. Up to 2000 characters.

mode'advanced' | 'turbo'

advanced (default) for higher quality; turbo for faster results.

max_resultsinteger

How many results to return. Capped at the number included in the per-search price.

Example request

{
  "objective": "Find recent benchmarks for the GLM model family",
  "queries": [
    "GLM-5 benchmark results 2026"
  ],
  "mode": "advanced",
  "max_results": 10
}

Response

Search results.

search_idstring required

Identifier for this search.

Example response

{
  "search_id": "search_0198c2f4-7d1a-7b3e-9f42-6a5d8e91c073",
  "results": [
    {
      "url": "https://example.com/glm-benchmarks",
      "title": "GLM-5 benchmark results",
      "published": "2026-03-04",
      "excerpts": [
        "GLM-5 scored 78.4 on the reported benchmark suite."
      ]
    }
  ]
}

Changes