# Google Images API

$0.01 per call, pay only for 200 responses  
Google Images JSON with image results, thumbnails, original image URLs, source links and dimensions when available. Image rights remain with the source.

/images10 credits / requestSearch

## x402 pay per call

**$0.01 per successful call**, paid in USDC on Base. No account or API key required. The live PAYMENT-REQUIRED header quotes the authoritative price.

### curl request

```
curl -i 'https://api.fastaf.co/x402/v1/images?query=espresso+machine'
```

### Example 402 payment challenge

Illustrative recipient address, not a payment destination. Request a fresh challenge, sign it with an x402 v2 client and retry the same URL with PAYMENT-SIGNATURE. The header is base64 JSON v2; the compatibility body uses v1 aliases on Base. Only successful results settle.

```
HTTP/1.1 402 Payment Required
Content-Type: application/json
PAYMENT-REQUIRED: eyJ4NDAyVmVyc2lvbiI6MiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly9hcGkuZmFzdGFmLmNvL3g0MDIvdjEvaW1hZ2VzP3F1ZXJ5PWVzcHJlc3NvK21hY2hpbmUiLCJkZXNjcmlwdGlvbiI6Ikdvb2dsZSBJbWFnZXMgc2VhcmNoIHJlc3VsdHMiLCJtaW1lVHlwZSI6ImFwcGxpY2F0aW9uL2pzb24ifSwiYWNjZXB0cyI6W3sic2NoZW1lIjoiZXhhY3QiLCJuZXR3b3JrIjoiZWlwMTU1Ojg0NTMiLCJhbW91bnQiOiIxMDAwMCIsImFzc2V0IjoiMHg4MzM1ODlmQ0Q2ZURiNkUwOGY0YzdDMzJENGY3MWI1NGJkQTAyOTEzIiwicGF5VG8iOiIweDExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTEiLCJtYXhUaW1lb3V0U2Vjb25kcyI6MzAwLCJleHRyYSI6eyJuYW1lIjoiVVNEIENvaW4iLCJ2ZXJzaW9uIjoiMiJ9fV19

{
  "error": "payment_required",
  "x402Version": 2,
  "resource": {
    "url": "https://api.fastaf.co/x402/v1/images?query=espresso+machine",
    "description": "Google Images search results",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "10000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x1111111111111111111111111111111111111111",
      "maxTimeoutSeconds": 300,
      "extra": {
        "name": "USD Coin",
        "version": "2"
      }
    }
  ]
}
```

### Decoded PAYMENT-REQUIRED header

```
{
  "x402Version": 2,
  "resource": {
    "url": "https://api.fastaf.co/x402/v1/images?query=espresso+machine",
    "description": "Google Images search results",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "10000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x1111111111111111111111111111111111111111",
      "maxTimeoutSeconds": 300,
      "extra": {
        "name": "USD Coin",
        "version": "2"
      }
    }
  ]
}
```

### JSON discovery response example

Google Images JSON with image results, thumbnails, original image URLs, source links and dimensions when available. Image rights remain with the source. This example is illustrative.

```
{
  "images_results": [
    {
      "title": "Espresso machine",
      "original": "https://example.com/espresso.jpg",
      "link": "https://example.com/espresso",
      "original_width": 1200,
      "original_height": 800,
      "image": "https://example.com/thumb.jpg"
    }
  ]
}
```

### Response with an API key

The same data over REST with a prepaid key. The JSON body is the example above; failed requests are not charged.

```
curl -H "Authorization: Bearer $FASTAF_API_KEY" 'https://api.fastaf.co/v1/images?query=espresso+machine'
```

### MCP tools

google\_images MCP tool calls require an API key or OAuth; x402 payments apply to HTTP data calls.

[Full endpoint reference for agents](/llms/images.txt)

## Pricing

**x402:** $0.01 per successful call, USDC on Base, no account. **API key:** 10 credits per request from one-time credit packs, without expiry. Credit packs are shared by every endpoint and never renew.

Pack

Price

Credits

Per call

Per 1,000 calls

Starter

$10

20,000

$0.005

$5.00

Growth

$29

75,000

$0.00387

$3.87

Scale

$99

300,000

$0.0033

$3.30

Pro

$299

1,000,000

$0.00299

$2.99

Business

$799

3,000,000

$0.00266

$2.66

Free: 500 credits every month after email verification, no card. See [pricing](/pricing/). Alternatives: [FastAF vs SerpApi](/compare/serpapi/), [vs toll402](/compare/toll402/), [vs serp402](/compare/serp402/), [vs AgentBIT](/compare/agentbit/), [vs Amazon PA-API](/compare/amazon-pa-api/).

## Parameters

Name

Description

query

Required Google Images search keywords; no default.

country

Two-letter search country code; default us.

language

Result language code; default en.

domain

Google search domain; default google.com.

page

Zero-based results page, integer at least 0; default 0.

safe

Adult-content filter: active or off; default off.

tbs

Advanced Google Images filter expression copied from a search URL; omitted means no filter.

imgar

Aspect ratio: s (square), t (tall), w (wide), xw (panoramic); omitted means any.

imgsz

Image size such as l, m, i, vga or 2mp; omitted means any size.

image\_color

Color filter such as bw, trans, red, blue or white; omitted means any color.

image\_type

Image type: face, photo, clipart, lineart or animated; omitted means any type.

licenses

License filter: f, fc, fm, fmc, cl or ol; verify rights with the source before reuse.

html

Return raw source HTML when true; default false.

## Response fields

*   images\_results
*   image
*   original
*   link
*   original\_width
*   original\_height

Passing these fields to an LLM? See [token-aware web scraping for agents](/use-cases/token-aware-scraping/).

## Guides

*   [Add FastAF to Claude Code, Codex and Cursor](/how-to/add-fastaf-claude-code-codex-cursor/)
    
    One remote MCP server, three clients: the claude, codex and Cursor mcp.json setup for https://api.fastaf.co/mcp, with the API key auth it really uses.
    
*   [Detect poisoned or incomplete SERP results in AI agents](/how-to/detect-poisoned-incomplete-serp-results/)
    
    A practical checklist for agents that read Google results: spot empty, partial, injected or lookalike results before they reach the model.
    

## FAQ

### What input does this API accept?

Required Google Images search keywords; no default.

### What does the response contain?

Google Images JSON with image results, thumbnails, original image URLs, source links and dimensions when available. Image rights remain with the source.

### How much does one Google Images API call cost?

With x402 it is $0.01 per successful call in USDC on Base, with no account. With an API key it is 10 credits per request, which is $0.005 on the $10 Starter pack down to $0.00266 on the $799 Business pack. Failed requests are never charged.

### Do I need an account or an API key for Google Images API?

Not for x402: send the request, pay the 402 challenge in USDC and retry. For credits, sign up free, confirm your email and use the API key in the Authorization header. Accounts get 500 free credits every month after email verification; they do not apply to x402.

## Other APIs

*   [Google SERP API](/apis/google-serp-api/)
    
    Structured web search results
    
*   [Google Maps API](/apis/google-maps-api/)
    
    Place search and place details
    
*   [Google News API](/apis/google-news-api/)
    
    Current news search results
    
*   [Google Jobs API](/apis/google-jobs-api/)
    
    Job listings and apply links
    

[All APIs →](/apis/) · [Guides and benchmarks on the blog →](/blog/)

### What it is used for

*   Image discovery
*   Visual research

[Start free](/pricing/)[Docs](/docs/)

## Related

*   [Google SERP API](/apis/google-serp-api/)
*   [Google Maps API](/apis/google-maps-api/)
*   [Amazon API](/apis/amazon-api/)