Serper Shopping

POST /search/serper/shopping, forwarded to POST https://google.serper.dev/shopping. Same Serper account and key as Serper web search; a different endpoint.

Request

curl -X POST "https://api.withgrowl.com/v1/search/serper/shopping" \
  -H "Authorization: Bearer elo_pub_..." \
  -H "Content-Type: application/json" \
  -d '{ "q": "wireless mouse", "num": 20, "gl": "us" }'

Common fields are below. The body goes to Serper as sent, so everything in Serper’s Shopping reference works; that reference is the complete, current schema.

Field	Description
q	The shopping query.
num	Number of results.
gl	Country code, lower case, for example us.
hl	Language code, lower case, for example en.

Response

Results are under shopping. Each has title, link, price, source and, when Serper has one, the product picture in imageUrl.

{
  "shopping": [
    {
      "title": "Logitech M170 Wireless Mouse",
      "link": "https://www.example.com/mouse",
      "price": "$14.99",
      "source": "Example Store",
      "imageUrl": "https://www.example.com/mouse.jpg",
      "position": 1
    }
  ]
}

Through Elo

• Serper takes its key in X-API-KEY. Keep that header and put your Elo key in it, or use Authorization: Bearer; Elo sets Serper’s key itself.