Google Serper Shopping
1 credits/call
ae_serper_shopping
Find product listings with prices, ratings, and seller details from Google Shopping.
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. | — |
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_shopping' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"q": "珀莱雅双抗面膜 优惠"
}
}'Response exampleresponse.json
{
"credits": 2,
"searchParameters": {
"engine": "google",
"num": 40,
"page": 1,
"q": "珀莱雅双抗面膜 优惠",
"type": "shopping"
},
"shopping": [
{
"imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcRNIffWRPXPlpqyjGe17_h9SUGcMmKDYtg2hAaZ-II5ivipzu3CMIljw05Y_q_thG3VTZ_hsfSwsYHxdDL1eWPcbU4W6ql49E9kNZN4lM1dGBdISyqsP88L",
"position": 1,
"price": "$7.99",
"productId": "7980864654141166196",
"source": "Yami",
"title": "【中国直邮】 珀莱雅 双抗面膜美白特征 双抗面膜特证版2片"
}
]
}


