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

> Collect Google Images results with the full-size image file, thumbnail, title and source page.

# Google Images

See which pictures Google shows for a query and where they come from. Each result gives the full-size image URL, the thumbnail Google displays, the image's title and alt text, and the page and site it appears on. Use it to check whether your product photos rank for shopping terms, collect visual references for a mood board, or find sites that reuse your images.

```json theme={"dark"}
{
  "query": "modern living room",
  "results_limit": 100
}
```

Provide a search query in query. The defaults are United States (2840) and English (en). results\_limit defaults to 100 and accepts integers from 1 to 700. Each image costs 0.03 credits.

## 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 | URL of the image file, 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 page the image appears on. |
| `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. |
| `title` | `string` | Yes | Title shown for the image. |
| `text` | `string` | Yes | Alternative text of the image. |
| `image_url` | `string` | Yes | URL of the full-size image file. |
| `thumbnail_url` | `string` | Yes | URL of the thumbnail shown in the results. |
| `source` | `string` | Yes | Name of the site the image comes from. |
| `domain` | `string` | Yes | Domain of the page the image appears on. |
| `rank` | `integer` | Yes | Position of the image in the results, starting at 1. |
| `query` | `string` | Yes | Search query the results are for. |

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-images",
    "status": "succeeded",
    "public_id": "seo/google-images",
    "result_count": 1,
    "credits_amount": 0.03,
    "results": {
      "limit": 50,
      "next_cursor": null,
      "has_more": false,
      "schema_id": "image-result",
      "schema_version": "1.0",
      "items": [
        {
          "id": "https://lookaside.instagram.com/seo/google_widget/crawler/?media_id=3967299082734024450",
          "platform": "seo",
          "resource": "google-images",
          "type": "image-result",
          "url": "https://www.instagram.com/p/DcOrX8AGDcC/",
          "published_at": null,
          "collected_at": "2026-11-17T23:54:31.685379Z",
          "title": "Where warmth meets modern luxury. 🤎 A contemporary living room designed  around natural textures, warm walnut tones, soft neutrals and layered  lighting—creating a space that feels sophisticated without",
          "text": "Where warmth meets modern luxury. 🤎 A contemporary living room designed  around natural textures, warm walnut tones, soft neutrals and layered  lighting—creating a space that feels sophisticated without",
          "image_url": "https://lookaside.instagram.com/seo/google_widget/crawler/?media_id=3967299082734024450",
          "thumbnail_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSSREq6zoYqBs7uhNfmAiehv7I6J5I2c9eE-t6YjAWDWw&s",
          "source": "Instagram",
          "domain": "www.instagram.com",
          "rank": 1,
          "query": "modern living room"
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml api-manual/agent-api/agent-api.json POST /v1/seo/google-images
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/seo/google-images:
    post:
      tags:
        - seo
      summary: Google Images API
      description: >-
        Collect Google Images results for a search, with image files and source
        pages.
      operationId: socq_seo_google_images
      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.
                results_limit:
                  type: integer
                  minimum: 1
                  maximum: 700
                  default: 100
              required:
                - query
              description: >-
                Provide a search query in query. Each row is one Google Images
                result with the image file, a thumbnail and the page it appears
                on. results_limit defaults to 100 and accepts integers from 1 to
                700.
      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.