Setting Google Organic SERP Tasks

curl --request POST \
  --url https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/task_post \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "keyword": "<string>",
  "location_name": "<string>",
  "location_code": 123,
  "location_coordinate": "<string>",
  "language_name": "<string>",
  "language_code": "<string>",
  "depth": 123,
  "max_crawl_pages": 123,
  "device": "<string>",
  "os": "<string>",
  "group_organic_results": true,
  "calculate_rectangles": true,
  "postback_url": "<string>",
  "pingback_url": "<string>",
  "postback_data": "<string>",
  "tag": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/task_post"

payload = {
    "keyword": "<string>",
    "location_name": "<string>",
    "location_code": 123,
    "location_coordinate": "<string>",
    "language_name": "<string>",
    "language_code": "<string>",
    "depth": 123,
    "max_crawl_pages": 123,
    "device": "<string>",
    "os": "<string>",
    "group_organic_results": True,
    "calculate_rectangles": True,
    "postback_url": "<string>",
    "pingback_url": "<string>",
    "postback_data": "<string>",
    "tag": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    keyword: '<string>',
    location_name: '<string>',
    location_code: 123,
    location_coordinate: '<string>',
    language_name: '<string>',
    language_code: '<string>',
    depth: 123,
    max_crawl_pages: 123,
    device: '<string>',
    os: '<string>',
    group_organic_results: true,
    calculate_rectangles: true,
    postback_url: '<string>',
    pingback_url: '<string>',
    postback_data: '<string>',
    tag: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/task_post', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/task_post",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'keyword' => '<string>',
    'location_name' => '<string>',
    'location_code' => 123,
    'location_coordinate' => '<string>',
    'language_name' => '<string>',
    'language_code' => '<string>',
    'depth' => 123,
    'max_crawl_pages' => 123,
    'device' => '<string>',
    'os' => '<string>',
    'group_organic_results' => true,
    'calculate_rectangles' => true,
    'postback_url' => '<string>',
    'pingback_url' => '<string>',
    'postback_data' => '<string>',
    'tag' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/task_post"

	payload := strings.NewReader("{\n  \"keyword\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"depth\": 123,\n  \"max_crawl_pages\": 123,\n  \"device\": \"<string>\",\n  \"os\": \"<string>\",\n  \"group_organic_results\": true,\n  \"calculate_rectangles\": true,\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"postback_data\": \"<string>\",\n  \"tag\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/task_post")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"keyword\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"depth\": 123,\n  \"max_crawl_pages\": 123,\n  \"device\": \"<string>\",\n  \"os\": \"<string>\",\n  \"group_organic_results\": true,\n  \"calculate_rectangles\": true,\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"postback_data\": \"<string>\",\n  \"tag\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/task_post")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"keyword\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"depth\": 123,\n  \"max_crawl_pages\": 123,\n  \"device\": \"<string>\",\n  \"os\": \"<string>\",\n  \"group_organic_results\": true,\n  \"calculate_rectangles\": true,\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"postback_data\": \"<string>\",\n  \"tag\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "version": "<string>",
  "status_code": 123,
  "status_message": "<string>",
  "time": "<string>",
  "cost": 123,
  "tasks_count": 123,
  "tasks_error": 123,
  "tasks": "<string>",
  "tasks[].id": "<string>",
  "tasks[].status_code": 123,
  "tasks[].status_message": "<string>",
  "tasks[].cost": 123,
  "tasks[].result_count": 123
}

POST

https://api.aisa.one/apis/v1

dataforseo

serp

google

organic

task_post

Setting Google Organic SERP Tasks

curl --request POST \
  --url https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/task_post \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "keyword": "<string>",
  "location_name": "<string>",
  "location_code": 123,
  "location_coordinate": "<string>",
  "language_name": "<string>",
  "language_code": "<string>",
  "depth": 123,
  "max_crawl_pages": 123,
  "device": "<string>",
  "os": "<string>",
  "group_organic_results": true,
  "calculate_rectangles": true,
  "postback_url": "<string>",
  "pingback_url": "<string>",
  "postback_data": "<string>",
  "tag": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/task_post"

