Image Search API Quickstart

curl https://api.parallel.ai/v1/images/search \
  -H "Content-Type: application/json" \
  -H "x-api-key: $PARALLEL_API_KEY" \
  -d '{
    "objective": "Photos of the Golden Gate Bridge at sunset, showing the full span",
    "search_queries": [
      "Golden Gate Bridge sunset",
      "Golden Gate Bridge full span photo"
    ]
  }'

import os

import requests

response = requests.post(
    "https://api.parallel.ai/v1/images/search",
    headers={"x-api-key": os.environ["PARALLEL_API_KEY"]},
    json={
        "objective": "Photos of the Golden Gate Bridge at sunset, showing the full span",
        "search_queries": [
            "Golden Gate Bridge sunset",
            "Golden Gate Bridge full span photo",
        ],
    },
    timeout=60,
)
response.raise_for_status()

for image in response.json()["results"]:
    print(f"{image['title']}: {image['image_url']}")
    print(f"  from {image['source_page_url']}")

async function main() {
    const response = await fetch("https://api.parallel.ai/v1/images/search", {
        method: "POST",
        headers: {
            "Content-Type": "application/json",
            "x-api-key": process.env.PARALLEL_API_KEY!,
        },
        body: JSON.stringify({
            objective: "Photos of the Golden Gate Bridge at sunset, showing the full span",
            search_queries: [
                "Golden Gate Bridge sunset",
                "Golden Gate Bridge full span photo",
            ],
        }),
    });
    if (!response.ok) {
        throw new Error(`Image Search failed: ${response.status} ${await response.text()}`);
    }

    const { results } = await response.json();
    for (const image of results) {
        console.log(`${image.title}: ${image.image_url}`);
        console.log(`  from ${image.source_page_url}`);
    }
}

main().catch(console.error);