Google Shopping

💡 Google Shopping results and currency are based on IP location! Set your proxy to the desired region.

🌟 For countries with Color-coded pagination (e.g., the UK, Brazil), please read section "Limitations".

Input

• Queries (array)

  Returns data for the listed queries (search terms).

  Google Shopping does not have traditional filters. Instead, they must be specified in the query itself.

  For example:

  • No filters: "facial moisturizers"

  • With filters: "facial moisturizers under 50ml jar sale between $5 and $100"

    • Size: "under 50ml jar"

    • Discounted only: "sale"

    • Price range: "between $5 and $100"

• Include details (boolean)

  • False: Returns items with general information. One request per query.

  • True: Also returns details, such as offers, reviews, and more. Two requests per query.

• ISP (boolean)

  • False: Returns default items based on the IP location (e.g., proxy region).

  • True: Refines results based on the Internet Service Provider used by the IP.

• Cookie (string)

  💡 To ensure performance, we recommend setting your own cookie.

  You can get it from your browser after visiting any Google Shopping page.

  The cookie starts with "NID=" or "__Secure-ENID" or "SOCS=".

• Old engine (boolean)

  Set to True if you know the collection will run against the old engine.

  Avoids using additional requests to determine whether the IP is from a country where Google supports the new (e.g., USA, France) or old engine (e.g., the UK, Brazil).

  See section "Limitations".

• Custom Input (Advanced) (string)

  See section "Limitations".

• Delay (integer)

  Waiting time between each request and query. Google Shopping is VERY sensitive to scraping.

  A random value will be chosen between the minimum and maximum inputs.

  For example, if you have 2 queries with a maximum of 10 results, the parameter "Include details" enabled, and a delay of 3 seconds:

  (2 queries * (10 results * 2 requests)) * 3s delay = 120 seconds = 2 minutes

Example Output

