sparkcrawlDocs

Answer a question with cited web evidence (search scope)

mode=answer runs the verified pipeline (citations, completion); mode=results returns the judged SERP without synthesis; mode=fast returns Google AI Mode output via Scrappa with verified=false (third-party generated). Synchronous by default; async=1 or Prefer: respond-async returns 202 with the job. Result fields: query, mode, verified, answer, citations, sources[{id,url,title,snippet?}], completion{status,reason}, costUsd, customerChargeUsd, jobId. A search is billed as one page.

POST
/api/v1/search

mode=answer runs the verified pipeline (citations, completion); mode=results returns the judged SERP without synthesis; mode=fast returns Google AI Mode output via Scrappa with verified=false (third-party generated). Synchronous by default; async=1 or Prefer: respond-async returns 202 with the job. Result fields: query, mode, verified, answer, citations, sources[{id,url,title,snippet?}], completion{status,reason}, costUsd, customerChargeUsd, jobId. A search is billed as one page.

Authorization

bearerAuth
headerAuthorizationBearer <sc_live_<43 characters>>

Organization API key created at /app/api. Scopes: scrape, crawl, search, research. The secret is shown once.

Query Parameters

async?"1"
Value in"1"

Header Parameters

Idempotency-Key?string

Replays the original job instead of creating a second one when the same key and body are retried.

Match^[A-Za-z0-9._~-]{1,128}$
Lengthlength <= 128

Request Body

application/json
  1. body
query*string
Length1 <= length <= 400
mode?string
Default"answer"
Value in"answer""results""fast"
effort?string
Default"balanced"
Value in"fast""balanced""deep"
language?string
Length2 <= length <= 10
country?string
Length2 <= length <= 2
maxCostUsd?number
Range0 <= value <= 1
Default0.1
timeoutMs?integer
Range5000 <= value <= 120000
Default90000
webhook?

Response Body

Search result

Example Request
curl -X POST 'https://sparkcrawl.com/api/v1/search' \  -H 'Content-Type: application/json' \  -d '{  "query": "string"}'
Example Response
Empty