Skip to navigation

Images

Beta
View as MarkdownOpen in Claude

Beta and not actively maintained. This endpoint works, but it is not under active development.

Returns the URLs of images associated to the user query.

Query operators such as site:, filetype: (for example, filetype:png), and OR are supported in q.

Access is limited to early access partners. To request access, email api@you.com.

Authentication

X-API-Keystring

A unique API Key is required to authorize API access. For details, see how to get your API Key.

Query parameters

qstringRequired

The search query used to retrieve relevant image results from the web. There is no server-side default: a missing or empty q returns 422. A whitespace-only q is accepted and returns 200 with zero results, so do not treat it as an error.

countintegerOptional1-100Defaults to 10

The maximum number of image results to return. The supported range is 1–100, and the default is 10.

Response

A JSON object containing an array of image search results.
imagesobjectOptional
metadataobjectOptional

Errors

401
Unauthorized Error
403
Forbidden Error
405
Method Not Allowed Error
422
Unprocessable Entity Error
500
Internal Server Error