{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Shopping Scraper — Prices, Sellers & History",
    "description": "Google Shopping scraper and price tracker: search by keyword or product link for prices, stores, ratings, delivery and photos. Product pages add every store with a direct link, each store's price history and the typical price for price comparison. Alerts when prices drop.",
    "version": "0.1",
    "x-build-id": "tI5TqerVIZTarXRxu"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/anuarbakty~google-shopping-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-anuarbakty-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/anuarbakty~google-shopping-scraper/runs": {
      "post": {
        "operationId": "runs-sync-anuarbakty-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/anuarbakty~google-shopping-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-anuarbakty-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 earbuds\" or \"standing desk\". A Google Shopping search link works too: its own query, country and filters are used.",
            "items": {
              "type": "string"
            }
          },
          "productUrls": {
            "title": "Product links or catalog IDs",
            "type": "array",
            "description": "Google Shopping product links (the address of a product page, with prds=… in it) or catalog IDs. Each one gives a row with every store Google lists for the product, store links, photos, specifications, typical price and price history.",
            "items": {
              "type": "string"
            }
          },
          "maxProductsPerQuery": {
            "title": "Products per query",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "How many products to save for each search query. One results page holds about 40; up to 1,000 per query are read across pages and sort orders (see \"Deep search\").",
            "default": 40
          },
          "maxItems": {
            "title": "Maximum products in the run",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many paid rows in the whole run. 0 or empty means no limit."
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "Two-letter country code of the Google Shopping to search: us, gb, de, fr, ca, au, in, es, it, nl, br, mx, jp and any other. Prices come in that country's currency.",
            "default": "us"
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Language code of the results, for example en, de, fr, es. Empty: the main language of the country."
          },
          "location": {
            "title": "City, region or ZIP code",
            "type": "string",
            "description": "Search as if from this place, to get local delivery times and nearby stores. Use Google's canonical location name, for example \"Austin,Texas,United States\" or \"10001,New York,United States\"."
          },
          "sortOrder": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "price_low",
              "price_high",
              "rating"
            ],
            "type": "string",
            "description": "The order Google sorts the results in.",
            "default": "relevance"
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "number",
            "description": "Only products at this price or above, in the country's currency."
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "number",
            "description": "Only products at this price or below, in the country's currency."
          },
          "minRating": {
            "title": "Minimum rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Only products rated at least this many stars, from 1 to 5, for example 4 or 4.5."
          },
          "condition": {
            "title": "Condition",
            "enum": [
              "any",
              "new",
              "used"
            ],
            "type": "string",
            "description": "New only, used and refurbished only, or any: filters the search the way Google's chip does. Product pages still list every store Google shows, each with its own condition.",
            "default": "any"
          },
          "onSale": {
            "title": "On sale only",
            "type": "boolean",
            "description": "Only products with a discount or an old price.",
            "default": false
          },
          "freeShipping": {
            "title": "Free delivery only",
            "type": "boolean",
            "description": "Only products with free delivery.",
            "default": false
          },
          "stores": {
            "title": "Stores",
            "type": "array",
            "description": "Only products sold by these stores, for example Walmart, Best Buy, Target. Each store gets its own search, the way Google's store filter does it, and an equal share of \"Products per query\".",
            "items": {
              "type": "string"
            }
          },
          "productDetails": {
            "title": "Open each product page",
            "type": "boolean",
            "description": "For every product from the search, also read its Google product page: every store Google lists with price, delivery cost, stock and a direct link to the store's own page, each store's price history, typical price, photos, specifications, variants and review insights. Takes about 30 seconds per 10 products. Priced as \"product with details\" instead of \"product from search\".",
            "default": false
          },
          "deepSearch": {
            "title": "Deep search",
            "type": "boolean",
            "description": "When one search has fewer products than \"Products per query\", read the same search sorted by price and by rating too, to find more. Used only with the relevance order.",
            "default": true
          },
          "mobileResults": {
            "title": "Mobile results",
            "type": "boolean",
            "description": "Search as a phone does. Google shows a slightly different list on phones.",
            "default": false
          },
          "trackPriceChanges": {
            "title": "Compare prices with the last run",
            "type": "boolean",
            "description": "Remember every product's price between runs and mark each row as new, price_down, price_up or unchanged, with the previous price and the change in percent. Turn it on in a scheduled task.",
            "default": false
          },
          "onlyNewOrChanged": {
            "title": "Only new or changed products",
            "type": "boolean",
            "description": "Save only products that are new or whose price changed since the last run. Unchanged products are skipped and not charged.",
            "default": false
          },
          "monitorName": {
            "title": "Price memory name",
            "type": "string",
            "description": "Runs with the same name share one price memory. Use one name per schedule.",
            "default": "default"
          },
          "minPriceChangePercent": {
            "title": "Smallest price change, %",
            "minimum": 0,
            "type": "number",
            "description": "Price changes smaller than this count as unchanged.",
            "default": 0
          },
          "alertWebhookUrl": {
            "title": "Alert webhook",
            "type": "string",
            "description": "Where to send an alert at the end of the run when prices drop or fall to your threshold: a Slack, Discord or Telegram bot address, or any https address (Make, n8n, Zapier, your server get the full JSON)."
          },
          "alertPriceBelow": {
            "title": "Alert when the price is at or below",
            "minimum": 0,
            "type": "number",
            "description": "Mark products at or below this price and include them in the alert."
          },
          "alertOnPriceDrop": {
            "title": "Alert on every price drop",
            "type": "boolean",
            "description": "Include every product whose price fell since the last run in the alert. Needs price comparison, which an alert turns on by itself.",
            "default": true
          },
          "fastMode": {
            "title": "Fast mode (for AI agents)",
            "type": "boolean",
            "description": "Answer within about 30 seconds: the first results page of each query, no product pages, short rows (title, price, store, delivery, links, rating). Filters and sort order still apply. A query Google did not answer in time gets a free TIME_LIMIT row.",
            "default": false
          },
          "label": {
            "title": "Label",
            "type": "string",
            "description": "Your own text, copied into every row: a client, a project, a category."
          },
          "summaryRows": {
            "title": "Summary row per query",
            "type": "boolean",
            "description": "Add one free row per search with the lowest, median and highest price, the number of stores and the top stores.",
            "default": true
          },
          "saveInlineImages": {
            "title": "Pictures for every product",
            "type": "boolean",
            "description": "Google gives many products of a results page only as a small picture inside the page, without a link. These pictures are saved to the run's key-value store and their signed link goes to \"imageUrl\", so every product has a picture. Turn off to keep only the links Google gives. With \"Open each product page\" every product also gets its full-size photos.",
            "default": true
          },
          "includeErrorRows": {
            "title": "Rows for inputs that gave nothing",
            "type": "boolean",
            "description": "A free row with the reason for every query or link that gave no product (no results, Google did not answer).",
            "default": true
          },
          "failIfAllInputsFail": {
            "title": "Fail the run when every input gives an error",
            "type": "boolean",
            "description": "By default such a run succeeds with error rows, so that an automation keeps going. Turn this on to make it fail instead.",
            "default": false
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many Google pages to read at once.",
            "default": 5
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}