Queue and poll
Async SERP
Async = you poll; we never call you.
Here, async SERP means: create a Google job (202), poll its status, read the result. It covers Google organic, news and images. Polling is free and there is no webhook.
POST /v1/serp/google/organic/tasks {"q":"crm software"}
← 202 {"job":{"id":"<task_id>","kind":"google_organic","status":"queued","request":{…}}}
GET /v1/serp/tasks/<task_id>
← 200 {"job":{"status":"running","started_at":"<date-time>"}}
GET /v1/serp/tasks/<task_id>
← 200 {"job":{"status":"completed","finished_at":"<date-time>","result":{…}}}Sequence diagram
client API
│ POST /v1/serp/google/{vertical}/tasks
│──────────────────────────────▶│
│◀────── 202 {job.id, queued} ──│
│ GET /v1/serp/tasks/{id} │
│──────────────────────────────▶│
│◀────────── 200 {running} ─────│
│ GET /v1/serp/tasks/{id} │
│──────────────────────────────▶│
│◀── 200 {completed | failed} ──│Billing timeline
Task created (202)
Credits: Not charged yet
Polling (GET)
Credits: Free
Status completed
Credits: Charged once: 2 Credits (display rate)
Status failed
Credits: Not charged
Three task kinds
POST /v1/serp/google/organic/tasks
kind: google_organic
POST /v1/serp/google/news/tasks
kind: google_news
POST /v1/serp/google/images/tasks
kind: google_images
Launch status for this page
Check engine availability before choosing an endpoint. Google also supports News, Images and asynchronous tasks.
- GoogleGoogle is callable today with a Bearer API key.
SERP searches are charged per successful search at a display rate of 2 Credits per search; failed searches are not charged. Polling task status is free. The current rate is on Pricing.
What this is not
- No callback, webhook or postback.
- Google only.
- No completion-time promise.
Frequently asked questions
Which engines support async?
Only Google organic, news and images.
Do you push results?
No. There is no webhook; poll instead.
When is a task charged?
Only when it completes successfully, at a display rate of 2 Credits per search. Failed tasks are not charged, and polling is free.
Queue Google searches
Get an API key and create your first task.