Google Serper Shopping

1 credits/call
ae_serper_shopping

Find product listings with prices, ratings, and seller details from Google Shopping.

Productivity
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.—
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_shopping' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "q": "珀莱雅双抗面膜 优惠"
  }
}'
Response exampleresponse.json
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片"
    }
  ]
}