1{
2	"query": "facial moisturizers under 50ml jar sale between $5 and $100",
3	"data": {
4		"title": "Clinique Moisture Surge 100H Auto-Replenishing Hydrator",
5		"url": "https://www.google.com/search?ibp=oshop&q=facial+moisturizers+under+50ml+jar+sale+between+$5+and+$100&prds=catalogid:6765106101917583429,gpcid:11517421853804152154,rds:PC_11517421853804152154|PROD_PC_11517421853804152154,mid:576462491832866118,pvt:hg,isp:true",
6		"image": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcSIFJuWZ_9KoppHK_4Egsujj0RHwT1R4hvJlQ-SCzLbgKpNnJk6NhPlAeGgBy_fN-akwh_ANChORMNYLfv61jdPxgVBLJFDuNX3R2V-szWa7M3Ss-e8uVwlkA",
7		"price": 23.5,
8		"price_source": null,
9		"price_source_curr": null,
10		"discounted": true,
11		"discount_percent": 50,
12		"original_price": 47,
13		"lowprice": false,
14		"lowprice_price": null,
15		"popular": false,
16		"preowned": false,
17		"seller": "Ulta Beauty",
18		"seller_logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn%3AANd9GcTw_IOMaqLrGyGT48e4jpAfSaRiMZtn4PEv4LfXWt9w7lmxj4iJbDRMSJi28fvoGbQJ1NSBMNcp45ZnWE3CNAUIzm7UNLw",
19		"more_sellers": true,
20		"free_delivery": true,
21		"free_delivery_conditions": "Free delivery on $35+",
22		"returns": true,
23		"returns_conditions": "30-day returns",
24		"rating": 4.7,
25		"reviews_count": 42000,
26		"details": {
27			"title": "Clinique Moisture Surge 100H Auto-Replenishing Hydrator",
28			"productName": "Moisture Surge™ 100H Auto-Replenishing Hydrator | Moisturisers",
29			"url": "https://www.clinique.co.uk/product/1687/83690/skin-care/moisturisers/moisture-surgetm-100h-auto-replenishing-hydrator",
30			"description": "Clinique's Moisture Surge 100 Hour Auto-Replenishing Hydrator is an oil-free gel-cream moisturizer with exclusive aloe bio-ferment and hyaluronic acid penetrates deep into skin's surface - for hydration that goes over 10 layers deep and lasts for 100 hours, even after washing your face.",
31			"manufacturer": "Clinique",
32			"manufacturer_favicon": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcR2OhAmKSoPLBewDjeSpkoId_gwp5fmtU2PVEAfwg68I4htSRQIOerT2X2UqxLcWP39SpvuBDZiFVTtG6vTGH6l_Eblp3vopscAiS3P",
33			"lowPrice": null,
34			"highPrice": null,
35			"offers": [
36				{
37					"productName": "Clinique Moisture Surge 100H Auto-Replenishing Hydrator Oil Free Face Moisturizer With Hyaluronic Acid For All Skin Types | Hydrating + Moisturizing",
38					"url": "https://www.amazon.com/Clinique-Moisture-Auto-Replenishing-Hydrator-Moisturizer/dp/B002A97L3I?source=ps-sl-shoppingads-lpcontext&ref_=fplfs&psc=1&smid=ATVPDKIKX0DER&gPromoCode=sns_us_en_5_2023Q4&gQT=1",
39					"price": 17,
40					"shipping_fee": 6.99,
41					"total_price": 26.12,
42					"discounted": false,
43					"original_price": null,
44					"discount_percent": null,
45					"seller": "Amazon.com",
46					"inStock": true,
47					"inStock_conditions": "In stock online",
48					"has_free_shipping": false,
49					"shipping_conditions": [
50						"$6.99 delivery"
51					]
52				},
53				{
54					"productName": "Clinique Moisture Surge 100H Auto-Replenishing Hydrator - 50ml | Oil-Free Hydrating Moisturizer for All Skin Types",
55					"url": "https://www.clinique.com/product/1687/83690/skincare/moisturizers/moisture-surgetm-100h-auto-replenishing-hydrator?size=1.7oz_/_50ml&gPromoCode=7DAYJan25&gQT=1",
56					"price": 47,
57					"shipping_fee": 8,
58					"total_price": 59.88,
59					"discounted": false,
60					"original_price": null,
61					"discount_percent": null,
62					"seller": "Clinique",
63					"inStock": true,
64					"inStock_conditions": "In stock online",
65					"has_free_shipping": true,
66					"shipping_conditions": [
67						"$8 delivery Jan 15 – 20",
68						"Free $50+"
69					]
70				},
71				{
72					"productName": "CLINIQUE Mini Moisture Surge 100H Auto-Replenishing Hydrator Gel-Cream Moisturizer with Hyaluronic Acid 0.5 oz/ 15 mL",
73					"url": "https://www.sephora.com/product/clinique-mini-moisture-surge-trade-100-hour-auto-replenishing-hydrator-P468818?country_switch=us&lang=en&skuId=2421683&srsltid=AfmBOor9gnE5vFY3rhkF9bfObZwmWXrxQ8XkzACGqzYQxiACBYPp7GC1k3k&gQT=1",
74					"price": 17,
75					"shipping_fee": 6.95,
76					"total_price": 26.11,
77					"discounted": false,
78					"original_price": null,
79					"discount_percent": null,
80					"seller": "Sephora",
81					"inStock": true,
82					"inStock_conditions": "In stock online",
83					"has_free_shipping": true,
84					"shipping_conditions": [
85						"$6.95 delivery Jan 15 – 21",
86						"Free $50+"
87					]
88				}
89			],
90			"properties": [
91				{
92					"name": "Active Ingredients",
93					"value": "aloe bioferment, hyaluronic acid"
94				},
95				{
96					"name": "Free Of",
97					"value": "Fragrance"
98				},
99				{
100					"name": "Contains",
101					"value": "Aloe Vera, Hyaluronic Acid"
102				},
103				...
104			],
105			"rating": 4.703843116760254,
106			"reviews_count": 41684,
107			"sponsored": [
108				{
109					"rating": 5,
110					"url": "https://www.productreview.com.au/listings/clinique-moisture-surge-100h-auto-replenishing-hydrator",
111					"source": "ProductReview",
112					"description": "Clinique Moisture Surge 100H Auto-Replenishing Hydrator (Moisturiser): 5 out of 5 stars from 4 genuine reviews on Australia's largest opinion site ProductReview…",
113					"title": "Clinique Moisture Surge 100H Auto-Replenishing Hydrator reviews",
114					"favicon": "https://encrypted-tbn0.gstatic.com/faviconV2?url=https://www.productreview.com.au&client=SHOPPING&size=16&type=FAVICON&fallback_opts=TYPE,SIZE,URL"
115				},
116				...
117			],
118			"reviews": [
119				{
120					"title": "",
121					"author": "rachel.m",
122					"rating": 5,
123					"date": "5 months ago",
124					"url": "https://customerreviews.google.com/feedback?reviewname=AIe9_BFQN_oBZDfpYoCAqeorXfzuk7pRjG1eiWca8FZOeFQw5n8KGDCgEUpO6RJEu3S54OJAFFUk7b4gNnRHxrHxvrLbrhZh-5Lyvk8qIjFWZ0rueAUEvfYWJjnTV9k3ZsFlHf45bpsd",
125					"content": "My grandma tuned me into this stuff when I was just in HS. As a swimmer, it kept the chlorine dryness at bay. I used it through college whenever mom or grandma got it in the free gift. I have since gone through phases with different moisturizers -- having worked in beauty PR for a good chunk of my career I had access to a lot of prestige products that I'd never be able to afford otherwise but I returned to this one for travel in my 30s as I needed something that kept my skin better hydrated for long haul flights, which was just throwing my face into chaos for days every timw and holy wow, it is so good! Easily my top even over pricier prestige moisturizers. The formula is updated to hydrate longer than when I was younger, it feels instantly quenching but silky, light, and not sticky at all. My skin has improved (and it keeps it happy on flights!), I get fewer breakouts, it layers nicely over my serums, and provides a great base for my sunscreen and makeup -- no pilling! My other go-to, a cream moisturizer from a competitor in the same category/price point, pills so much with SPF that I've defaulted using this even though I'm not out of the other. Clinique has a great, generational thing going with this one and thank goodness they have kept it consistent all these years. So worth the cost!!!",
126					"profileImage": "https://lh3.googleusercontent.com/shsm/AGYqVK1Sw8jhHKRAdbobkfAY1ut_miagcK8CJhSjEdTHpOAa4fu5hrIBeeOdsAEGymf0LLLfjA=w40-h40-c0x00000000-cc"
127				},
128				...
129			],
130			"discussions": [
131				{
132					"title": "Has anyone tried the ALDI dupe of the Clinique moisture surge moisturiser? : r/SkincareAddictionUK",
133					"url": "https://www.reddit.com/r/SkincareAddictionUK/comments/d29gji/has_anyone_tried_the_aldi_dupe_of_the_clinique/",
134					"source": "Reddit",
135					"source_url": "www.reddit.com",
136					"favicon": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.reddit.com&client=SHOPPING&size=16&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
137					"channel": "r/SkincareAddictionUK",
138					"channel_url": "https://www.reddit.com/r/SkincareAddictionUK/",
139					"related_links": [
140						{
141							"title": "Its amazing hydrates really well and sinks in so quick.",
142							"url": "https://www.reddit.com/r/SkincareAddictionUK/comments/d29gji/has_anyone_tried_the_aldi_dupe_of_the_clinique/#:~:text=Its amazing hydrates really well and sinks in so quick."
143						},
144						{
145							"title": "Best Face Moisturizer for Sensitive Skin Dermatologist-Recommended",
146							"url": "https://www.reddit.com/r/SkincareAddictionUK/comments/d29gji/has_anyone_tried_the_aldi_dupe_of_the_clinique/#:~:text=Best Face Moisturizer for Sensitive Skin Dermatologist%2DRecommended"
147						},
148						{
149							"title": "Best Non-Comedogenic Moisturizer",
150							"url": "https://www.reddit.com/r/SkincareAddictionUK/comments/d29gji/has_anyone_tried_the_aldi_dupe_of_the_clinique/#null"
151						}
152					],
153					"posted_time": "5 years ago"
154				},
155				{
156					"title": "Alternative to Clinique Moisture Surge? — MoneySavingExpert Forum",
157					"url": "https://forums.moneysavingexpert.com/discussion/5559376/alternative-to-clinique-moisture-surge",
158					"source": "Money Saving Expert",
159					"source_url": "forums.moneysavingexpert.com",
160					"favicon": "https://encrypted-tbn1.gstatic.com/faviconV2?url=https://forums.moneysavingexpert.com&client=SHOPPING&size=16&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
161					"channel": "Health & beauty MoneySaving",
162					"channel_url": "https://forums.moneysavingexpert.com/categories/health-beauty-moneysaving",
163					"related_links": [
164						{
165							"title": "I like the gel consistency, and it absorbs really quickly, doesn't leave your face feeling oily or tacky.",
166							"url": "https://forums.moneysavingexpert.com/discussion/5559376/alternative-to-clinique-moisture-surge#:~:text=I like the gel consistency%2C and it,leave your face feeling oily or tacky."
167						},
168						{
169							"title": "I adore Cliniques Moisture Surge but do not like the price tag at all.",
170							"url": "https://forums.moneysavingexpert.com/discussion/5559376/alternative-to-clinique-moisture-surge#:~:text=I adore Cliniques Moisture Surge but do not like the price tag at all."
171						},
172						{
173							"title": "It doesn't leave your skin oily and it is easy to apply.",
174							"url": "https://forums.moneysavingexpert.com/discussion/5559376/alternative-to-clinique-moisture-surge#:~:text=It doesn't leave your skin oily and it is easy to apply."
175						}
176					],
177					"posted_time": "8 years ago"
178				},
179				...
180			],
181			"images": [
182				"https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcRwVSGMTO-A3BijrJhqOTPtIJSH-vh_Z6Q1lmefuTLPEdkND5fI1w0z7bsUYQ5VCqNyNn_eaUikavHuZTGINZggeK5fNtZCFwpCgo5VJOqyTr_0lGwHA_bEaNQ",
183				"https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcQCXqsqMFhOFFGI85pq9BOLH74puWbfDMSp60ndx4yRv_DHr3F3S8O_NqGD7uQyNjs0BZd6oqlmtIjGD_GqKIJ88lkSsr-MszuD4Mc0alzIELwfb9ufdMFXhA"
184			],
185			"videos": [
186				{
187					"title": "Clinique Moisture Surge 100H Hydrator Review",
188					"duration": "0:40",
189					"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSXGu9T_WA90PUoIpfU6JC_tI_VIyGR6l5gt2xaWr1DtWA2-g&s",
190					"platform": "TikTok",
191					"author": "menaadubea",
192					"url": "https://www.tiktok.com/@menaadubea/video/7366285210347982123"
193				},
194				{
195					"title": "Clinique Moisture Surge 100h Auto-replenishing Hydrator Review ...",
196					"duration": "10:00",
197					"thumbnail": "https://i.ytimg.com/vi/Oo9fmQR8q_Y/mqdefault.jpg?sqp=-oaymwEGCMACELQB&rs=AMzJL3mG-7fJObVlJkHSAwP5Jo0QfxAHgg",
198					"platform": "YouTube",
199					"author": "Ashwini Megur",
200					"url": "https://m.youtube.com/watch?v=Oo9fmQR8q_Y"
201				},
202				...
203			],
204			"also_search": [
205				{
206					"searchUrl": "https://www.google.com/search?udm=28&q=clinique+facial+moisturizers&cs=1",
207					"searchTerms": "clinique facial moisturizers"
208				},
209				{
210					"searchUrl": "https://www.google.com/search?udm=28&q=clinique+travel+toiletries+on+sale&cs=1",
211					"searchTerms": "clinique travel toiletries on sale"
212				},
213				...
214			],
215			"imageDocid": null,
216			"productid": "11517421853804152154",
217		}
218	}
219}

