Vexaloom LabsUse Google Shopping Price Comparison & Deal Finder with Python
Search Google Shopping by keyword and collect product prices, discounts, merchant names, ratings, and delivery info across 48 countries for price monitoring and deal tracking.
1. Choose the data you need
Review the published README for supported collection modes, examples, and limits. The recipe below uses the current published input definition.
2. Prepare a source-based input
This JSON contains published prefills and required-field defaults. Review every value for your task before running it; it is not a promise of successful collection.
{
"countryCode": "us",
"freeShipping": false,
"includePriceHistory": false,
"includeProductDetails": false,
"languageCode": "en",
"maxResultsPerQuery": 1,
"mode": "search",
"onSale": false,
"queries": [
"iPhone 15 Pro Max"
]
}
Download input.example.json and save your reviewed copy as input.json.
| Field | Type | Required | Description |
|---|---|---|---|
mode | string | optional | What to collect: keyword search, product lookup by ID/viewer URL, deals, or a department category. |
queries | array | optional | Product keywords for search/deals mode. Ignored in product mode; optional in category mode. |
productIds | array | optional | Google Shopping catalog IDs, product IDs, product viewer URLs, or legacy /shopping/product/<id> URLs. Used in product mode. |
category | string | optional | Google Shopping department for category mode. |
countryCode | string | optional | Country used for the Google domain, UULE location and price hint. The actual currency is always detected from the response, never relabelled. |
languageCode | string | optional | Interface and result language (hl parameter). |
sortBy | string | optional | Client-side sort of the collected rows. Google ignores server-side sort on this page. |
condition | string | optional | Condition hint sent to Google and verified when the result card shows a condition. |
minPrice | integer | optional | Minimum price in the detected local currency. Applied through a shoprs filter and verified on every output row. |
maxPrice | integer | optional | Maximum price in the detected local currency. Applied through a shoprs filter and verified on every output row. |
onSale | boolean | optional | Ask Google for discounted products and keep rows with an observed original price or discount. |
freeShipping | boolean | optional | Ask Google for free-shipping products and keep rows whose delivery text says free. |
minRating | string | optional | Minimum product rating (0-5). Applied through a shoprs rating chip and verified on every output row. |
store | string | optional | Optional store name to bias and verify, e.g. Best Buy or Amazon. |
maxResultsPerQuery | integer | optional | Maximum records per query (search/deals/category) or products (product mode). |
includePriceHistory | boolean | optional | Include per-seller daily price history when Google exposes it (product mode and search detail enrichment). |
includeProductDetails | boolean | optional | Fetch the product viewer for each search result to add brand, description, images, specifications and offers. Costs one extra request per result. |
3. Start an Actor run
Set APIFY_TOKEN in your environment. Python 3.10 or newer is sufficient; this recipe uses no third-party packages.
Execution may incur charges. Review current pricing on Apify. The request asks for a 120-second timeout and a charge limit; these settings are subject to Apify’s pricing and do not guarantee an all-inclusive spending cap.
import json
import os
import urllib.request
# Save the schema-derived example as input.json; review and edit it first.
with open("input.json", encoding="utf-8") as stream:
actor_input = json.load(stream)
token = os.environ["APIFY_TOKEN"]
request = urllib.request.Request(
"https://api.apify.com/v2/acts/MMwNfJSA1eG2IqVrJ/runs?timeout=120&maxTotalChargeUsd=0.50",
data=json.dumps(actor_input).encode("utf-8"),
headers={"Authorization": "Bearer " + token, "Content-Type": "application/json"},
method="POST",
)
# This starts a potentially billable run. Do not automatically retry this POST.
with urllib.request.urlopen(request, timeout=40) as response:
run = json.load(response)["data"]
print("Run ID:", run["id"])
print("Status:", run["status"])
# Inspect and download results in Apify Console once the run succeeds.
4. Inspect the actual results
Open the run in Apify Console and wait for a successful completion. Use the published output schema to locate results and the dataset schema to understand declared views. Missing or optional record fields must not be treated as guaranteed values.
Product listings and product-viewer records with real product IDs, viewer URLs, seller offers, shipping and totals, price ranges, specifications and 12-month price history where Google exposes it.
Questions before you run
Which inputs are required?
No top-level fields are marked required in the published schema. Conditional requirements can still apply; check the README.
What does this guide verify?
The fields, prefills, and schema links are rendered from the published build. This is a usage recipe, not a paid live extraction test. Source availability and collection results can vary.
What if the run request times out?
Check Apify Console before retrying. The first request may already have created a run. Do not automatically repeat a run-creation POST.
Generated from source build p859CrahOaABt6Kkq and its README and schemas. Source changes regenerate this guide; no third-party editorial claims are inferred.