{
  "openapi": "3.0.1",
  "info": {
    "title": "Amazon Buy Box & Price Monitor 📦 (with seller ID check)",
    "description": "Watch the Buy Box on any Amazon listing with the local price on .com, .de, .fr, .it, .es and .co.uk: price, seller, FBA, shipping, stock and every other seller's offer, with a change record when one moves. On EU sites it also checks the seller's identity against VAT and company registers.",
    "version": "0.1",
    "x-build-id": "QkeYX4aTTOmGoTIuR"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tagadanar~amazon-product-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tagadanar-amazon-product-monitor",
        "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/tagadanar~amazon-product-monitor/runs": {
      "post": {
        "operationId": "runs-sync-tagadanar-amazon-product-monitor",
        "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/tagadanar~amazon-product-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-tagadanar-amazon-product-monitor",
        "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": {
          "asins": {
            "title": "ASINs to watch",
            "type": "array",
            "description": "One ASIN per line, e.g. <code>B00PGB7OKM</code>. They are read on the marketplace chosen below. Each one returns the live Buy Box price, who is winning the Buy Box, who fulfils it, stock wording, rating, review count and Best Sellers Rank.",
            "items": {
              "type": "string"
            }
          },
          "productUrls": {
            "title": "Product URLs",
            "type": "array",
            "description": "Full Amazon product links, e.g. <code>https://www.amazon.de/dp/B0DK955V6Z</code>. Each URL keeps its own marketplace, so you can watch the same product on amazon.com and amazon.de in one run.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Search keywords",
            "type": "array",
            "description": "Keywords to run through Amazon search, e.g. <code>wireless mouse</code>. You get the ranked results with position, price, rating, review count and whether the slot is sponsored, which is how you track where a product sits against its competitors.",
            "items": {
              "type": "string"
            }
          },
          "sellerIds": {
            "title": "Sellers to verify by ID",
            "type": "array",
            "description": "Check a seller's identity without going through a product page. One entry per line: a seller ID (<code>A3GX1RCD4Z9H04</code>), a marketplace and ID together (<code>de:A3GX1RCD4Z9H04</code>), or a pasted storefront link (<code>https://www.amazon.de/sp?seller=A3GX1RCD4Z9H04</code>). A bare ID uses the marketplace chosen below. Each one returns a seller record with the legal identity Amazon publishes and the register check on it. Use this when you already know which sellers you care about, or when a run does not see a third-party Buy Box to start from.",
            "items": {
              "type": "string"
            }
          },
          "marketplace": {
            "title": "Marketplace",
            "enum": [
              "com",
              "co.uk",
              "de",
              "fr",
              "it",
              "es"
            ],
            "type": "string",
            "description": "Which Amazon site the ASINs and keywords are read on. Product URLs override this per URL.",
            "default": "com"
          },
          "maxResultsPerQuery": {
            "title": "Max results per keyword",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Stop after this many search results for each keyword. You are only charged for results actually delivered.",
            "default": 40
          },
          "verifySeller": {
            "title": "Verify who the seller really is",
            "type": "boolean",
            "description": "For each third-party seller holding the Buy Box, open their storefront, read the legal identity EU law makes Amazon publish (business name, registered address, VAT number, trade register number) and check it against an official register: the EU VAT system for amazon.de/fr/it/es, the French company register, or Companies House for amazon.co.uk. You find out whether the \"German\" seller is a company in Shenzhen. Billed per seller checked, and only when a storefront was actually read.",
            "default": false
          },
          "includeOffers": {
            "title": "Include every seller's offer",
            "type": "boolean",
            "description": "Besides the Buy Box, return the other sellers offering the same product: price, list price, condition (new or used), shipping cost and delivery date, who sells it, who ships it (FBA or not) and each seller's rating. The cheapest new offer and the number of other offers are always included, whether this is on or not. Offers are billed per offer returned (free until September 28, 2026).",
            "default": false
          },
          "maxOffersPerProduct": {
            "title": "Max offers per product",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many offers to return for each product when \"Include every seller's offer\" is on, the Buy Box included, up to 100. Amazon lists them 10 at a time, cheapest first. Each offer returned is billed as an offer.",
            "default": 20
          },
          "monitorMode": {
            "title": "Track changes between runs",
            "type": "boolean",
            "description": "Remember each product's price, Buy Box seller and stock, and return an extra change record whenever one of them moves. The first run records the starting state; schedule the actor daily and later runs tell you what moved.",
            "default": false
          },
          "onlyChanges": {
            "title": "Only return products that changed",
            "type": "boolean",
            "description": "With change tracking on, leave out every product whose price, Buy Box seller and stock are all unchanged since the last run, so a 500-product watchlist returns a short list instead of 500 rows. Turning this on turns change tracking on.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}