Limitations

🛑 Color-coded pagination runs on a different (legacy) Google engine. You cannot use filters in the search terms.

For filters, use the "Custom Input" instead. mr:1 is required at the beginning, and all values are separated by a comma (,). For example:

"mr:1,price:1,ppr_min:800,ppr_max:2500,avg_rating:400,free_return:1"

• mr:1,price:1,ppr_min:5,ppr_max:25

  "mr:1" and "price:1" enable the price filter, ",ppr_min:xxx" sets the minimum price, and "ppr_max:xxx" sets the maximum.

• avg_rating:400

  Sets the minimum rating. Allowed values: 400 or 300 or 200 or 100.

• free_return:1

  Only free returns.

• ship:1

  Only free deliveries.

• shipspeed:3

  Only deliveries within 1-3 days.

• new:1

  Only new products. Allowed values: 1 or 3 (used).

• sales:1

  Only products on sale.

• p_ord:rv,vw:d

  Sorted by reviews. Allowed values: rv,vw:d or p,vw:d (price asc.) or pd,vw:d (price desc.).

Leave empty or remove values to deactivate filters. The actor does not validate the custom input.

Results (here, the UK) are also formatted differently, with less data available:

1{
2	"query": "switch",
3	"data": [
4		{
5			"title": "Mercusys MS108G 8 Port Gigabit Desktop Switch",
6			"url": "https://www.google.com/shopping/product/10329032662162019675?q=switch&sca_esv=abadf5658788ee4f&hl=en&biw=2058&bih=748&dpr=1.65&ucbcb=1&prds=epd:3130127464500391076,oid:3130127464500391076,pid:11372205559478914687&liteui=1&sa=X&ved=0ahUKEwjNgbKsnvGKAxVaK_sDHZrPJLMQ2SsIeg",
7			"image": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcShV4DksN8UP8dClS1WSh2-6DbmSH1ZAuOEYF5-ntUnms5Zh-sdPMYZW-Riy-QC2gp2sCwwStrR025RCCaV5vh9GjwV669DuqVii28ilYWv_5tWXiEwzQ&usqp=CAE",
8			"price": 12.99,
9			"seller": "Screwfix.com",
10			"seller_offer_url": "https://www.screwfix.com/p/tp-link-mercusys-ms108g-8-port-desktop-network-switch-black/507RN%3Fsrsltid%3DAfmBOooXWo7al46jHXEo4tf77Y9shcX7cE4jModThSgHPsxIctwJAFKU0Bc&rct=j&q=&esrc=s&opi=95576897&sa=U&ved=0ahUKEwjNgbKsnvGKAxVaK_sDHZrPJLMQsDwIeQ&usg=AOvVaw1VDni11Oa_-ROnBsJNKaqP",
11			"more_sellers": true,
12			"free_delivery": false,
13			"delivery_conditions": "+£5.00 delivery",
14			"rating": 5,
15			"reviews_count": 1680,
16			"details": {
17				"title": "Mercusys MS108G 8 Port Gigabit Desktop Switch",
18				"productName": "Mercusys MS108G 8 Port Gigabit Desktop Switch",
19				"url": "/url",
20				"description": "Expand Ethernet Network with Gigabit Ports Quickly expand your wired network with eight 10/100/1000Mbps Ethernet ports 10 times faster than regular 10/100 Mbps Ethernet ports. MS108G is flexible and fully compatible with 4K Ultra HD TVs, computers, printers, IP cameras, games ...",
21				"variants": [
22					"8-Port",
23					"8-Port / 8-Port 10"
24				],
25				"offers": [
26					{
27						"productName": "Mercusys MS108G 8 Port Gigabit Desktop Switch",
28						"url": "https://www.screwfix.com/p/tp-link-mercusys-ms108g-8-port-desktop-network-switch-black/507RN",
29						"price": 12.99,
30						"discounted": true,
31						"original_price": 14.98,
32						"discount_percent": 13,
33						"seller": "Screwfix.com",
34						"has_free_shipping": false
35					},
36					{
37						"productName": "Mercusys MS108G 8 Port Gigabit Desktop Switch",
38						"url": "https://www.google.com/shopping/product/10329032662162019675?q=switch&sca_esv=abadf5658788ee4f&hl=en&biw=2058&bih=748&dpr=1.65&ucbcb=1&prds=epd:3130127464500391076,oid:3130127464500391076,pid:11372205559478914687&liteui=1&sa=X&ved=0ahUKEwjNgbKsnvGKAxVaK_sDHZrPJLMQ2SsIeg",
39						"price": 12.99,
40						"discounted": null,
41						"original_price": null,
42						"discount_percent": null,
43						"seller": "Screwfix.com",
44						"has_free_shipping": false,
45						"entry93": null
46					},
47					{
48						"productName": "Mercusys MS108G 8 Port Gigabit Desktop Switch",
49						"url": "https://www.amazon.co.uk/MERCUSYS-MS108G-8-Port-1000Mbps-Desktop/dp/B086TNK58S",
50						"price": 13.49,
51						"discounted": true,
52						"original_price": 14.99,
53						"discount_percent": 10,
54						"seller": "Amazon.co.uk",
55						"has_free_shipping": false
56					}
57				],
58				"rating": 4.89,
59				"reviews_count": 1680,
60				"reviews": [
61					"performs well",
62					"well made",
63					"easy to set up",
64					"compact",
65					"fast",
66					"easy to use"
67				],
68				"images": [
69					"https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcRVUJyPwdZLtIF1yf-qJ3Rdc92vufRdiddJW-BiZiBzbBkTlZcdi8OenBjo8KAAXVO6MXW4x0vWZM8n76VdaWtlKMWgT0rxPt3_XL-O5LaS6aDObduJpFV0&usqp=CAY",
70					"https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSr-a_QDd86G6i9_0IK49HuO4joYBg6kGq1Yen1F6q7HGli5mu-bCKXnpQZVF2GyV9G_Gtp_x-1imtNNB8l7rrLPI83sz2D0lIiuB0eTw2V-hNQJz_obGD2QDzN&usqp=CAY",
71					"https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcS1kmHYPw7JjYCEO7vikUM8uCIG9FEPbChNvDXMUkapyLY239MjyjQr2cPlTLrALV_SOyzDHrpA1lTRU3zc1nAAjH3UQxeMexfAJQGuO7ezptY1czD-PXKxyg&usqp=CAY",
72					"https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcRZh66XSbOcXkWiMScep0-ETEuTMqS8ESo8jUEZJVqXBonD7QFs-Vw9aChu1RipdY1Of3PuAQZSShslTOrFjUaIsNR-DEQOtZluJYAJPipITdcNShL1dg7CkA&usqp=CAY",
73					"https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcSKtVbUoJB3YAsoZjUterFstbaUSRMCz0_4RGgs8pZiJBe_FVY3KqkI6oIC82xTuS7clLCnH3r0gUPNhu9c_WR4IFWJK1agVxE0Y52h4cY2&usqp=CAY",
74					"https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSK4k7LwCKSjmncqdLZS5hdpUgeXInMw10xh3OOuWKp0XJ6LF28mNbiqIeXG_kBlJRzNfQHYx5nQRpVHk2_HL1hsL7fzRklVI438P5-rJUHjGz-yIqEWjcExM9Z&usqp=CAY",
75					"https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcQgkB1KxSxDapkuM2ifgSTABzdmzjvG1E6EsrXSE_be_QBahCWGDOqMf8w6PeED1eEPd9dJpX4esY_-GZh7IDcwOBonlmTzrA&usqp=CAY"
76				]
77			}
78		}
79	]
80}

Support

You MUST use a strong proxy and set a reasonable waiting time between requests!

Open a new issue for bugs or feature requests. Please share the run URL.

Cheers!