Autom
Anleitungen

Collect Google Images

Download and catalog image URLs for any search query using the Autom API — useful for dataset building, visual research, or competitor asset audits.

Overview

This playbook shows how to collect image URLs, titles, and dimensions from Google Images for a given query. Each result includes the direct image URL, the page it was found on, its source domain, and pixel dimensions.

Prerequisites

  • An Autom API key — get one at app.autom.dev
  • Install dependencies for your language:
pip install requests

Steps

Search for images

Call GET /v1/google/images with a q parameter.

import requests

API_KEY = "YOUR_API_KEY"

response = requests.get(
    "https://api.autom.dev/v1/google/images",
    headers={"x-api-key": API_KEY},
    params={"query": "electric car charging station", "gl": "us", "hl": "en"},
)
data = response.json()

Inspect the image results

Each item in images has url (direct image), link (source page), title, domain, source, image_width, and image_height.

for img in data.get("images", []):
    print(f"[{img['position']}] {img['title']}")
    print(f"  Image : {img['url']}")
    print(f"  Source: {img['source']} — {img['image_width']}x{img['image_height']}px\n")

Build an image catalog filtered by minimum size

Filter out thumbnails and save only high-resolution images.

import csv, requests

API_KEY   = "YOUR_API_KEY"
QUERY     = "electric car charging station"
MIN_WIDTH = 800

def fetch_images(query: str, pages: int = 2) -> list:
    results = []
    for page in range(1, pages + 1):
        r = requests.get("https://api.autom.dev/v1/google/images",
            headers={"x-api-key": API_KEY},
            params={"query": query, "gl": "us", "hl": "en", "page": page})
        results.extend(r.json().get("images", []))
    return results

large = [img for img in fetch_images(QUERY) if img.get("image_width", 0) >= MIN_WIDTH]

with open("image_catalog.csv", "w", newline="") as f:
    writer = csv.DictWriter(f, fieldnames=["position", "title", "url", "source", "image_width", "image_height"])
    writer.writeheader()
    writer.writerows(large)

print(f"Saved {len(large)} high-res images to image_catalog.csv")

The url field in each result is the direct link to the image file. Always verify you have the rights to use an image before including it in a dataset or product.

Auf dieser Seite