# Google Images

Needs q. Served by Litescrape.

Search Google Images.

- Tool ID: `litescrape/google-images`
- Provider: [Litescrape](/providers/litescrape.md)
- Capability: [Web search for agents](/tools/web-search/web-search.md)
- Price: $0.00015 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.00015
}
```

Pricing source: [https://litescrape.com/pricing](https://litescrape.com/pricing). $0.15 per 1,000 successful HTTP 200 requests; every native endpoint costs one call. Failed requests are not billed. Prepaid credits expire after six months..

Price verification date: 2026-11-03.

## Complete input schema


```json
{
  "additionalProperties": false,
  "properties": {
    "q": {
      "maxLength": 2048,
      "minLength": 1,
      "type": "string",
      "description": "Image search query, up to 2,048 characters."
    },
    "hl": {
      "default": "en",
      "pattern": "^[a-z]{2,3}(?:-[A-Za-z]{2,8})?$",
      "type": "string",
      "description": "Language of the Google Images interface."
    },
    "gl": {
      "anyOf": [
        {
          "pattern": "^[a-z]{2}$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Two-letter country code used to localize results."
    },
    "safe": {
      "anyOf": [
        {
          "enum": [
            "active",
            "off"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Set active to filter explicit images, or off to disable SafeSearch."
    },
    "tbs": {
      "anyOf": [
        {
          "maxLength": 4096,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google image filters, such as isz:l for large images, itp:photo for photographs, or ic:trans for transparent images."
    },
    "license": {
      "anyOf": [
        {
          "enum": [
            "creative_commons",
            "commercial_and_other",
            "free_to_share",
            "free_to_share_commercially",
            "free_to_modify",
            "free_to_modify_commercially"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Limit results to images Google lists under these usage rights. Use creative_commons for Creative Commons licenses, or commercial_and_other for commercial and other licenses such as stock photos.\n\nfree_to_share: free to use or share. free_to_share_commercially: free to use or share, even commercially. free_to_modify: free to use, share or modify. free_to_modify_commercially: free to use, share or modify, even commercially. Combine license with other tbs filters, such as isz:l, but do not also send a sur: usage-rights filter in tbs."
    },
    "start": {
      "default": 0,
      "maximum": 1000,
      "minimum": 0,
      "type": "integer",
      "description": "Google's page offset. For the next page, use pagination.next_start from the response and keep the same query and filters. This offset is independent of num and the number of returned images."
    },
    "num": {
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "type": "integer",
      "description": "Maximum number of images returned from this page, from 1 to 100. This limits the parsed response; Google may supply fewer images."
    },
    "device": {
      "default": "desktop",
      "enum": [
        "desktop",
        "tablet",
        "mobile"
      ],
      "type": "string",
      "description": "Device profile used for the image search."
    }
  },
  "required": [
    "q"
  ],
  "type": "object"
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "litescrape/google-images",
  "input": {
    "q": "red panda",
    "num": 20,
    "hl": "en",
    "gl": "us",
    "license": "creative_commons"
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://litescrape.com/docs/reference#images-parameters)

[REST inspection](https://api.agentik.cc/v1/tools/litescrape/google-images) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/litescrape/google-images) · [Agent index](/llms.txt)