Google Shopping
Search Google Shopping and retrieve structured product listings with prices, ratings, merchants, and product IDs.
Credit cost: 1 credit per call
Autorização
ApiKeyAuth Your API key. Include it in the x-api-key header for every request.
In: header
Parâmetros de consulta
Product search query on Google Shopping. Use a product name, brand, or category.
Examples:
playstation 5: consoles and bundlessony wh-1000xm5: a specific modeliphone 16: latest iPhone listings
Example:
playstation 5Page number of Shopping results. Each page returns about 20 products. There is no num parameter.
1: First page (default)2: Second page, etc.
"1"Two-letter country code for the Google Shopping country context.
us: United States (default)fr: Francegb: United Kingdomde: Germany
Example:
us"us"Two-letter language code for the Google Shopping interface language.
en: English (default)fr: Frenchde: Germanes: Spanish
Example:
en"en"City or region used to localize Shopping results. Simulates a search from that location and generates the UULE parameter automatically.
Examples:
New York, United StatesParis, FranceBerlin, GermanyGoogle-encoded location string (UULE) for precise geo-targeting. Use location instead if you do not already have an encoded value.
Corpo da resposta
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/google/shopping?query=string"{ "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 }}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}