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.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
q | string | Yes | Search query. The request body field name must be q (not query). | — |
gl | string | No | Country code / geographic market, e.g. us. | — |
hl | string | No | Language code, e.g. en. | — |
num | integer | No | Number of results requested. | — |
tbs | string | No | Google time/search filter string, e.g. qdr:w. | — |
page | integer | No | Page number, when supported. | — |
safe | string | No | Safe search mode, e.g. active. | — |
location | string | No | Human-readable location bias, when supported. | — |
autocorrect | boolean | No | Whether query autocorrect should be enabled. | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest 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
{
"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



