GET
Return SERP-only search results

Authorizations

Authorization
string
header
default:tok_public_demo
required

Send a workspace API token in the Authorization: Bearer <token> header.

Keys carry the satk_ prefix and spend your organization's credit balance. GET /v1/public/balance reports what is left.

Test-mode keys (satk_test_), which drew on a separate self-refilling allowance, have been retired and no longer authenticate.

Headers

Idempotency-Key
string

Optional deduplication key, scoped to your organization. Re-sending a request with a key that was already used returns the original job instead of creating and charging for a second one.

Supersedes the idempotencyKey body field, which remains supported as a deprecated alias. If both are present, this header wins.

Maximum string length: 255

Query Parameters

q
string
required

Search query text.

provider
enum<string>
default:google

Search backend. Google is the default provider.

Available options:
google,
duckduckgo,
news,
research
limit
integer

Legacy alias for maxResults.

Required range: x <= 20
maxResults
integer
default:10

Maximum number of organic results to return.

Required range: x <= 20
strictProvider
boolean
default:false

Honor the selected provider; disable cross-engine fallback.

includeDiagnostics
boolean
default:false

Include a bounded route trace on terminal success and failure.

timeoutMs
integer

Total request budget including queue wait; alternative to options.timeoutMs.

Required range: 1 <= x <= 600000
wait
boolean
default:true

Whether to wait for a terminal response before returning.

Response

Search completed and returned a terminal response.

data
object
required