{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Shopping Scraper & Price Tracker: Sellers, Price History",
    "description": "Scrape Google Shopping in 7 countries past page one, with Google's price range, price sort, on-sale and free-shipping filters. Add up to 5 sellers per product, the typical price range and each seller's daily price history. Track product IDs on a schedule and save only price and seller changes.",
    "version": "0.2",
    "x-build-id": "cuqJgFZ8f7RWsTzTv"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/getascraper~google-shopping-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-getascraper-google-shopping-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/getascraper~google-shopping-scraper/runs": {
      "post": {
        "operationId": "runs-sync-getascraper-google-shopping-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/getascraper~google-shopping-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-getascraper-google-shopping-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "queries": {
            "title": "Search queries",
            "type": "array",
            "description": "What to search for on Google Shopping, one query per line, for example \"wireless headphones\" or \"standing desk\". Each query is searched on its own and gets its own products.",
            "default": [
              "wireless headphones"
            ],
            "items": {
              "type": "string"
            }
          },
          "productIds": {
            "title": "Product IDs to check",
            "type": "array",
            "description": "Google product IDs (the productId field in this Actor's output) or productUrl values. Each product is checked on its own product page: every seller offer shown, the typical price range and price history. Use this to track the same products on a schedule.",
            "items": {
              "type": "string"
            }
          },
          "countryCode": {
            "title": "Country",
            "enum": [
              "US",
              "GB",
              "DE",
              "FR",
              "CA",
              "AU",
              "IN"
            ],
            "type": "string",
            "description": "The Google Shopping country to search. Prices, sellers and delivery are the ones shoppers in that country see.",
            "default": "US"
          },
          "languageCode": {
            "title": "Language",
            "type": "string",
            "description": "The language of Google's interface and product text, as a two-letter code such as en, de or fr. Use the country's own language for the most complete results.",
            "default": "en"
          },
          "location": {
            "title": "City or region",
            "type": "string",
            "description": "Optional city or region for local results, written the way Google knows it, for example \"Chicago,Illinois,United States\". Local results add nearby store availability where Google shows it."
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "number",
            "description": "Only products priced at or above this amount, in the country's currency. Google applies the filter to its results, and every saved product is checked again."
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "number",
            "description": "Only products priced at or below this amount, in the country's currency."
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "price_low_to_high",
              "price_high_to_low"
            ],
            "type": "string",
            "description": "The order of the results. Price sorts are Google's own, so the cheapest (or most expensive) products come first across all pages.",
            "default": "relevance"
          },
          "onSaleOnly": {
            "title": "On sale only",
            "type": "boolean",
            "description": "Only products Google shows as discounted, with a previous price or a percent-off badge.",
            "default": false
          },
          "freeShippingOnly": {
            "title": "Free shipping only",
            "type": "boolean",
            "description": "Only products with free delivery. Products that state a delivery fee are dropped.",
            "default": false
          },
          "minRating": {
            "title": "Minimum product rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Only products rated at least this many stars (1 to 5). Products without a rating are left out when this is set."
          },
          "merchants": {
            "title": "Sellers",
            "type": "array",
            "description": "Only products sold by these sellers, for example \"Best Buy\" or \"Walmart\". A product is kept when its seller name contains one of these words, ignoring case.",
            "items": {
              "type": "string"
            }
          },
          "includeOffers": {
            "title": "Include seller offers and price history",
            "type": "boolean",
            "description": "Also open each product's page and save the seller offers shown there (price, condition, delivery, returns, seller rating, link), Google's typical price range and each seller's price history. Takes longer and is billed as an add-on per product that has offers.",
            "default": false
          },
          "maxProductsWithOffers": {
            "title": "Products with offers per run",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "How many products, counted across all queries, get their seller offers and price history. The first products of each query are used. Product ID runs always include offers.",
            "default": 10
          },
          "priceHistoryDays": {
            "title": "Price history length",
            "minimum": 1,
            "maximum": 366,
            "type": "integer",
            "description": "How many days of each seller's price history to save. Google keeps about one year.",
            "default": 90
          },
          "maxProductsPerQuery": {
            "title": "Products per query",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "The most products to save for each query. Google's results for one search end after about 200 products; above that, this Actor splits the query into price ranges to reach more.",
            "default": 20
          },
          "onlyNewOrChanged": {
            "title": "Only new products and price changes",
            "type": "boolean",
            "description": "For scheduled runs: save only products that are new since the last run or whose price changed, with the previous price and the change. With product IDs, saves only products whose lowest price or sellers changed. The first run saves everything and remembers it.",
            "default": false
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "A name for this tracker, so separate schedules keep separate memories, for example \"headphones-us\". Letters, digits and dashes. Leave empty to use the default monitor."
          },
          "notificationWebhookUrl": {
            "title": "Webhook URL for changes",
            "type": "string",
            "description": "Optional public HTTPS address that receives a JSON summary of the changes after each monitoring run that found any, for example a Zapier, Make or Slack workflow webhook."
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "The Actor always uses Apify's proxy for Google search results, which this Actor needs to read Google Shopping reliably. Other proxy settings are replaced.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}