Piloterr

Google Shopping

GET
/v2/google/shopping

Search Google Shopping and retrieve structured product listings with prices, ratings, merchants, and product IDs.

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

Product search query on Google Shopping. Use a product name, brand, or category.

Examples:

  • playstation 5: consoles and bundles
  • sony wh-1000xm5: a specific model
  • iphone 16: latest iPhone listings

Example:

playstation 5
page?number

Page number of Shopping results. Each page returns about 20 products. There is no num parameter.

  • 1: First page (default)
  • 2: Second page, etc.
Default"1"
location?string

City or region used to localize Shopping results. Simulates a search from that location and generates the UULE parameter automatically.

Examples:

New York, United States
Paris, France
Berlin, Germany
uule?string

Google-encoded location string (UULE) for precise geo-targeting. Use location instead if you do not already have an encoded value.

google_domain?string

Google domain to use for the search. Defaults to google.com.

Examples:

  • google.com
  • google.co.uk
  • google.fr

Example:

google.com
Default"google.com"
gl?string

Country to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France).

Example:

us
Default"us"
hl?string

Language to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419).

Example:

en
Default"en"
cr?string

Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE).

Example:

countryUS
lr?string

Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de).

Example:

lang_en
safe?string

Adult content filter. active enables Google SafeSearch; off disables it. Omit to use Google default.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
organic_results?array<>
search_parameters?
Example Request
curl -X GET 'https://api.piloterr.com/v2/google/shopping?query=string'
Example Response
{  "organic_results": [    {      "price": "$119.00",      "title": "Sony PlayStation 5 Pro Console",      "rating": 4.5,      "source": "UpTrade",      "reviews": 780,      "position": 1,      "thumbnail": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcPs5-pro",      "product_id": "17823632577842932598",      "product_link": "https://www.google.com/shopping/product/17823632577842932598",      "extracted_price": 119,      "multiple_sources": true    },    {      "price": "$649.99",      "title": "PlayStation 5 Digital Console Marvel's Wolverine Limited Edition Bundle",      "rating": null,      "source": "GameStop",      "reviews": null,      "position": 2,      "thumbnail": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcWolverine",      "product_id": "9908583768713725158",      "product_link": "https://www.google.com/shopping/product/9908583768713725158",      "extracted_price": 649.99,      "multiple_sources": true    },    {      "price": "$499.00",      "title": "Certified Refurbished PlayStation 5 Digital Edition Console Slim",      "rating": null,      "source": "PlayStation",      "reviews": null,      "position": 3,      "thumbnail": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcPs5-slim",      "product_id": "7126033585643939278",      "product_link": "https://www.google.com/shopping/product/7126033585643939278",      "extracted_price": 499,      "multiple_sources": false    }  ],  "search_parameters": {    "q": "playstation 5",    "gl": "us",    "hl": "en",    "page": 1,    "type": "shopping",    "uule": null,    "engine": "google",    "location": null  }}