Skip to main content
POST
Google Images API

Google Images

See which pictures Google shows for a query and where they come from. Each result gives the full-size image URL, the thumbnail Google displays, the image’s title and alt text, and the page and site it appears on. Use it to check whether your product photos rank for shopping terms, collect visual references for a mood board, or find sites that reuse your images.
Provide a search query in query. The defaults are United States (2840) and English (en). results_limit defaults to 100 and accepts integers from 1 to 700. Each image costs 0.03 credits.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide a search query in query. Each row is one Google Images result with the image file, a thumbnail and the page it appears on. results_limit defaults to 100 and accepts integers from 1 to 700.

query
string
required

Search query, as typed into the search box.

Minimum string length: 1
callback_url
string<uri>
language
string
Minimum string length: 1
language_code
string
Required string length: 2 - 10
location_code
integer

Search market location code.

Required range: x >= 1
location_name
string

Search market location name.

Minimum string length: 1
results_limit
integer
default:100
Required range: 1 <= x <= 700

Response

Task accepted

code
integer
data
object