Google Shopping Price Comparison & Deal Finder

{
  "description": "Search Google Shopping, look up products by ID, or browse deals and categories. Returns real product IDs, viewer URLs, seller offers with shipping and totals, price ranges and 12-month price history where Google exposes it.",
  "properties": {
    "category": {
      "description": "Google Shopping department for category mode.",
      "editor": "select",
      "enum": [
        "electronics",
        "computers",
        "cell-phones",
        "audio",
        "cameras",
        "video-games",
        "tv-home-theater",
        "appliances",
        "home-garden",
        "clothing",
        "shoes",
        "beauty",
        "sports-outdoors",
        "toys-games",
        "jewelry"
      ],
      "enumTitles": [
        "Electronics",
        "Computers",
        "Cell Phones",
        "Audio",
        "Cameras",
        "Video Games",
        "TV & Home Theater",
        "Appliances",
        "Home & Garden",
        "Clothing",
        "Shoes",
        "Beauty",
        "Sports & Outdoors",
        "Toys & Games",
        "Jewelry"
      ],
      "title": "Category",
      "type": "string"
    },
    "condition": {
      "default": "",
      "description": "Condition hint sent to Google and verified when the result card shows a condition.",
      "editor": "select",
      "enum": [
        "",
        "new",
        "used",
        "refurbished"
      ],
      "enumTitles": [
        "Any",
        "New",
        "Used",
        "Refurbished"
      ],
      "title": "Condition",
      "type": "string"
    },
    "countryCode": {
      "default": "us",
      "description": "Country used for the Google domain, UULE location and price hint. The actual currency is always detected from the response, never relabelled.",
      "editor": "select",
      "enum": [
        "us",
        "uk",
        "ca",
        "au",
        "de",
        "fr",
        "es",
        "it",
        "br",
        "mx",
        "in",
        "jp",
        "kr",
        "nl",
        "be",
        "at",
        "ch",
        "se",
        "no",
        "dk",
        "fi",
        "pl",
        "cz",
        "pt",
        "ie",
        "nz",
        "za",
        "sg",
        "hk",
        "tw",
        "ph",
        "th",
        "id",
        "my",
        "vn",
        "ar",
        "cl",
        "co",
        "pe",
        "tr",
        "ru",
        "ua",
        "il",
        "ae",
        "sa",
        "eg",
        "ng",
        "ke"
      ],
      "enumTitles": [
        "United States",
        "United Kingdom",
        "Canada",
        "Australia",
        "Germany",
        "France",
        "Spain",
        "Italy",
        "Brazil",
        "Mexico",
        "India",
        "Japan",
        "South Korea",
        "Netherlands",
        "Belgium",
        "Austria",
        "Switzerland",
        "Sweden",
        "Norway",
        "Denmark",
        "Finland",
        "Poland",
        "Czech Republic",
        "Portugal",
        "Ireland",
        "New Zealand",
        "South Africa",
        "Singapore",
        "Hong Kong",
        "Taiwan",
        "Philippines",
        "Thailand",
        "Indonesia",
        "Malaysia",
        "Vietnam",
        "Argentina",
        "Chile",
        "Colombia",
        "Peru",
        "Turkey",
        "Russia",
        "Ukraine",
        "Israel",
        "UAE",
        "Saudi Arabia",
        "Egypt",
        "Nigeria",
        "Kenya"
      ],
      "prefill": "us",
      "title": "Country",
      "type": "string"
    },
    "freeShipping": {
      "default": false,
      "description": "Ask Google for free-shipping products and keep rows whose delivery text says free.",
      "prefill": false,
      "title": "Free Shipping Only",
      "type": "boolean"
    },
    "includePriceHistory": {
      "default": true,
      "description": "Include per-seller daily price history when Google exposes it (product mode and search detail enrichment).",
      "prefill": false,
      "title": "Include 12-Month Price History",
      "type": "boolean"
    },
    "includeProductDetails": {
      "default": false,
      "description": "Fetch the product viewer for each search result to add brand, description, images, specifications and offers. Costs one extra request per result.",
      "prefill": false,
      "title": "Enrich Search Results",
      "type": "boolean"
    },
    "languageCode": {
      "default": "en",
      "description": "Interface and result language (hl parameter).",
      "editor": "select",
      "enum": [
        "en",
        "es",
        "fr",
        "de",
        "it",
        "pt",
        "nl",
        "pl",
        "tr",
        "ru",
        "ja",
        "ko",
        "zh",
        "ar",
        "hi",
        "th",
        "vi",
        "id",
        "ms",
        "sv",
        "da",
        "no",
        "fi",
        "cs",
        "el",
        "he",
        "uk"
      ],
      "enumTitles": [
        "English",
        "Spanish",
        "French",
        "German",
        "Italian",
        "Portuguese",
        "Dutch",
        "Polish",
        "Turkish",
        "Russian",
        "Japanese",
        "Korean",
        "Chinese",
        "Arabic",
        "Hindi",
        "Thai",
        "Vietnamese",
        "Indonesian",
        "Malay",
        "Swedish",
        "Danish",
        "Norwegian",
        "Finnish",
        "Czech",
        "Greek",
        "Hebrew",
        "Ukrainian"
      ],
      "prefill": "en",
      "title": "Language",
      "type": "string"
    },
    "maxPrice": {
      "description": "Maximum price in the detected local currency. Applied through a shoprs filter and verified on every output row.",
      "minimum": 0,
      "title": "Maximum Price",
      "type": "integer"
    },
    "maxResultsPerQuery": {
      "default": 20,
      "description": "Maximum records per query (search/deals/category) or products (product mode).",
      "maximum": 200,
      "minimum": 1,
      "prefill": 1,
      "title": "Max Results",
      "type": "integer"
    },
    "minPrice": {
      "description": "Minimum price in the detected local currency. Applied through a shoprs filter and verified on every output row.",
      "minimum": 0,
      "title": "Minimum Price",
      "type": "integer"
    },
    "minRating": {
      "default": "0",
      "description": "Minimum product rating (0-5). Applied through a shoprs rating chip and verified on every output row.",
      "editor": "select",
      "enum": [
        "0",
        "1",
        "2",
        "3",
        "4",
        "5"
      ],
      "enumTitles": [
        "Any",
        "1 and up",
        "2 and up",
        "3 and up",
        "4 and up",
        "5"
      ],
      "title": "Minimum Rating",
      "type": "string"
    },
    "mode": {
      "default": "search",
      "description": "What to collect: keyword search, product lookup by ID/viewer URL, deals, or a department category.",
      "editor": "select",
      "enum": [
        "search",
        "product",
        "deals",
        "category"
      ],
      "enumTitles": [
        "Keyword search",
        "Product lookup (ID or URL)",
        "Deals",
        "Category browse"
      ],
      "prefill": "search",
      "title": "Mode",
      "type": "string"
    },
    "onSale": {
      "default": false,
      "description": "Ask Google for discounted products and keep rows with an observed original price or discount.",
      "prefill": false,
      "title": "On Sale Only",
      "type": "boolean"
    },
    "productIds": {
      "description": "Google Shopping catalog IDs, product IDs, product viewer URLs, or legacy /shopping/product/<id> URLs. Used in product mode.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Product IDs or Viewer URLs",
      "type": "array"
    },
    "queries": {
      "description": "Product keywords for search/deals mode. Ignored in product mode; optional in category mode.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [
        "iPhone 15 Pro Max"
      ],
      "title": "Search Queries",
      "type": "array"
    },
    "sortBy": {
      "default": "",
      "description": "Client-side sort of the collected rows. Google ignores server-side sort on this page.",
      "editor": "select",
      "enum": [
        "",
        "review_score",
        "price_low",
        "price_high"
      ],
      "enumTitles": [
        "Relevance (default)",
        "Rating high to low",
        "Price low to high",
        "Price high to low"
      ],
      "title": "Sort By",
      "type": "string"
    },
    "store": {
      "description": "Optional store name to bias and verify, e.g. Best Buy or Amazon.",
      "editor": "textfield",
      "title": "Store",
      "type": "string"
    }
  },
  "schemaVersion": 1,
  "title": "Google Shopping Price Comparison & Deal Finder",
  "type": "object"
}

