{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Shopping Scraper: products, prices, price watch",
    "description": "Scrape Google Shopping without a browser or SerpApi, in the country and currency you ask (not the proxy's). Price, condition, store, rating and a stable product ID, up to several hundred products per search. Duplicates and filtered products are never charged. Price watch.",
    "version": "0.1",
    "x-build-id": "s6MYo6Wp0kKQCWHIu"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/alexmorain~google-shopping-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-alexmorain-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/alexmorain~google-shopping-scraper/runs": {
      "post": {
        "operationId": "runs-sync-alexmorain-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/alexmorain~google-shopping-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-alexmorain-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 terms",
            "type": "array",
            "description": "One product search per line, as you would type it in Google Shopping: <code>espresso machine</code>, <code>wireless earbuds</code>. Each line is one search.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country",
            "enum": [
              "us",
              "gb",
              "ca",
              "au",
              "de",
              "fr",
              "es",
              "it",
              "nl",
              "in",
              "br",
              "mx",
              "jp"
            ],
            "type": "string",
            "description": "Which Google to ask: it sets the domain (google.com, google.de...), the country of the stores and the currency of the prices. Without this, Google would answer for the country of the proxy's IP address.",
            "default": "us"
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Interface language of Google, a two-letter code such as <code>en</code>, <code>de</code>, <code>fr</code>. Empty uses the main language of the country."
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "Optional. A place more precise than the country, written as Google names it, from the smallest to the largest: <code>Austin,Texas,United States</code>, <code>Lyon,Auvergne-Rhone-Alpes,France</code>. It changes the local offers Google shows (for example same-day delivery). Maximum 63 characters. Leave empty to use the country."
          },
          "startUrls": {
            "title": "Google Shopping URLs",
            "type": "array",
            "description": "Optional. Google Shopping search URLs, such as <code>https://www.google.com/search?q=espresso+machine&amp;udm=28</code> (or <code>tbm=shop</code>). The search text, <code>hl</code> and <code>gl</code> are read from the URL. Other parameters are ignored.",
            "items": {
              "type": "string"
            }
          },
          "maxItemsPerQuery": {
            "title": "Max products per search",
            "minimum": 1,
            "type": "integer",
            "description": "Products returned for each search. Raise it to get more of the search: pagination alone gives about 170 products and Complete coverage goes further.",
            "default": 100
          },
          "maxItems": {
            "title": "Max products",
            "minimum": 1,
            "type": "integer",
            "description": "Total products returned by the run, across all searches.",
            "default": 1000
          },
          "completeCoverage": {
            "title": "Complete coverage",
            "type": "boolean",
            "description": "On: when pagination does not give enough products, ask Google variations of each search (best, cheap, used, price bands, then the brands and stores it finds) until nothing new comes back, up to <b>Max requests per search</b>. Off: only the pages of your own search (about 170 products at most).",
            "default": true
          },
          "maxRequestsPerQuery": {
            "title": "Max requests per search",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Budget of Google requests for each search (each returns up to 55 products). The Actor stops earlier when new requests stop finding new products.",
            "default": 60
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 16,
            "type": "integer",
            "description": "Google requests in flight at once, 1 to 16.",
            "default": 10
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "number",
            "description": "Keep products priced at or above this, in the currency of the country. Google cannot filter by price in this view, so the price shown on each product is checked: a product outside the range is dropped, not charged. A product with no readable price is kept."
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "number",
            "description": "Keep products priced at or below this, in the currency of the country. Checked on each product, like the minimum price."
          },
          "condition": {
            "title": "Condition",
            "enum": [
              "any",
              "new",
              "used",
              "refurbished"
            ],
            "type": "string",
            "description": "Keep only new, used (pre-owned) or refurbished products. Google leans towards the condition when asked, but does not filter, so the condition shown on each product is checked: a product showing another condition is dropped, not charged. A product with no label counts as new.",
            "default": "any"
          },
          "onSaleOnly": {
            "title": "On sale only",
            "type": "boolean",
            "description": "Keep only products that show an old price or a discount badge. Others are dropped, not charged.",
            "default": false
          },
          "freeShippingOnly": {
            "title": "Free delivery only",
            "type": "boolean",
            "description": "Keep only products that show free delivery with no minimum order. A product with a paid or conditional delivery line is dropped, not charged. Google shows a delivery line in US, UK, Canada, Australia, India and Japan only: in other countries nothing can be checked and every product is kept.",
            "default": false
          },
          "monitorMode": {
            "title": "Price watch",
            "enum": [
              "off",
              "newOnly",
              "newAndPriceChanges"
            ],
            "type": "string",
            "description": "Remembers the products returned by earlier runs. <b>New products only</b> returns only products not delivered before. <b>New products and price changes</b> also returns a product whose price changed, with its <code>previousPrice</code> and a <code>priceChange</code> of <code>up</code> or <code>down</code>. The first run returns everything that matches. Schedule it daily for a feed that never repeats. Unchanged products are never charged.",
            "default": "off"
          },
          "monitorName": {
            "title": "Monitor name (Price watch)",
            "type": "string",
            "description": "Without a name, the memory belongs to each search as typed. With a name, every run using that name shares it, even if you change the other settings. The memory lives in your key-value store <code>google-shopping-monitor</code>."
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "If set, the Actor POSTs a small JSON summary to this URL at the end of the run, <b>only when at least one product was returned</b>: <code>actor</code>, <code>runId</code>, <code>datasetId</code>, <code>products</code>, <code>monitorMode</code> and one line per search. Use the final URL: a redirect is not followed, except a 307 or 308. An unreachable webhook is logged and never fails the run. Stored encrypted."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}