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

# Google AI Mode

> Get the full Google AI Mode answer for a search, in Markdown, with every source it cites.

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

```json theme={"dark"}
{
  "query": "best crm for startups",
  "location_code": 2840,
  "language_code": "en"
}
```

Provide a search query in query. The defaults are United States (2840) and English (en). Each request costs 2 credits and returns one row with the answer and its sources.

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

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-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"
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml api-manual/agent-api/agent-api.json POST /v1/ai-search/google-ai-mode
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/google-ai-mode:
    post:
      tags:
        - ai-search
      summary: Google AI Mode API
      description: Collect the Google AI Mode answer for a search, with every cited source.
      operationId: socq_ai_search_google_ai_mode
      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.
                query:
                  type: string
                  minLength: 1
                  description: Search query, as typed into the search box.
              required:
                - query
              description: >-
                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.
      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.