{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Shopping Scraper - Prices & Offers",
    "description": "Search public Google Shopping by keyword or EAN, GTIN, or SKU. Get product titles, prices, merchants, ranks, store offers, and Google price history. Filter by market, language, price, condition, rating, delivery, sale, or merchant.",
    "version": "1.0",
    "x-build-id": "kMDdWugtVTiOFY3ad"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/maximedupre~google-shopping-offers-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-maximedupre-google-shopping-offers-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/maximedupre~google-shopping-offers-scraper/runs": {
      "post": {
        "operationId": "runs-sync-maximedupre-google-shopping-offers-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/maximedupre~google-shopping-offers-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-maximedupre-google-shopping-offers-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",
        "required": [
          "discoveryMethod",
          "market",
          "language"
        ],
        "properties": {
          "discoveryMethod": {
            "title": "Find offers by",
            "enum": [
              "keywords",
              "identifiers"
            ],
            "type": "string",
            "description": "Choose one way to find Google Shopping offers. Use Product keywords for searches such as a product name, or Product identifiers for EAN, GTIN, or Google Shopping SKU values."
          },
          "productKeywords": {
            "title": "Product keywords",
            "minItems": 1,
            "type": "array",
            "description": "Add one or more product keywords, with one search phrase per item. This list is used when Product keywords is selected.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "productIdentifiers": {
            "title": "Product identifiers",
            "minItems": 1,
            "type": "array",
            "description": "Add one or more EAN, GTIN, or Google Shopping SKU values, with one identifier per item. This list is used when Product identifiers is selected.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "market": {
            "title": "Google Shopping market",
            "pattern": "^[A-Z]{2}$",
            "type": "string",
            "description": "Enter a two-letter country code for the Google Shopping market, such as US, GB, or DE."
          },
          "language": {
            "title": "Result language",
            "pattern": "^[a-z]{2,3}(-[A-Z]{2})?$",
            "type": "string",
            "description": "Enter the language code for Google Shopping results, such as en, de, or fr. Add a country code only when needed, such as pt-BR."
          },
          "priceRange": {
            "title": "Price range",
            "type": "object",
            "description": "Optionally set a lower and upper price in the selected market currency. Leave either value empty when that side of the range has no limit.",
            "properties": {
              "min": {
                "title": "Minimum price",
                "type": "number",
                "description": "Set the lower price bound to zero or a positive number.",
                "minimum": 0
              },
              "max": {
                "title": "Maximum price",
                "type": "number",
                "description": "Set the upper price bound to zero or a positive number.",
                "minimum": 0
              }
            }
          },
          "conditions": {
            "title": "Product conditions",
            "minItems": 1,
            "type": "array",
            "description": "Optionally return only offers with one of the selected Google Shopping conditions.",
            "items": {
              "type": "string",
              "enum": [
                "new",
                "used",
                "refurbished"
              ],
              "enumTitles": [
                "New",
                "Used",
                "Refurbished"
              ]
            }
          },
          "saleOnly": {
            "title": "Sale offers only",
            "type": "boolean",
            "description": "When enabled, return only offers that Google marks as discounted.",
            "default": false
          },
          "merchants": {
            "title": "Merchants",
            "minItems": 1,
            "type": "array",
            "description": "Optionally add merchant or marketplace names. Return only offers from these names.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "minimumRating": {
            "title": "Minimum product rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Optionally require a product rating from 0 to 5 stars."
          },
          "minimumReviewCount": {
            "title": "Minimum review count",
            "minimum": 0,
            "type": "integer",
            "description": "Optionally require at least this many product reviews. Use zero or a positive number."
          },
          "freeDeliveryOnly": {
            "title": "Free delivery only",
            "type": "boolean",
            "description": "When enabled, return only offers that show free delivery.",
            "default": false
          },
          "sortOrder": {
            "title": "Offer sort order",
            "enum": [
              "relevance",
              "price",
              "rating"
            ],
            "type": "string",
            "description": "Choose how offers are ordered within each keyword or identifier query.",
            "default": "relevance"
          },
          "maxOffersPerQuery": {
            "title": "Max offers per query",
            "minimum": 0,
            "type": "integer",
            "description": "Optionally stop after this many offers for each submitted keyword or identifier. Leave it empty or set it to zero to return all available offers."
          },
          "includeStoreOffers": {
            "title": "Include more store offers",
            "type": "boolean",
            "description": "When enabled, each product row lists more of the stores that sell it on Google Shopping, with each store's price, link, delivery, stock, returns, and rating. When disabled, each row lists only the first few stores that Google Shopping shows.",
            "default": false
          },
          "maxStoreOffersPerProduct": {
            "title": "Max store offers per product",
            "minimum": 0,
            "type": "integer",
            "description": "Used only when Include more store offers is enabled. Get up to this many store offers for each product, where available. Set it to zero to get all store offers.",
            "default": 20
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}