{
  "actorOutputSchemaVersion": 1,
  "description": "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.",
  "properties": {
    "products": {
      "description": "Dataset containing search results, deals, category results and product records.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Shopping Products",
      "type": "string"
    }
  },
  "title": "Google Shopping Price Comparison & Deal Finder Output",
  "type": "object"
}

{
  "actorSpecification": 1,
  "fields": {
    "properties": {
      "availability": {
        "description": "Availability text.",
        "type": "string"
      },
      "badge": {
        "description": "Observed badge such as Best price or Low price.",
        "type": "string"
      },
      "brand": {
        "description": "Brand from the product viewer.",
        "type": "string"
      },
      "catalogId": {
        "description": "Real Google Shopping catalog ID from data-cid; used to build viewer URLs.",
        "type": "string"
      },
      "condition": {
        "description": "Condition when Google shows one.",
        "type": "string"
      },
      "currency": {
        "description": "Actual detected currency code. Never relabelled from the requested country.",
        "type": "string"
      },
      "dealFlags": {
        "description": "Observed deal signals.",
        "properties": {
          "bestPrice": {
            "type": "boolean"
          },
          "onSale": {
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "delivery": {
        "description": "Delivery text.",
        "type": "string"
      },
      "description": {
        "description": "Product description from the viewer.",
        "type": "string"
      },
      "discountPercent": {
        "description": "Observed discount percentage.",
        "type": "number"
      },
      "discussions": {
        "description": "Forum/discussion links about the product (not product review text).",
        "items": {
          "properties": {
            "source": {
              "type": "string"
            },
            "title": {
              "type": "string"
            },
            "url": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": "array"
      },
      "hasMoreOffers": {
        "description": "True when Google reports more seller offers than the five on the viewer page.",
        "type": "boolean"
      },
      "highestPrice": {
        "description": "Highest price among the offers on the page.",
        "type": "number"
      },
      "imageUrl": {
        "description": "Primary product image URL.",
        "type": "string"
      },
      "imageUrls": {
        "description": "Product image URLs from the viewer.",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "isSponsored": {
        "description": "True only when an explicit sponsored label was observed. Not a reliable ad classifier.",
        "type": "boolean"
      },
      "lowestPrice": {
        "description": "Lowest price among the offers on the page.",
        "type": "number"
      },
      "merchant": {
        "description": "Seller or merchant name.",
        "type": "string"
      },
      "merchantUrl": {
        "description": "Direct seller URL when available; otherwise the Google /goto redirect. Never guessed.",
        "type": "string"
      },
      "offerCount": {
        "description": "Total offer count reported by Google; only the first five offers are available over HTTP.",
        "type": "integer"
      },
      "offers": {
        "description": "First five seller offers from the product viewer.",
        "items": {
          "properties": {
            "availability": {
              "type": "string"
            },
            "badge": {
              "type": "string"
            },
            "currency": {
              "type": "string"
            },
            "delivery": {
              "type": "string"
            },
            "discountPercent": {
              "type": "number"
            },
            "isBestPrice": {
              "type": "boolean"
            },
            "originalPrice": {
              "type": "string"
            },
            "originalPriceValue": {
              "type": "number"
            },
            "price": {
              "type": "string"
            },
            "priceValue": {
              "type": "number"
            },
            "returns": {
              "type": "string"
            },
            "seller": {
              "type": "string"
            },
            "sellerDomain": {
              "type": "string"
            },
            "sellerId": {
              "type": "string"
            },
            "sellerUrl": {
              "type": "string"
            },
            "shipping": {
              "type": "string"
            },
            "shippingValue": {
              "type": "number"
            },
            "storeRating": {
              "type": "number"
            },
            "storeReviewCount": {
              "type": "integer"
            },
            "title": {
              "type": "string"
            },
            "totalPrice": {
              "type": "number"
            },
            "totalPriceDisplay": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": "array"
      },
      "originalPrice": {
        "description": "Original or list price as displayed, when discounted.",
        "type": "string"
      },
      "originalPriceValue": {
        "description": "Numeric original price.",
        "type": "number"
      },
      "position": {
        "description": "1-based position in the collected result set.",
        "type": "integer"
      },
      "price": {
        "description": "Current price as displayed, including currency symbol or code.",
        "type": "string"
      },
      "priceHistory": {
        "description": "Per-seller daily price history for the last 12 months, when Google exposes it.",
        "items": {
          "properties": {
            "currency": {
              "type": "string"
            },
            "points": {
              "items": {
                "properties": {
                  "date": {
                    "type": "string"
                  },
                  "price": {
                    "type": "number"
                  }
                },
                "type": "object"
              },
              "type": "array"
            },
            "seller": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": "array"
      },
      "priceRange": {
        "description": "Low/high price range across page offers.",
        "properties": {
          "currency": {
            "type": "string"
          },
          "high": {
            "type": "number"
          },
          "low": {
            "type": "number"
          }
        },
        "type": "object"
      },
      "priceValue": {
        "description": "Numeric current price.",
        "type": "number"
      },
      "productId": {
        "description": "Real Google Shopping product ID from data-pid.",
        "type": "string"
      },
      "productUrl": {
        "description": "Real Google Shopping product viewer URL.",
        "type": "string"
      },
      "query": {
        "description": "Search query or category/deal query that produced the record.",
        "type": "string"
      },
      "rating": {
        "description": "Product rating as displayed on the search card.",
        "type": "string"
      },
      "ratingValue": {
        "description": "Numeric product rating.",
        "type": "number"
      },
      "recordType": {
        "description": "searchResult or product.",
        "type": "string"
      },
      "returns": {
        "description": "Returns policy text.",
        "type": "string"
      },
      "reviewCount": {
        "description": "Product review count as displayed on the search card.",
        "type": "string"
      },
      "reviewCountValue": {
        "description": "Numeric product review count.",
        "type": "integer"
      },
      "scrapedAt": {
        "description": "ISO 8601 collection timestamp.",
        "type": "string"
      },
      "searchUrl": {
        "description": "URL that produced the record.",
        "type": "string"
      },
      "sellerDomain": {
        "description": "Seller domain when Google exposes it.",
        "type": "string"
      },
      "shipping": {
        "description": "Shipping text (e.g. Free).",
        "type": "string"
      },
      "shippingValue": {
        "description": "Numeric shipping cost when known.",
        "type": "number"
      },
      "specifications": {
        "description": "Product specifications from the viewer.",
        "items": {
          "properties": {
            "name": {
              "type": "string"
            },
            "value": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": "array"
      },
      "title": {
        "description": "Product title.",
        "type": "string"
      },
      "typicalPriceRange": {
        "description": "Typical price range reported by Google, when shown.",
        "properties": {
          "currency": {
            "type": "string"
          },
          "display": {
            "type": "string"
          },
          "high": {
            "type": "number"
          },
          "low": {
            "type": "number"
          }
        },
        "type": "object"
      },
      "variants": {
        "description": "Product variants exposed by the viewer.",
        "items": {
          "properties": {
            "currency": {
              "type": "string"
            },
            "imageUrl": {
              "type": "string"
            },
            "price": {
              "type": "string"
            },
            "priceValue": {
              "type": "number"
            },
            "productUrl": {
              "type": "string"
            },
            "title": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": "array"
      }
    },
    "type": "object"
  },
  "title": "Google Shopping Products, Offers and Price History",
  "views": {
    "offers": {
      "display": {
        "component": "table",
        "properties": {
          "highestPrice": {
            "format": "number",
            "label": "Highest"
          },
          "lowestPrice": {
            "format": "number",
            "label": "Lowest"
          },
          "offerCount": {
            "format": "number",
            "label": "Offers"
          },
          "offers": {
            "format": "text",
            "label": "Page Offers"
          },
          "priceHistory": {
            "format": "text",
            "label": "History"
          },
          "productUrl": {
            "format": "link",
            "label": "Viewer"
          },
          "title": {
            "format": "text",
            "label": "Product"
          },
          "typicalPriceRange": {
            "format": "text",
            "label": "Typical"
          }
        }
      },
      "title": "Offers and Price History",
      "transformation": {
        "fields": [
          "title",
          "offerCount",
          "lowestPrice",
          "highestPrice",
          "typicalPriceRange",
          "offers",
          "priceHistory",
          "productUrl"
        ]
      }
    },
    "overview": {
      "display": {
        "component": "table",
        "properties": {
          "currency": {
            "format": "text",
            "label": "Currency"
          },
          "merchant": {
            "format": "text",
            "label": "Merchant"
          },
          "position": {
            "format": "number",
            "label": "#"
          },
          "price": {
            "format": "text",
            "label": "Price"
          },
          "query": {
            "format": "text",
            "label": "Query"
          },
          "rating": {
            "format": "text",
            "label": "Rating"
          },
          "recordType": {
            "format": "text",
            "label": "Type"
          },
          "reviewCount": {
            "format": "text",
            "label": "Reviews"
          },
          "title": {
            "format": "text",
            "label": "Product"
          }
        }
      },
      "title": "Products Overview",
      "transformation": {
        "fields": [
          "query",
          "position",
          "title",
          "price",
          "currency",
          "merchant",
          "rating",
          "reviewCount",
          "recordType"
        ]
      }
    }
  }
}