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

# AI Search Visibility

> Measure how often AI answers mention a domain or keyword, which sources they lean on and which brands appear beside it.

# AI Search Visibility

A share-of-voice report for AI search. One request returns the total number of AI answers that mention your domain or keyword and the monthly search volume behind them, then breaks those answers down: the domains they cite most, the domains in the web results the AI looked at, and on ChatGPT the brands and brand categories named in the same answers. Run it for your brand and two competitors and you have a quick comparison of who AI recommends.

```json theme={"dark"}
{
  "target": "hubspot.com",
  "platform": "chat_gpt"
}
```

Provide a domain in target or a keyword in query, not both. platform is google (the default) or chat\_gpt (tracked for the United States in English); brand rows appear on chat\_gpt. Rows are the total followed by up to 10 entries for each breakdown. Each request costs 40 credits plus 0.5 credits per row; the 40 credits also apply when nothing 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 | Dimension and name, such as `source_domain:www.hubspot.com`. |
| `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 | Homepage of the domain, or the page URL, when the row is a domain or page. |
| `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. |
| `dimension` | `string` | Yes | What the row counts: `total`, `source_domain`, `search_result_domain`, `brand`, `brand_category`, `domain` or `page`. |
| `name` | `string` | Yes | Domain, page URL, brand or category the row counts; for `total`, the AI platform. |
| `rank` | `integer` | Yes | Position within its dimension, by mentions, starting at 1. |
| `mentions_count` | `integer` | Yes | Number of AI answers that mention or cite it. |
| `ai_search_volume` | `integer` | Yes | Combined monthly AI search volume of those answers' questions. |
| `ai_platform` | `string` | Yes | AI platform the answers come from: `google` or `chat_gpt`. |
| `target` | `string` | Yes | Domain that was tracked, when the request used target. |
| `query` | `string` | Yes | Keyword that was tracked, when the request used query. |

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-brand-metrics",
    "status": "succeeded",
    "public_id": "ai-search/llm-brand-metrics",
    "result_count": 1,
    "credits_amount": 40.5,
    "results": {
      "limit": 50,
      "next_cursor": null,
      "has_more": false,
      "schema_id": "llm-metric",
      "schema_version": "1.0",
      "items": [
        {
          "id": "total:chat_gpt",
          "platform": "ai-search",
          "resource": "llm-brand-metrics",
          "type": "llm-metric",
          "url": null,
          "published_at": null,
          "collected_at": "2026-11-17T23:54:07.514071Z",
          "dimension": "total",
          "name": "chat_gpt",
          "rank": 1,
          "mentions_count": 1448,
          "ai_search_volume": 41029,
          "ai_platform": "chat_gpt",
          "target": "hubspot.com",
          "query": null
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml api-manual/agent-api/agent-api.json POST /v1/ai-search/llm-brand-metrics
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-brand-metrics:
    post:
      tags:
        - ai-search
      summary: AI Search Visibility API
      description: >-
        Measure how often AI answers mention a domain or keyword, with the
        sources and brands around it.
      operationId: socq_ai_search_llm_brand_metrics
      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.
                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. Rows give the
                total mentions and AI search volume, then the most cited source
                domains, the domains in the answers' search results, and, on
                chat_gpt, the brands and brand categories named alongside it.
              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.