{
  "openapi": "3.0.1",
  "info": {
    "title": "Amazon Best Sellers Tracker: Rank Changes, 21 Marketplaces",
    "description": "Track Amazon Best Sellers and New Releases ranks 1-100 in 21 marketplaces (US, UK, DE, FR, JP, IN, BR and more). Each run shows what moved up, moved down, entered or dropped off the chart, with prices, price changes, ratings and reviews. Proxies included on paid plans.",
    "version": "0.1",
    "x-build-id": "YFM79GgcmZO0jcrDC"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fayoussef~amazon-bestsellers-tracker/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fayoussef-amazon-bestsellers-tracker",
        "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/fayoussef~amazon-bestsellers-tracker/runs": {
      "post": {
        "operationId": "runs-sync-fayoussef-amazon-bestsellers-tracker",
        "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/fayoussef~amazon-bestsellers-tracker/run-sync": {
      "post": {
        "operationId": "run-sync-fayoussef-amazon-bestsellers-tracker",
        "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": {
          "startUrls": {
            "title": "Chart URLs",
            "type": "array",
            "description": "Paste Amazon Best Sellers or New Releases pages from any of the 21 supported marketplaces, for example https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics or https://www.amazon.de/gp/new-releases/kitchen. A chart's front page (https://www.amazon.com/gp/bestsellers) tracks every department. Leave empty to use the marketplace picker below.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "marketplaces": {
            "title": "Marketplaces",
            "type": "array",
            "description": "Or pick marketplaces, and the actor tracks the charts below in each of them. Combine with Departments to limit the scope, or leave Departments empty to track every department (up to Max categories).",
            "items": {
              "type": "string",
              "enum": [
                "com",
                "co.uk",
                "de",
                "fr",
                "it",
                "es",
                "ca",
                "co.jp",
                "com.au",
                "in",
                "com.mx",
                "com.br",
                "nl",
                "se",
                "pl",
                "com.tr",
                "ae",
                "sa",
                "sg",
                "com.be",
                "eg"
              ],
              "enumTitles": [
                "🇺🇸 amazon.com",
                "🇬🇧 amazon.co.uk",
                "🇩🇪 amazon.de",
                "🇫🇷 amazon.fr",
                "🇮🇹 amazon.it",
                "🇪🇸 amazon.es",
                "🇨🇦 amazon.ca",
                "🇯🇵 amazon.co.jp",
                "🇦🇺 amazon.com.au",
                "🇮🇳 amazon.in",
                "🇲🇽 amazon.com.mx",
                "🇧🇷 amazon.com.br",
                "🇳🇱 amazon.nl",
                "🇸🇪 amazon.se",
                "🇵🇱 amazon.pl",
                "🇹🇷 amazon.com.tr",
                "🇦🇪 amazon.ae",
                "🇸🇦 amazon.sa",
                "🇸🇬 amazon.sg",
                "🇧🇪 amazon.com.be",
                "🇪🇬 amazon.eg"
              ]
            }
          },
          "charts": {
            "title": "Charts",
            "type": "array",
            "description": "Which charts to track for the picked marketplaces. Movers & Shakers is not offered because Amazon currently shows it empty everywhere; this actor computes its own movers from run-to-run rank changes instead.",
            "items": {
              "type": "string",
              "enum": [
                "bestsellers",
                "new-releases"
              ],
              "enumTitles": [
                "Best Sellers",
                "New Releases"
              ]
            },
            "default": [
              "bestsellers"
            ]
          },
          "categories": {
            "title": "Departments",
            "type": "array",
            "description": "Optional department slugs as they appear in Amazon's chart URLs, for example electronics, kitchen, toys-and-games, beauty. Slugs differ between marketplaces (amazon.com uses toys-and-games, amazon.de uses toys). Leave empty to track every department.",
            "items": {
              "type": "string"
            }
          },
          "includeSubcategories": {
            "title": "Include sub-categories",
            "type": "boolean",
            "description": "Also track the sub-categories listed on each department's chart page (for example Electronics > Headphones). Counts toward Max categories.",
            "default": false
          },
          "maxCategories": {
            "title": "Max categories",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Upper limit on chart categories tracked in one run. Each category returns up to 100 products.",
            "default": 20
          },
          "maxRank": {
            "title": "Max rank",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Track ranks 1 to this number in each category. Amazon charts go to 100.",
            "default": 100
          },
          "trackChanges": {
            "title": "Track rank changes",
            "type": "boolean",
            "description": "Compare every run with the previous run of the same watchlist: each product gets movement (new, up, down, same), previous rank, rank change and price change. The first run saves a baseline. Schedule the actor daily or hourly to get your own movers & shakers.",
            "default": true
          },
          "watchlistName": {
            "title": "Watchlist name",
            "type": "string",
            "description": "History is kept per watchlist name, so separate schedules (for example one per client) do not mix their history. Use the same name on every run you want compared.",
            "default": "default"
          },
          "includeDropped": {
            "title": "Include products that dropped off",
            "type": "boolean",
            "description": "Add a row (movement: dropped) for each product that was on the chart last run and is gone now.",
            "default": true
          },
          "onlyMovers": {
            "title": "Only output changes",
            "type": "boolean",
            "description": "Output only products that are new, moved up, moved down or dropped off since the last run. Fewer rows, made for alerts. The first run of a watchlist outputs nothing in this mode, it only saves the baseline.",
            "default": false
          },
          "maxConcurrency": {
            "title": "Parallel categories",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many categories load at the same time.",
            "default": 8
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}