# Google Images

Run a Google Images search and get structured results: image URLs, dimensions, titles, and source pages.

|  |  |
| --- | --- |
| Tool id | `anyapi.google-images` |
| Platform | [Google](https://www.orcarouter.ai/tools/google.md) |
| Capability | [Image results](https://www.orcarouter.ai/tools/google/serp-images.md) |
| Price | $0.002178 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| Idempotent | no |
| Data class | unclassified |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Image search query (e.g. golden gate bridge at sunset). |
| `autocorrect` | boolean | no | Toggle Google spelling autocorrect (default true). Set false to search the exact query without correction. |
| `gl` | string | no | Two-letter country code for result localization (e.g. us, gb, de). |
| `hl` | string | no | Two-letter interface and results language code (e.g. en, es, de). |
| `limit` | integer | no | Maximum number of images to return (1-100, default 20). Requests for 10 results or fewer are billed at a lower rate than larger requests. |
| `location` | string | no | Fine-grained location for result localization, given as a canonical Google location string (e.g. 'New York, United States', 'London, United Kingdom'). More specific than the country-level gl. |
| `timeframe` | string | no | Restrict results to a recent time window: 1h, 1d, 7d, 1y, or all. Default all (no time restriction). |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/anyapi.google-images/run \
  -H "Authorization: Bearer $ORCAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"<query>"}}'
```

```python
import os, requests

resp = requests.post(
    "https://api.orcarouter.ai/v1/tools/anyapi.google-images/run",
    headers={"Authorization": f"Bearer {os.environ['ORCAROUTER_API_KEY']}"},
    json={"input":{"query":"<query>"}},
)
print(resp.json())
```

## Alternatives

| Tool | Source | Price | Health |
| --- | --- | --- | --- |
| [Google Images results for a query](https://www.orcarouter.ai/tools/google/serp-images/x-google-images.md) | — | $0.0275 per call | OK |
| [Google Lens reverse image search by image URL](https://www.orcarouter.ai/tools/google/serp-images/x-google-lens.md) | — | $0.0275 per call | OK |

## FAQ

### How much does Google Images cost?

Google Images costs $0.002178 per call: 1,000 calls cost $2.178.

### What does a $10 budget buy with Google Images?

About 4591 calls at $0.002178 per call.

### What inputs does Google Images need?

Required inputs: query.

### How do I call Google Images?

Send POST /v1/tools/{id}/run with your OrcaRouter API key and a JSON body {"input": {…}}, where {id} is the tool id POST /v1/tools/discover returns for it.

---

Markdown version of https://www.orcarouter.ai/tools/google/serp-images/google-images