Google Serper Images

1 credits/call
ae_serper_images

Search for images using Google Images to find visual assets, photos, and thumbnails for your projects.

ImageSearch
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
qstringYesSearch query. The request body field name must be q (not query).—
glstringNoCountry code / geographic market, e.g. us.—
hlstringNoLanguage code, e.g. en.—
numintegerNoNumber of results requested.—
tbsstringNoGoogle time/search filter string, e.g. qdr:w.—
pageintegerNoPage number, when supported.—
safestringNoSafe search mode, e.g. active.—
locationstringNoHuman-readable location bias, when supported.—
autocorrectbooleanNoWhether query autocorrect should be enabled.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_serper_images' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "gl": "cn",
    "hl": "zh-CN",
    "num": 10,
    "q": "孙燕姿 蓝色海边 夜色 黑色斗篷 短发 壁纸 高清"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "credits": 1,
  "images": [
    {
      "domain": "haowallpaper.com",
      "googleUrl": "https://www.google.com/imgres?imgurl=https%3A%2F%2Fimg.haowallpaper.com%2Fcache_file%2F2024_06_19_file%2F15053539917860160.png&tbnid=aPmntgullnlTkM&imgrefurl=https%3A%2F%2Fhaowallpaper.com%2FhomeViewLook%2F16545291599793536&docid=FRuVks_sSp8E-M&w=890&h=501",
      "imageHeight": 501,
      "imageUrl": "https://img.haowallpaper.com/cache_file/2024_06_19_file/15053539917860160.png",
      "imageWidth": 890,
      "title": "4k孙燕姿壁纸|舞台演唱剪影背景图片- 蓝色氛围「哲风壁纸」"
    }
  ],
  "searchParameters": {
    "engine": "google",
    "gl": "cn",
    "hl": "zh-cn",
    "num": 10,
    "q": "孙燕姿 蓝色海边 夜色 黑色斗篷 短发 壁纸 高清",
    "type": "images"
  }
}

This example shows part of the response. Copied content is valid JSON.

Guides using this tool

See how this tool fits into real workflows