Live Google Organic SERP Advanced

curl --request POST \
  --url https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/live/advanced \
  --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>",
  "device": "<string>",
  "os": "<string>",
  "depth": 123,
  "max_crawl_pages": 123,
  "calculate_rectangles": true,
  "tag": "<string>"
}
'

import requests

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

payload = {
    "keyword": "<string>",
    "location_name": "<string>",
    "location_code": 123,
    "location_coordinate": "<string>",
    "language_name": "<string>",
    "language_code": "<string>",
    "device": "<string>",
    "os": "<string>",
    "depth": 123,
    "max_crawl_pages": 123,
    "calculate_rectangles": True,
    "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>',
    device: '<string>',
    os: '<string>',
    depth: 123,
    max_crawl_pages: 123,
    calculate_rectangles: true,
    tag: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/live/advanced', 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/live/advanced",
  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>',
    'device' => '<string>',
    'os' => '<string>',
    'depth' => 123,
    'max_crawl_pages' => 123,
    'calculate_rectangles' => true,
    '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/live/advanced"

	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  \"device\": \"<string>\",\n  \"os\": \"<string>\",\n  \"depth\": 123,\n  \"max_crawl_pages\": 123,\n  \"calculate_rectangles\": true,\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/live/advanced")
  .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  \"device\": \"<string>\",\n  \"os\": \"<string>\",\n  \"depth\": 123,\n  \"max_crawl_pages\": 123,\n  \"calculate_rectangles\": true,\n  \"tag\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"device\": \"<string>\",\n  \"os\": \"<string>\",\n  \"depth\": 123,\n  \"max_crawl_pages\": 123,\n  \"calculate_rectangles\": true,\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[].result": "<string>"
}

POST

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

dataforseo

serp

google

organic

live

advanced

Live Google Organic SERP Advanced

curl --request POST \
  --url https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/live/advanced \
  --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>",
  "device": "<string>",
  "os": "<string>",
  "depth": 123,
  "max_crawl_pages": 123,
  "calculate_rectangles": true,
  "tag": "<string>"
}
'

import requests

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

payload = {
    "keyword": "<string>",
    "location_name": "<string>",
    "location_code": 123,
    "location_coordinate": "<string>",
    "language_name": "<string>",
    "language_code": "<string>",
    "device": "<string>",
    "os": "<string>",
    "depth": 123,
    "max_crawl_pages": 123,
    "calculate_rectangles": True,
    "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>',
    device: '<string>',
    os: '<string>',
    depth: 123,
    max_crawl_pages: 123,
    calculate_rectangles: true,
    tag: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/live/advanced', 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/live/advanced",
  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>',
    'device' => '<string>',
    'os' => '<string>',
    'depth' => 123,
    'max_crawl_pages' => 123,
    'calculate_rectangles' => true,
    '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/live/advanced"

	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  \"device\": \"<string>\",\n  \"os\": \"<string>\",\n  \"depth\": 123,\n  \"max_crawl_pages\": 123,\n  \"calculate_rectangles\": true,\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/live/advanced")
  .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  \"device\": \"<string>\",\n  \"os\": \"<string>\",\n  \"depth\": 123,\n  \"max_crawl_pages\": 123,\n  \"calculate_rectangles\": true,\n  \"tag\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"device\": \"<string>\",\n  \"os\": \"<string>\",\n  \"depth\": 123,\n  \"max_crawl_pages\": 123,\n  \"calculate_rectangles\": true,\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[].result": "<string>"
}

Returns the ranked results for a keyword on Google, synchronously. Returns keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count and items. Measured at 57 KB for a ten-result Google query. ⚠️ Three result depths exist for the same query and differ by two orders of magnitude: regular measured 4.8 KB, advanced 57 KB, and html 2.4 MB. advanced is the default choice; take regular when only the ranked list matters and html only to check what the parser dropped. 💰 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.

Example

curl -X POST "https://api.aisa.one/apis/v1/dataforseo/serp/google/organic/live/advanced" \
  -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

device

string

Device type: desktop or mobile

string

Device operating system

depth

integer

Parsing depth, default 100, max 700

max_crawl_pages

integer

Page crawl limit, max 100

calculate_rectangles

boolean

Calculate pixel rankings for SERP elements

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

Request cost in USD

tasks_count

integer

Number of tasks returned

tasks_error

integer

Number of tasks returned with an error

tasks

string

Array of live task objects

tasks[].id

string

Task identifier

tasks[].result

string

Live SERP advanced results

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

Live Google Organic SERP Advanced

Example

Authorizations

Body

Response

​Example

Authorizations

Body

Response

Example