For AI agents: llms.txt.

Reverse-image search

Request example

POST/api/v1/reverse-image
Scope
search
Formats
JSON · SSE
Sandbox
Free fixtures

Authorization

Authorizationheaderrequired

Send Bearer $DEEPSEARCH_API_KEY with the search scope. The free sandbox uses the published test key.

Body parameters

imageUrlstringrequired

An https URL to the image to search. DeepSearch fetches and re-hosts it privately, then queries the reverse-image provider with a short-lived signed URL.

formatenum

json collects the result; sse streams progress and result events.

jsonsse

Default: json

sandboxboolean

Return deterministic, unmetered fixtures.

Default: false

Response

JSON responses preserve the operation result and include request metadata, usage, and collected events. SSE delivers progress and result events as they arrive.

Sources & coverage

Submit an image URL and get candidate public pages, match provenance, and visually similar images. Provider candidates require verification; visual resemblance alone does not establish image reuse. Honest image-appearance matching - DeepSearch does NOT perform facial recognition and never identifies a person from their face. The image is re-hosted privately before it reaches the provider. Reverse-image lookup is Medium usage.

Usage & caching

Reverse-image lookup is Medium usage; idempotent replays use no usage.

Examples illustrate the contract. Test request runs the selected deployment; sandbox fixtures are unmetered.

Skip to content