Google AI Mode API
curl --request POST \
--url https://api.socq.ai/v1/ai-search/google-ai-mode \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"callback_url": "<string>",
"language": "<string>",
"language_code": "<string>",
"location_code": 2,
"location_name": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/ai-search/google-ai-mode"
payload = {
"query": "<string>",
"callback_url": "<string>",
"language": "<string>",
"language_code": "<string>",
"location_code": 2,
"location_name": "<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({
query: '<string>',
callback_url: '<string>',
language: '<string>',
language_code: '<string>',
location_code: 2,
location_name: '<string>'
})
};
fetch('https://api.socq.ai/v1/ai-search/google-ai-mode', 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.socq.ai/v1/ai-search/google-ai-mode",
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([
'query' => '<string>',
'callback_url' => '<string>',
'language' => '<string>',
'language_code' => '<string>',
'location_code' => 2,
'location_name' => '<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.socq.ai/v1/ai-search/google-ai-mode"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"language\": \"<string>\",\n \"language_code\": \"<string>\",\n \"location_code\": 2,\n \"location_name\": \"<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.socq.ai/v1/ai-search/google-ai-mode")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"language\": \"<string>\",\n \"language_code\": \"<string>\",\n \"location_code\": 2,\n \"location_name\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/ai-search/google-ai-mode")
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 \"query\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"language\": \"<string>\",\n \"language_code\": \"<string>\",\n \"location_code\": 2,\n \"location_name\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}AI Search
Google AI Mode
Get the full Google AI Mode answer for a search, in Markdown, with every source it cites.
POST
/
v1
/
ai-search
/
google-ai-mode
Google AI Mode API
curl --request POST \
--url https://api.socq.ai/v1/ai-search/google-ai-mode \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"callback_url": "<string>",
"language": "<string>",
"language_code": "<string>",
"location_code": 2,
"location_name": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/ai-search/google-ai-mode"
payload = {
"query": "<string>",
"callback_url": "<string>",
"language": "<string>",
"language_code": "<string>",
"location_code": 2,
"location_name": "<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({
query: '<string>',
callback_url: '<string>',
language: '<string>',
language_code: '<string>',
location_code: 2,
location_name: '<string>'
})
};
fetch('https://api.socq.ai/v1/ai-search/google-ai-mode', 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.socq.ai/v1/ai-search/google-ai-mode",
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([
'query' => '<string>',
'callback_url' => '<string>',
'language' => '<string>',
'language_code' => '<string>',
'location_code' => 2,
'location_name' => '<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.socq.ai/v1/ai-search/google-ai-mode"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"language\": \"<string>\",\n \"language_code\": \"<string>\",\n \"location_code\": 2,\n \"location_name\": \"<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.socq.ai/v1/ai-search/google-ai-mode")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"language\": \"<string>\",\n \"language_code\": \"<string>\",\n \"location_code\": 2,\n \"location_name\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/ai-search/google-ai-mode")
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 \"query\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"language\": \"<string>\",\n \"language_code\": \"<string>\",\n \"location_code\": 2,\n \"location_name\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Google AI Mode
AI Mode is the conversational tab in Google Search that writes a complete answer instead of listing links. Send a query and get that answer as Markdown, plus the deduplicated list of sources it cites with titles, domains and excerpts. Track what Google tells people about your category, check whether your pages are among the sources, and compare answers across countries and languages.{
"query": "best crm for startups",
"location_code": 2840,
"language_code": "en"
}
Standard Result Fields
Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, usefields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | Yes | The search query, used as the identifier. |
platform | string | No | Platform the result belongs to, such as instagram or linkedin. |
resource | string | No | SocQ resource represented by the result, such as videos or comments. |
type | string | No | Category of the result item, such as video, post, or comment. |
url | string | Yes | URL of the Google AI Mode page for the query. |
published_at | string | Yes | Time the source item was published, in ISO 8601 format when available. |
collected_at | string | No | Time SocQ collected or processed this result, in ISO 8601 format. |
query | string | Yes | Search query that was asked. |
answer | string | Yes | Full AI Mode answer in Markdown. |
references | array<object> | Yes | Sources cited in the answer, without duplicates. |
references.position | integer | Yes | Position of the source in the answer’s list, starting at 1. |
references.title | string | Yes | Title of the cited page. |
references.url | string | Yes | URL of the cited page. |
references.domain | string | Yes | Domain of the cited page. |
references.source | string | Yes | Name of the site or publisher as shown in the answer. |
references.text | string | Yes | Excerpt of the cited page shown with the answer. |
location_code | integer | Yes | Location code of the search market. |
language_code | string | Yes | Language code of the search. |
Completed Task Response
{
"code": 200,
"data": {
"task_id": "example-seo-google-ai-mode",
"status": "succeeded",
"public_id": "ai-search/google-ai-mode",
"result_count": 1,
"credits_amount": 2,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "ai-answer",
"schema_version": "1.0",
"items": [
{
"id": "best crm for startups",
"platform": "ai-search",
"resource": "google-ai-mode",
"type": "ai-answer",
"url": "https://www.google.com/search?q=best+crm+for+startups&udm=50",
"published_at": null,
"collected_at": "2026-11-17T23:54:23.024820Z",
"query": "best crm for startups",
"answer": "The best CRM for a startup depends on your `GTM motion` , with **HubSpot** leading as the top all-around choice.[[1]](https://www.youtube.com/watch?v=1NVfdI1iWYs)\n\n#### Top CRM Options by Startup Type\n\n- **HubSpot Smart CRM** (Best All-Around / Inbound): Great free tier, scales easily from marketing to sales and support, and ideal for inbound-led growth. Explore it on …",
"references": [
{
"position": null,
"title": "Best CRM for Startups & Small Business in 2026",
"url": "https://www.youtube.com/watch?v=1NVfdI1iWYs",
"domain": "www.youtube.com",
"source": "YouTube",
"text": "https://wiza.co What this video is about: Most startups don't realize they picked the wrong CRM until a lead gets contacted twice, follow-ups disappear, contact da"
}
],
"location_code": 2840,
"language_code": "en"
}
]
}
}
}
Authorizations
bearerAuthapiKeyAuth
Body
application/json
Provide a search query in query. The result is one row with the full Google AI Mode answer in Markdown and every source it cites.

