Skip to content
Serpwire
TR

Endpoints · 02/13

Images

Image results with full-size and thumbnail URLs and dimensions.

EndpointPOSThttps://serp-api.ozymoz.com/images
Credits per call1

Parameters

NameDescription
qrequiredThe search query.
glCountry to search from, as a two-letter code (us, tr, de…).Default: us
hlInterface language, as a language code (en, tr, de…).Default: en
numNumber of results per page.Default: 10
pageResults page, starting at 1.Default: 1
tbsTime filter: qdr:h (hour), qdr:d (day), qdr:w (week), qdr:m (month), qdr:y (year).

Example request

curl -X POST 'https://serp-api.ozymoz.com/images' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "q": "galata tower at night",
    "gl": "us",
    "hl": "en"
  }'

Example response

Illustrative values in the real shape. Top-level keys: images.

response.json
{
  "searchParameters": {
    "type": "images",
    "engine": "google",
    "q": "galata tower at night",
    "gl": "us",
    "hl": "en"
  },
  "images": [
    {
      "title": "Galata Tower lit up at night",
      "imageUrl": "https://images.example.com/galata-night.jpg",
      "imageWidth": 1600,
      "imageHeight": 1067,
      "thumbnailUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:…",
      "thumbnailWidth": 275,
      "thumbnailHeight": 183,
      "source": "Example Travel",
      "domain": "www.example-travel.com",
      "link": "https://www.example-travel.com/istanbul/galata",
      "position": 1
    }
  ],
  "credits": 1
}

Good to know

Results come from Google Images; some sources only expose a smaller original.

Errors · Batch requests · Rate limits