LLM Mentions API
curl --request POST \
--url https://api.socq.ai/v1/ai-search/llm-mentions \
--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>",
"platform": "google",
"results_limit": 100,
"target": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/ai-search/llm-mentions"
payload = {
"query": "<string>",
"callback_url": "<string>",
"language": "<string>",
"language_code": "<string>",
"location_code": 2,
"location_name": "<string>",
"platform": "google",
"results_limit": 100,
"target": "<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>',
platform: 'google',
results_limit: 100,
target: '<string>'
})
};
fetch('https://api.socq.ai/v1/ai-search/llm-mentions', 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/llm-mentions",
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>',
'platform' => 'google',
'results_limit' => 100,
'target' => '<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/llm-mentions"
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 \"platform\": \"google\",\n \"results_limit\": 100,\n \"target\": \"<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/llm-mentions")
.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 \"platform\": \"google\",\n \"results_limit\": 100,\n \"target\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/ai-search/llm-mentions")
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 \"platform\": \"google\",\n \"results_limit\": 100,\n \"target\": \"<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
LLM Mentions
See the AI Overviews and ChatGPT answers that cite your domain or mention your keyword, with every source they used.
POST
/
v1
/
ai-search
/
llm-mentions
LLM Mentions API
curl --request POST \
--url https://api.socq.ai/v1/ai-search/llm-mentions \
--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>",
"platform": "google",
"results_limit": 100,
"target": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/ai-search/llm-mentions"
payload = {
"query": "<string>",
"callback_url": "<string>",
"language": "<string>",
"language_code": "<string>",
"location_code": 2,
"location_name": "<string>",
"platform": "google",
"results_limit": 100,
"target": "<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>',
platform: 'google',
results_limit: 100,
target: '<string>'
})
};
fetch('https://api.socq.ai/v1/ai-search/llm-mentions', 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/llm-mentions",
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>',
'platform' => 'google',
'results_limit' => 100,
'target' => '<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/llm-mentions"
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 \"platform\": \"google\",\n \"results_limit\": 100,\n \"target\": \"<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/llm-mentions")
.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 \"platform\": \"google\",\n \"results_limit\": 100,\n \"target\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/ai-search/llm-mentions")
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 \"platform\": \"google\",\n \"results_limit\": 100,\n \"target\": \"<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": {}
}
}LLM Mentions
More and more buyers ask an AI before they search. This endpoint shows the questions where Google AI Overviews or ChatGPT cite your domain, or where your brand or keyword comes up in the answer. Each row is one question with the full answer in Markdown, the pages it cited, how many people ask it each month, and, for ChatGPT, the brands it named and the follow-up searches it ran. Use it to audit generative engine optimization, find the pages AI trusts in your niche, or catch answers that describe your product wrongly.{
"target": "notion.so",
"platform": "google",
"results_limit": 100
}
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 | Identifier of the question and answer, derived from the AI platform, model and question. |
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 | Public URL of the result item when available. |
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. |
question | string | Yes | Question or search the AI answered. |
answer | string | Yes | Full answer text in Markdown. |
ai_platform | string | Yes | AI platform that gave the answer: google (AI Overviews) or chat_gpt. |
model | string | Yes | Model or answer surface, such as google_ai_overview. |
ai_search_volume | integer | Yes | Estimated monthly number of times the question is asked. |
sources | array<object> | Yes | Pages cited in the answer. |
sources.position | integer | Yes | Position of the source in the answer’s list, starting at 1. |
sources.title | string | Yes | Title of the cited page. |
sources.url | string | Yes | URL of the cited page. |
sources.domain | string | Yes | Domain of the cited page. |
sources.source | string | Yes | Name of the site or publisher as shown in the answer. |
sources.text | string | Yes | Excerpt of the cited page shown with the answer. |
search_results | array<object> | Yes | Web results the AI looked at for the answer (chat_gpt only). |
search_results.position | integer | Yes | Position of the source in the answer’s list, starting at 1. |
search_results.title | string | Yes | Title of the cited page. |
search_results.url | string | Yes | URL of the cited page. |
search_results.domain | string | Yes | Domain of the cited page. |
search_results.source | string | Yes | Name of the site or publisher as shown in the answer. |
search_results.text | string | Yes | Excerpt of the cited page shown with the answer. |
brands | array<object> | Yes | Brands named in the answer, in order of appearance (chat_gpt only). |
brands.name | string | Yes | Brand name. |
brands.category | string | Yes | Category of the brand, such as software or local_business. |
brands.position | integer | Yes | Order in which the brand appears in the answer, starting at 1. |
fan_out_queries | array<string> | Yes | Follow-up searches the AI ran while answering. |
first_seen_at | string | Yes | Time this answer was first recorded, in ISO 8601 format. |
last_seen_at | string | Yes | Time this answer was last recorded, in ISO 8601 format. |
target | string | Yes | Domain that was tracked, when the request used target. |
query | string | Yes | Keyword that was tracked, when the request used query. |
location_code | integer | Yes | Location code of the market the answer was recorded in. |
language_code | string | Yes | Language code of the answer. |
Completed Task Response
{
"code": 200,
"data": {
"task_id": "example-seo-llm-mentions",
"status": "succeeded",
"public_id": "ai-search/llm-mentions",
"result_count": 1,
"credits_amount": 40.5,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "llm-mention",
"schema_version": "1.0",
"items": [
{
"id": "dabe244bc30a0aeb7675",
"platform": "ai-search",
"resource": "llm-mentions",
"type": "llm-mention",
"url": null,
"published_at": null,
"collected_at": "2026-11-17T23:54:06.708649Z",
"question": "notion.so",
"answer": "**Notion** is `an all-in-one digital workspace and productivity platform` that combines notes, documents, wikis, databases, kanban boards, and project management tools into a single system.[[1]](https://www.notion.com/)[[2]](https://en.wikipedia.org/wiki/Notion_(productivity_software))[[3]](https://www.thegoodtrade.com/features/what-is-notion/)\n\n### Core Features & Capabilities\n\n- **Blocks & Pages:** Everything you …",
"ai_platform": "google",
"model": "google_ai_overview",
"ai_search_volume": 4400,
"sources": [
{
"position": 1,
"title": "The AI workspace that works for you. | Notion",
"url": "https://www.notion.com/",
"domain": "www.notion.com",
"source": "Notion",
"text": "Platform: Notion AI workspace for teams and agents. Core Capabilities: Capture knowledge in a single system of record, find instant answers with citations, and aut..."
},
{
"position": 2,
"title": "Sign up - Notion",
"url": "https://www.notion.so/signup",
"domain": "www.notion.so",
"source": "Notion",
"text": "Notion - Sign up Notion: your AI workspace. Sign up with your work email Email Use an organization email to easily collaborate with teammates Continue or continue ..."
},
{
"position": 3,
"title": "Log in - Notion",
"url": "https://www.notion.so/login",
"domain": "www.notion.so",
"source": "Notion",
"text": "A collaborative AI workspace, built on your company context. Build and orchestrate agents right alongside your team's projects, meetings, and connected ..."
}
],
"search_results": [],
"brands": [],
"fan_out_queries": [],
"first_seen_at": "2026-11-07T22:31:09Z",
"last_seen_at": "2026-11-07T22:31:09Z",
"target": "notion.so",
"query": null,
"location_code": 2840,
"language_code": "en"
}
]
}
}
}
Authorizations
bearerAuthapiKeyAuth
Body
application/json
- Option 1
- Option 2
Provide a domain in target or a keyword in query. Each row is one question answered by AI Overviews or ChatGPT where the domain is cited or the keyword appears, with the full answer, its cited sources and the question's AI search volume. results_limit defaults to 100 and accepts integers from 1 to 1000.

