> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# LLM Mentions

> See the AI Overviews and ChatGPT answers that cite your domain or mention your keyword, with every source they used.

# 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.

```json theme={"dark"}
{
  "target": "notion.so",
  "platform": "google",
  "results_limit": 100
}
```

Provide a domain in target or a keyword in query, not both. platform is google (AI Overviews, the default) or chat\_gpt (tracked for the United States in English). results\_limit defaults to 100 and accepts integers from 1 to 1000. Each request costs 40 credits plus 0.5 credits per answer returned; the 40 credits also apply when no answer is found.

## 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, use `fields` 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. |

The following example shows the response format for a completed task. Actual data depends on your query.

## Completed Task Response

```json theme={"dark"}
{
  "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"
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml api-manual/agent-api/agent-api.json POST /v1/ai-search/llm-mentions
openapi: 3.1.0
info:
  title: SocQ Agent API
  version: v1-87892a6484c2
  description: Asynchronous social data API generated from the SocQ Capability Registry.
servers:
  - url: https://api.socq.ai
security: []
paths:
  /v1/ai-search/llm-mentions:
    post:
      tags:
        - ai-search
      summary: LLM Mentions API
      description: >-
        Collect the AI Overviews and ChatGPT answers that cite a domain or
        mention a keyword.
      operationId: socq_ai_search_llm_mentions
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              additionalProperties: false
              properties:
                callback_url:
                  type: string
                  format: uri
                language:
                  type: string
                  minLength: 1
                language_code:
                  type: string
                  minLength: 2
                  maxLength: 10
                location_code:
                  type: integer
                  minimum: 1
                  description: Search market location code.
                location_name:
                  type: string
                  minLength: 1
                  description: Search market location name.
                platform:
                  type: string
                  minLength: 1
                  enum:
                    - chat_gpt
                    - google
                  default: google
                  description: >-
                    AI answers to read: google (AI Overviews) or chat_gpt
                    (ChatGPT, tracked for the United States in English).
                query:
                  type: string
                  minLength: 1
                  description: >-
                    Keyword or brand name to track in AI answers, such as crm
                    software. Give either target or query.
                results_limit:
                  type: integer
                  minimum: 1
                  maximum: 1000
                  default: 100
                target:
                  type: string
                  minLength: 1
                  description: >-
                    Domain to track in AI answers, such as hubspot.com. Give
                    either target or query.
              required: []
              description: >-
                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.
              anyOf:
                - required:
                    - query
                - required:
                    - target
              allOf:
                - not:
                    required:
                      - query
                      - target
      responses:
        '200':
          description: Task accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSubmitResponse'
        '422':
          description: Input validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentValidationErrorResponse'
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  schemas:
    AgentSubmitResponse:
      type: object
      properties:
        code:
          type: integer
          const: 200
        data:
          type: object
          properties:
            task_id:
              type: string
            status:
              type: string
            created_time:
              type:
                - string
                - 'null'
          required:
            - task_id
            - status
    AgentValidationErrorResponse:
      type: object
      properties:
        code:
          type: integer
          const: 422
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            details:
              type: object
          required:
            - message
            - type
      required:
        - code
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.