Setting Google AI Mode SERP Tasks

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

import requests

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

payload = {
    "keyword": "<string>",
    "location_code": 123,
    "location_name": "<string>",
    "location_coordinate": "<string>",
    "language_name": "<string>",
    "language_code": "<string>",
    "priority": 123,
    "device": "<string>",
    "pingback_url": "<string>",
    "postback_url": "<string>",
    "postback_data": "<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_code: 123,
    location_name: '<string>',
    location_coordinate: '<string>',
    language_name: '<string>',
    language_code: '<string>',
    priority: 123,
    device: '<string>',
    pingback_url: '<string>',
    postback_url: '<string>',
    postback_data: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/serp/google/ai_mode/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/ai_mode/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_code' => 123,
    'location_name' => '<string>',
    'location_coordinate' => '<string>',
    'language_name' => '<string>',
    'language_code' => '<string>',
    'priority' => 123,
    'device' => '<string>',
    'pingback_url' => '<string>',
    'postback_url' => '<string>',
    'postback_data' => '<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/ai_mode/task_post"

	payload := strings.NewReader("{\n  \"keyword\": \"<string>\",\n  \"location_code\": 123,\n  \"location_name\": \"<string>\",\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"priority\": 123,\n  \"device\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"postback_data\": \"<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/ai_mode/task_post")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"keyword\": \"<string>\",\n  \"location_code\": 123,\n  \"location_name\": \"<string>\",\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"priority\": 123,\n  \"device\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"postback_data\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/dataforseo/serp/google/ai_mode/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_code\": 123,\n  \"location_name\": \"<string>\",\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"priority\": 123,\n  \"device\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"postback_data\": \"<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

ai_mode

task_post

Setting Google AI Mode SERP Tasks

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

import requests

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

payload = {
    "keyword": "<string>",
    "location_code": 123,
    "location_name": "<string>",
    "location_coordinate": "<string>",
    "language_name": "<string>",
    "language_code": "<string>",
    "priority": 123,
    "device": "<string>",
    "pingback_url": "<string>",
    "postback_url": "<string>",
    "postback_data": "<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_code: 123,
    location_name: '<string>',
    location_coordinate: '<string>',
    language_name: '<string>',
    language_code: '<string>',
    priority: 123,
    device: '<string>',
    pingback_url: '<string>',
    postback_url: '<string>',
    postback_data: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/serp/google/ai_mode/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/ai_mode/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_code' => 123,
    'location_name' => '<string>',
    'location_coordinate' => '<string>',
    'language_name' => '<string>',
    'language_code' => '<string>',
    'priority' => 123,
    'device' => '<string>',
    'pingback_url' => '<string>',
    'postback_url' => '<string>',
    'postback_data' => '<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/ai_mode/task_post"

	payload := strings.NewReader("{\n  \"keyword\": \"<string>\",\n  \"location_code\": 123,\n  \"location_name\": \"<string>\",\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"priority\": 123,\n  \"device\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"postback_data\": \"<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/ai_mode/task_post")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"keyword\": \"<string>\",\n  \"location_code\": 123,\n  \"location_name\": \"<string>\",\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"priority\": 123,\n  \"device\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"postback_data\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/dataforseo/serp/google/ai_mode/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_code\": 123,\n  \"location_name\": \"<string>\",\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"priority\": 123,\n  \"device\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"postback_data\": \"<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 Google’s AI Mode answer for a query, with the sources it cites 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/ai_mode/task_post" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '[{"keyword": "...", "location_code": "...", "location_name": "..."}]'

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; you can specify up to 700 characters

location_code

integer

Search engine location code; required if location_name or location_coordinate is not specified

location_name

string

Full name of search engine location; required if location_code or location_coordinate is not specified

location_coordinate

string

GPS coordinates of a location; required if location_name or location_code is not specified

language_name

string

Full name of search engine language; required if language_code is not specified

language_code

string

Search engine language code; required if language_name is not specified

priority

integer

Task priority: 1 normal (default), 2 high

device

string

Device type: desktop or mobile

pingback_url

string

Notification URL of a completed task

postback_url

string

URL for sending task results

postback_data

string

Postback URL datatype; required if postback_url is specified; possible values: advanced, html

Response

Successful response

version

string

The current version of the API

status_code

integer

General status code

status_message

string

General informational message

time

string

Execution time, seconds

cost

number

Total tasks cost, USD

tasks_count

integer

The number of tasks in the tasks array

tasks_error

integer

The number of tasks in the tasks array 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

Cost of the task, USD

tasks[].result_count

integer

Number of elements in the result array

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 AI Mode SERP Tasks

Example

Authorizations

Body

Response

​Example

Authorizations

Body

Response

Example