View raw JSON
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"title": "Google Shopping Scraper - Search & Extract Products",
"required": [
"searchQuery"
],
"properties": {
"page": {
"type": "integer",
"title": "📄 Starting Page",
"editor": "number",
"default": 1,
"maximum": 100,
"minimum": 1,
"description": "Optional integer from 1 to 100; default 1. Selects the page from which results start, not a maximum number of pages. The example uses the first page."
},
"limit": {
"type": "integer",
"title": "📦 Results Per Page",
"editor": "number",
"default": 10,
"maximum": 100,
"minimum": 10,
"description": "Optional integer from 10 to 100; default 10. Requests this many products per call or page. Actual results can be fewer, and the quantity is not a count of every seller’s offer."
},
"onSale": {
"type": "boolean",
"title": "🏷️ On Sale Only",
"editor": "checkbox",
"nullable": true,
"description": "Optional boolean or null. True requests listings the source labels as on sale or discounted. The label does not verify the discount or a special sale event, and checkout terms can differ."
},
"sortBy": {
"enum": [
"BEST_MATCH",
"LOWEST_PRICE",
"HIGHEST_PRICE",
"TOP_RATED"
],
"type": "string",
"title": "📊 Sort Results By",
"editor": "select",
"nullable": true,
"enumTitles": [
"🎯 Best Match (Most Relevant)",
"💰 Lowest Price First",
"💎 Highest Price First",
"⭐ Top Rated First"
],
"description": "Optional choice or null: BEST_MATCH for relevance, LOWEST_PRICE for lower displayed prices first, HIGHEST_PRICE for higher displayed prices first, or TOP_RATED for rating. Price sorting does not establish the lowest checkout total; rating sorting does not verify product quality.",
"sectionCaption": "🔧 Filter & Sort Options",
"sectionDescription": "Customize how products are sorted and filtered to get the most relevant results for your needs."
},
"stores": {
"type": "string",
"title": "🏪 Store Names",
"editor": "textfield",
"nullable": true,
"description": "Optional string or null. Enter store names separated by commas, such as Amazon,Walmart,Best Buy, to request a store filter. These are names rather than store URLs; the filter does not verify merchant identity or provide all its offers.",
"sectionCaption": "🛍️ Advanced Filters",
"sectionDescription": "Apply additional filters to narrow down your search results by store, shipping, returns, and deals."
},
"country": {
"type": "string",
"title": "🌍 Country",
"editor": "textfield",
"default": "us",
"description": "Optional country code; default us. Use an ISO 3166-1 alpha-2 code such as us, gb or de for the search market. It is not a seller-origin or delivery-address setting and does not establish shipping eligibility."
},
"language": {
"type": "string",
"title": "🗣️ Language",
"editor": "textfield",
"default": "en",
"description": "Optional language code; default en. Use an ISO 639-1 code such as en, es or fr. It requests the search or result language and does not guarantee translation of every listing or seller term."
},
"maxPrice": {
"type": "number",
"title": "💲 Maximum Price",
"editor": "number",
"nullable": true,
"description": "Optional number or null requesting a price ceiling for source-displayed prices. Omit it to leave the maximum unset. Preserve the returned currency and shipping context; this is not a final checkout-total filter."
},
"minPrice": {
"type": "number",
"title": "💲 Minimum Price",
"editor": "number",
"nullable": true,
"description": "Optional number or null requesting a price floor for source-displayed prices. Omit it to leave the minimum unset. Preserve the returned currency and shipping context; amounts are not automatically converted."
},
"freeReturns": {
"type": "boolean",
"title": "🔄 Free Returns Only",
"editor": "checkbox",
"nullable": true,
"description": "Optional boolean or null. True requests offers the source labels as providing free returns. This does not establish eligibility for every customer, location or return reason."
},
"searchQuery": {
"type": "string",
"title": "🔍 Search Query",
"editor": "textfield",
"default": "iPhone 17",
"prefill": "iPhone 17",
"maxLength": 400,
"minLength": 1,
"description": "Required single string of 1–400 characters; default iPhone 17. Enter a product name, brand or keywords. Keyword matches can include different products or variants; they are not an exact-SKU guarantee.",
"sectionCaption": "🎯 Search Settings",
"sectionDescription": "Configure your search parameters to find relevant products on Google Shopping. Enter your search query and customize the results."
},
"freeShipping": {
"type": "boolean",
"title": "🚚 Free Shipping Only",
"editor": "checkbox",
"nullable": true,
"description": "Optional boolean or null. True requests offers the source labels as providing free shipping. Confirm any destination, order or checkout conditions with the seller; the flag does not verify delivery eligibility."
},
"productCondition": {
"enum": [
"ANY",
"NEW",
"USED",
"REFURBISHED"
],
"type": "string",
"title": "📋 Product Condition",
"editor": "select",
"nullable": true,
"enumTitles": [
"🔄 Any Condition",
"✨ New Only",
"♻️ Used Only",
"🔧 Refurbished Only"
],
"description": "Optional choice or null: ANY, NEW, USED or REFURBISHED. Requests the source’s reported condition. The example uses NEW, which is a source classification rather than physical inspection or certification."
}
},
"description": "Required request object containing the product search phrase and optional market, starting page, quantity, sorting and offer filters. It retrieves available product and seller-offer information for research.",
"schemaVersion": 1
}
},
"additionalProperties": false
}
