# Image Search

By Steven Van · 2026-10-01

Developers can filter sources and formats in Agent API requests, with successful searches costing $2.50 per 1,000 calls.

Photographs, diagrams and illustrations from the web can now appear as structured results during a [Perplexity](<https://creatorstoolbox.com/tools/perplexity>) Agent API request. The new image\_search tool returns image URLs and source-page URLs separately from the assistant’s text.

## Control sources and formats

Developers enable image\_search in a request’s tools list. Each call returns up to five images by default, with a configurable limit from 1 to 30. Domain filters can include or exclude up to 10 domains, but cannot mix both modes. Format filters support BMP, GIF, JPEG, PNG, WebP and SVG. Safe-search filtering is enabled by default.

## Read results and streaming events

An image\_search\_results output item appears before the final assistant message. Each result includes the image URL, source-page URL and dimensions in pixels, with an optional title or description. A successful search with no matches returns an empty results array.

Streaming requests emit separate events when the search starts and when results arrive, matched by call\_id. The completed response also includes the structured results item.

## Per-call pricing

Successful calls cost **$2.50 per 1,000 invocations**. Failed searches return an empty results array with an image\_search\_failed error and have zero tool cost. The [Image Search documentation](<https://docs.perplexity.ai/docs/agent-api/tools/image-search>) includes request examples in Python, TypeScript and cURL.

![Perplexity](<https://www.google.com/s2/favicons?domain=perplexity.ai&sz=128>)

Perplexity

AI-powered answer engine — ask anything and get cited, real-time answers from across the web.

[View Perplexity →](<https://creatorstoolbox.com/tools/perplexity>)

Sources

[Original source](<https://docs.perplexity.ai/changelog#october-2026>)

[Read Image Search on Creators Toolbox](<https://creatorstoolbox.com/blog/perplexity-image-search>)

---
Canonical source: https://creatorstoolbox.com/blog/perplexity-image-search
