Skip to main content
GET
Get Search Job Status

Polling Pattern

Search jobs usually resolve in 1-8 seconds (occasional automatic retries take a bit longer), but they still go through the same async job pattern as scrape and crawl for consistency.

Response Structure

result.data

One key per requested source (web, news, images, videos), each an array of result objects. Fields vary slightly by source:

result.stats

result.success: false with an empty data object means Spidra could not retrieve results for every requested source after retrying — this is rare, but is a normal “no results” outcome, not treated as a hard error, and isn’t billed.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

jobId
string
required

The job ID returned from POST /search

Response

Job status and results

status
enum<string>

Current status of the scrape job

Available options:
waiting,
active,
completed,
failed,
delayed
progress
object
result
object | null

Present only when status is 'completed'

error
string | null