drain.lat API

GET /search

Search Google Images and retrieve structured image results with metadata.

GET /api/v1/imagesearch/search

string

required

Search query/keywords. Can also use query parameter.

number

Number of results to return. Range: 1-10. Default 10.

number

Starting index for pagination. Default 1.

string

Safe search level. Options: off, active. Default off.

string

Image size filter. Options: huge, icon, large, medium, small, xlarge, xxlarge.

string

Image type filter. Options: clipart, face, lineart, stock, photo, animated.

string

Color type filter. Options: color, gray, mono, trans.

string

Dominant color filter. Options: black, blue, brown, gray, green, orange, pink, purple, red, teal, white, yellow.

string

File format filter. Options: jpg, png, gif, bmp, svg, webp, ico, raw.

curl "https://drain.lat/api/v1/imagesearch/search?q=cats" \
  -H "x-api-key: YOUR_API_KEY"

curl "https://drain.lat/api/v1/imagesearch/search?q=sunset&num=5&imgSize=large&imgDominantColor=orange" \
  -H "x-api-key: YOUR_API_KEY"

const res = await fetch(
  "https://drain.lat/api/v1/imagesearch/search?q=cats&num=10",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const data = await res.json();

const params = new URLSearchParams({
  q: "logo",
  imgType: "clipart",
  fileType: "png",
  num: 5
});

const res = await fetch(
  `https://drain.lat/api/v1/imagesearch/search?${params}`,
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const data = await res.json();

import requests

res = requests.get(
    "https://drain.lat/api/v1/imagesearch/search",
    params={"q": "cats", "num": 10},
    headers={"x-api-key": "YOUR_API_KEY"}
)
print(res.json())

import requests

params = {
    "q": "nature",
    "imgDominantColor": "green",
    "safe": "medium",
    "imgSize": "large",
    "num": 5
}

res = requests.get(
    "https://drain.lat/api/v1/imagesearch/search",
    params=params,
    headers={"x-api-key": "YOUR_API_KEY"}
)
print(res.json())

string

The search query used.

array

Show image object

string

Image title/alt text.

string

Direct URL to the full-size image.

string

Domain name of the image host.

string

Description or context of the image.

string

URL to thumbnail version.

number

Thumbnail width in pixels.

number

Thumbnail height in pixels.

string

Direct URL to full image (same as link).

number

Full image width in pixels.

number

Full image height in pixels.

string

URL of the page containing the image.

string

MIME type (e.g. image/jpeg, image/png).

number

File size in bytes.

number

Number of results returned in this response.

number

Estimated total results available.

number

Search execution time in seconds.

number

Starting index for next page of results. null if no more pages.

Response

{
  "query": "cats",
  "images": [
    {
      "title": "Cute cat sitting on windowsill",
      "link": "https://example.com/images/cat.jpg",
      "displayLink": "example.com",
      "snippet": "A beautiful orange cat enjoying the sunshine",
      "thumbnailUrl": "https://encrypted-tbn0.gstatic.com/images?q=...",
      "thumbnailWidth": 150,
      "thumbnailHeight": 150,
      "imageUrl": "https://example.com/images/cat.jpg",
      "imageWidth": 1920,
      "imageHeight": 1080,
      "contextLink": "https://example.com/cats-page",
      "fileFormat": "image/jpeg",
      "byteSize": 245678
    },
    {
      "title": "Black and white cat portrait",
      "link": "https://another-site.com/cat2.png",
      "displayLink": "another-site.com",
      "snippet": "Professional cat photography",
      "thumbnailUrl": "https://encrypted-tbn0.gstatic.com/images?q=...",
      "thumbnailWidth": 150,
      "thumbnailHeight": 100,
      "imageUrl": "https://another-site.com/cat2.png",
      "imageWidth": 2560,
      "imageHeight": 1440,
      "contextLink": "https://another-site.com/gallery",
      "fileFormat": "image/png",
      "byteSize": 512000
    }
  ],
  "total": 10,
  "totalResults": 1500000,
  "searchTime": 0.28,
  "nextPage": 11,
  "scrapedAt": "2026-05-31T10:30:00.000Z"
}

Pagination

To get the next page of results, use the nextPage value from the response as the start parameter:

# First page
GET /api/v1/imagesearch/search?q=cats

# Second page
GET /api/v1/imagesearch/search?q=cats&start=11

# Third page
GET /api/v1/imagesearch/search?q=cats&start=21

Filter Examples

# Large sunset images
GET /api/v1/imagesearch/search?q=sunset&imgSize=large

# PNG clipart logos
GET /api/v1/imagesearch/search?q=logo&imgType=clipart&fileType=png

# Green nature photos
GET /api/v1/imagesearch/search?q=nature&imgDominantColor=green&imgType=photo

# Safe search for faces
GET /api/v1/imagesearch/search?q=people&imgType=face&safe=high

# Black and white photos
GET /api/v1/imagesearch/search?q=vintage&imgColorType=gray

Uses Google Custom Search API quota (100 queries per day on free tier). Returns 429 error when quota is exceeded. Results are cached for 10 minutes to reduce quota usage.

Get Started

Social

Gaming

Media

Finance

Utilities

Developer Tools

Image Search

Google Image Search

Filter Examples

​Google Image Search

​Pagination

​Filter Examples

Google Image Search

Pagination

Filter Examples