payload = {
    "keyword": "<string>",
    "location_name": "<string>",
    "location_code": 123,
    "location_coordinate": "<string>",
    "language_name": "<string>",
    "language_code": "<string>",
    "depth": 123,
    "max_crawl_pages": 123,
    "device": "<string>",
    "os": "<string>",
    "group_organic_results": True,
    "calculate_rectangles": True,
    "postback_url": "<string>",
    "pingback_url": "<string>",
    "postback_data": "<string>",
    "tag": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    keyword: '<string>',
    location_name: '<string>',
    location_code: 123,
    location_coordinate: '<string>',
    language_name: '<string>',
    language_code: '<string>',
    depth: 123,
    max_crawl_pages: 123,
    device: '<string>',
    os: '<string>',
    group_organic_results: true,
    calculate_rectangles: true,
    postback_url: '<string>',
    pingback_url: '<string>',
    postback_data: '<string>',
    tag: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/task_post', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/task_post",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'keyword' => '<string>',
    'location_name' => '<string>',
    'location_code' => 123,
    'location_coordinate' => '<string>',
    'language_name' => '<string>',
    'language_code' => '<string>',
    'depth' => 123,
    'max_crawl_pages' => 123,
    'device' => '<string>',
    'os' => '<string>',
    'group_organic_results' => true,
    'calculate_rectangles' => true,
    'postback_url' => '<string>',
    'pingback_url' => '<string>',
    'postback_data' => '<string>',
    'tag' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/task_post"

	payload := strings.NewReader("{\n  \"keyword\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"depth\": 123,\n  \"max_crawl_pages\": 123,\n  \"device\": \"<string>\",\n  \"os\": \"<string>\",\n  \"group_organic_results\": true,\n  \"calculate_rectangles\": true,\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"postback_data\": \"<string>\",\n  \"tag\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/task_post")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"keyword\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"depth\": 123,\n  \"max_crawl_pages\": 123,\n  \"device\": \"<string>\",\n  \"os\": \"<string>\",\n  \"group_organic_results\": true,\n  \"calculate_rectangles\": true,\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"postback_data\": \"<string>\",\n  \"tag\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/task_post")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"keyword\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"depth\": 123,\n  \"max_crawl_pages\": 123,\n  \"device\": \"<string>\",\n  \"os\": \"<string>\",\n  \"group_organic_results\": true,\n  \"calculate_rectangles\": true,\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"postback_data\": \"<string>\",\n  \"tag\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "version": "<string>",
  "status_code": 123,
  "status_message": "<string>",
  "time": "<string>",
  "cost": 123,
  "tasks_count": 123,
  "tasks_error": 123,
  "tasks": "<string>",
  "tasks[].id": "<string>",
  "tasks[].status_code": 123,
  "tasks[].status_message": "<string>",
  "tasks[].cost": 123,
  "tasks[].result_count": 123
}

Queues the ranked results for a keyword on Google, returning a task id in tasks[0].id. The charge lands here; fetching is free, including re-fetching. 💰 Measured at

0.002 upstream against the

0.012 billed - this family is the cheapest source of search data here, six times under the flat rate. Wrapped in DataForSEO’s envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. The live twin answers immediately and is simpler for a single query; queue when the batch would outlast a tool call.

Example

curl -X POST "https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/task_post" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '[{"keyword": "...", "location_name": "...", "location_code": "..."}]'

Authorizations

Authorization

string

header

required

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

Body

application/json

keyword

string

required

Keyword to search for

location_name

string

Full name of search engine location

location_code

integer

Search engine location code

location_coordinate

string

GPS coordinates of a location

language_name

string

Full name of search engine language

language_code

string

Search engine language code

depth

integer

Parsing depth, default 100, max 700

max_crawl_pages

integer

Page crawl limit, max 100

device

string

Device type: desktop or mobile

string

Device operating system

group_organic_results

boolean

Display related results as grouped organic results

calculate_rectangles

boolean

Calculate pixel rankings for SERP elements in advanced results

postback_url

string

Postback URL for completed task results

pingback_url

string

Pingback URL for task completion notification

postback_data

string

Postback payload type

tag

string

User-defined task identifier

Response

Successful response

version

string

API version

status_code

integer

General status code

status_message

string

General informational message

time

string

Execution time

cost

number

Total tasks cost in USD

tasks_count

integer

Number of tasks in the request

tasks_error

integer

Number of tasks returned with an error

tasks

string

Array of task objects

tasks[].id

string

Task identifier in UUID format

tasks[].status_code

integer

Task status code

tasks[].status_message

string

Task status message

tasks[].cost

number

Task cost

tasks[].result_count

integer

Number of result elements

Overview

Chat API

Embeddings & Rerank

Search API

Perplexity API

Financial API

Twitter API

Reddit API

Instagram API

Pinterest API

Scholar API

WaveInflu API

Prediction Market API

CoinGecko

DataForSEO

AgentMail

Apollo

Ahrefs API

Semrush API

SimilarWeb API

Essentials

Setting Google Organic SERP Tasks

Example

Authorizations

Body

Response

​Example

Authorizations

Body

Response

Example