{
  "openapi": "3.0.1",
  "info": {
    "title": "Amazon Product Details Scraper: Buy Box, Stock & Price Changes",
    "description": "Amazon Product Details Scraper extracts product titles, ASINs, prices, Buy Box sellers, stock status, ratings, reviews, and availability. Track price and inventory changes to monitor competitors, identify pricing trends, and support Amazon product research.",
    "version": "0.1",
    "x-build-id": "G2FwuG9C6I6pQDKpf"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/api-empire~amazon-product-details-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-api-empire-amazon-product-details-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/api-empire~amazon-product-details-scraper/runs": {
      "post": {
        "operationId": "runs-sync-api-empire-amazon-product-details-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/api-empire~amazon-product-details-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-api-empire-amazon-product-details-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": [
          "asins"
        ],
        "properties": {
          "asins": {
            "title": "🏷️ Products to price",
            "type": "array",
            "description": "One entry per product: an ASIN (B07GBZ4Q68) or a full product URL (https://www.amazon.com/dp/B07GBZ4Q68). Each entry returns one row.",
            "items": {
              "type": "string"
            }
          },
          "watchAsins": {
            "title": "📌 Extra products to watch",
            "type": "array",
            "description": "Additional ASINs or product URLs, merged with the list above and de-duplicated. Useful when you keep a fixed core list and add a few ad-hoc products for one run.",
            "items": {
              "type": "string"
            }
          },
          "requireBuyBox": {
            "title": "💵 Only return products that have a featured offer",
            "type": "boolean",
            "description": "Off (default): a product with no featured offer is still returned, with price = null and buyBoxPresent = false. On: that product is skipped entirely, so every row you get carries a real price.",
            "default": false
          },
          "includeUnitPrice": {
            "title": "⚖️ Include the per-unit price",
            "type": "boolean",
            "description": "Returns pricePerUnit (for example $0.32/count) when the product shows one. The per-unit figure and the list price share the same styling on Amazon, so they are told apart before either is reported. Default: on.",
            "default": true
          },
          "includeCoupons": {
            "title": "🎟️ Include coupon and promotion text",
            "type": "boolean",
            "description": "Returns couponText with the promotion shown next to the price, for example \"Coupon: Save 15%\". Default: on.",
            "default": true
          },
          "trackChangesBetweenRuns": {
            "title": "📈 Compare against my previous run",
            "type": "boolean",
            "description": "Stores this run's price, stock state, rating and review count per product, and compares the next run against it. The very first run for a product reports null deltas and runsObserved = 1 — no history is invented. Default: on.",
            "default": true
          },
          "changeBaselineName": {
            "title": "🗂️ Baseline name",
            "type": "string",
            "description": "Keeps separate comparison baselines apart. Runs that share a baseline name compare against each other; a new name starts a fresh baseline. Example: weekly-audit. Default: default.",
            "default": "default"
          },
          "onlyChangedSinceLastRun": {
            "title": "🔔 Only return products that changed",
            "type": "boolean",
            "description": "Emits a product only when its price, stock state or rating differs from the stored baseline. Products seen for the first time are always emitted. Default: off.",
            "default": false
          },
          "minPriceChangePercent": {
            "title": "📉 Minimum price move to report (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Used together with the option above: a product whose price moved by less than this percentage is treated as unchanged. Example: 5 reports only moves of 5% or more. Default: 0 (report every move).",
            "default": 0
          },
          "marketplaceDomain": {
            "title": "🌐 Amazon marketplace",
            "enum": [
              "amazon.com",
              "amazon.co.uk",
              "amazon.de",
              "amazon.fr",
              "amazon.es",
              "amazon.it",
              "amazon.ca",
              "amazon.com.au",
              "amazon.co.jp",
              "amazon.in",
              "amazon.com.mx",
              "amazon.nl",
              "amazon.se",
              "amazon.pl",
              "amazon.sg",
              "amazon.ae",
              "amazon.sa",
              "amazon.com.br",
              "amazon.com.tr",
              "amazon.eg",
              "amazon.ie",
              "amazon.com.be"
            ],
            "type": "string",
            "description": "The marketplace the products are read from. The exit country below follows this choice automatically. Default: amazon.com."
          },
          "pageLanguage": {
            "title": "🗣️ Page language",
            "enum": [
              "",
              "en-US",
              "en-GB",
              "de-DE",
              "fr-FR",
              "es-ES",
              "it-IT",
              "ja-JP",
              "zh-CN"
            ],
            "type": "string",
            "description": "Requests the product page in this language. Leave empty to use the marketplace default."
          },
          "exitCountry": {
            "title": "📍 Exit country",
            "enum": [
              "AUTO",
              "US",
              "GB",
              "DE",
              "FR",
              "ES",
              "IT",
              "CA",
              "AU",
              "JP",
              "IN",
              "MX",
              "NL",
              "SE",
              "PL",
              "SG",
              "AE",
              "SA",
              "BR",
              "TR",
              "EG",
              "IE",
              "BE"
            ],
            "type": "string",
            "description": "The country the marketplace is read from. Amazon shows different prices, delivery figures and offers per country, so this is pinned rather than left to chance. AUTO follows the marketplace above."
          },
          "amazonDomain": {
            "title": "🌍 Amazon domain (legacy key)",
            "type": "string",
            "description": "Kept so an input written for the original Amazon Product Details Scraper still runs unchanged. Used only when 'Amazon marketplace' above is left empty.",
            "default": "amazon.com"
          },
          "language": {
            "title": "🈯 Language (legacy key)",
            "enum": [
              "",
              "en-US",
              "en-GB",
              "de-DE",
              "fr-FR",
              "es-ES",
              "it-IT",
              "ja-JP",
              "zh-CN"
            ],
            "type": "string",
            "description": "Kept for backward compatibility. Used only when 'Page language' above is left empty.",
            "default": ""
          },
          "proxyCountry": {
            "title": "🧭 Proxy country (legacy key)",
            "enum": [
              "AUTO",
              "US",
              "GB",
              "DE",
              "FR",
              "ES",
              "IT",
              "CA",
              "AU",
              "JP"
            ],
            "type": "string",
            "description": "Kept for backward compatibility. Used only when 'Exit country' above is left on AUTO.",
            "default": "AUTO"
          },
          "proxyConfiguration": {
            "title": "⚙️ Proxy configuration",
            "type": "object",
            "description": "Connection settings used to reach the marketplace. Keeping this enabled is recommended, otherwise prices may be read from an unpredictable country."
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}