{
  "openapi": "3.0.1",
  "info": {
    "title": "Amazon Seller Data Extractor",
    "description": "Amazon Seller Data Extractor — Extract Amazon seller data including seller names, ratings, feedback counts, storefront URLs, product listings, pricing, fulfillment details, and seller performance metrics. Useful for seller research, competitor analysis, market research, and e-commerce intelligence.",
    "version": "0.2",
    "x-build-id": "A31kceMLR7usYHcFF"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fastdataapi~amazon-seller-data-extractor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fastdataapi-amazon-seller-data-extractor",
        "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/fastdataapi~amazon-seller-data-extractor/runs": {
      "post": {
        "operationId": "runs-sync-fastdataapi-amazon-seller-data-extractor",
        "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/fastdataapi~amazon-seller-data-extractor/run-sync": {
      "post": {
        "operationId": "run-sync-fastdataapi-amazon-seller-data-extractor",
        "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": {
          "asinInputs": {
            "title": "🆔 Amazon product codes (ASINs)",
            "type": "array",
            "description": "One ASIN per row, for example B00P8XQPY4. Product links (…/dp/ASIN) work too. The product page shows the seller of its current offer and how it ships (FBA or FBM); that seller is then scraped. Products sold only by Amazon itself have no third-party seller and get a free error row.",
            "items": {
              "type": "string"
            }
          },
          "usernameInputs": {
            "title": "👤 Seller IDs",
            "type": "array",
            "description": "Amazon seller (merchant) IDs such as A33W53J5GVPZ8K – the value after seller= in a seller page link. Seller page links are accepted here too.",
            "items": {
              "type": "string"
            }
          },
          "keywordInputs": {
            "title": "🔎 Keywords",
            "type": "array",
            "description": "Search phrases such as \"coffee grinder\". The first page of Amazon's results (about 20 products) is checked and the third-party seller of each product is scraped, so one keyword usually gives 8–15 different sellers.",
            "items": {
              "type": "string"
            }
          },
          "categoryUrls": {
            "title": "🔗 Search or category links",
            "type": "array",
            "description": "Full Amazon search or category links, for example https://www.amazon.com/s?k=coffee+grinder. Works like a keyword: the first results page is checked and the sellers of its products are scraped.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Seller page links",
            "type": "array",
            "description": "Amazon seller page links such as https://www.amazon.com/sp?seller=A33W53J5GVPZ8K. Storefront links (…?me=SELLERID) and product links also work. The marketplace is taken from each link.",
            "items": {
              "type": "string"
            }
          },
          "includeProducts": {
            "title": "✅ Include seller product listings",
            "type": "boolean",
            "description": "When on, each seller's storefront products are saved as separate rows (type = product) that name their seller in parentSellerId and parentSellerName. Each product row is a result of its own. Off by default.",
            "default": false
          },
          "maxProductsPerSeller": {
            "title": "🔢 Max products per seller",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "Most product rows per seller when product listings are on (0 = every product the storefront lists, up to 20 storefront pages). Free plan: up to 20 rows per run (all sellers and products together) and 200 per month; paid plans have no limit.",
            "default": 20
          },
          "maxFeedbackPages": {
            "title": "🔢 Max review pages",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many pages of seller reviews to read (about 5 reviews per page; 1 = the reviews shown on the seller page). Still capped by Max reviews per seller.",
            "default": 1
          },
          "maxComments": {
            "title": "🔢 Max reviews per seller",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Most reviews kept in each seller row (0 = all reviews from the pages read).",
            "default": 10
          },
          "sortOrder": {
            "title": "🔃 Review order",
            "enum": [
              "recent",
              "helpful",
              "rating"
            ],
            "type": "string",
            "description": "Order of the reviews inside each seller row: Recent = newest first, Helpful = Amazon's own order, By rating = highest stars first.",
            "default": "recent"
          },
          "minRatingPositive": {
            "title": "🎯 Min positive rating (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Skip sellers whose positive rating over the last 12 months is below this percentage (0 = no filter). Sellers without a positive percentage are skipped when this is above 0.",
            "default": 0
          },
          "minLifetimeRatings": {
            "title": "🎯 Min lifetime ratings",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Skip sellers with fewer lifetime ratings than this (0 = no filter). Example: 100 keeps established sellers only.",
            "default": 0
          },
          "fulfillmentType": {
            "title": "🎯 Fulfillment type",
            "enum": [
              "any",
              "FBA",
              "FBM"
            ],
            "type": "string",
            "description": "Keep only FBA (shipped by Amazon) or FBM (shipped by the seller) sellers. The fulfillment type is read from a product offer, so it is known only for sellers found through an ASIN, keyword or category link. Sellers entered by ID or seller link have no fulfillment type and are skipped when FBA or FBM is chosen.",
            "default": "any"
          },
          "amazonDomain": {
            "title": "📍 Amazon marketplace",
            "type": "string",
            "description": "Marketplace domain such as amazon.com, amazon.co.uk, amazon.de, amazon.fr or amazon.co.jp. It sets the country and currency in the results.",
            "default": "amazon.com"
          },
          "language": {
            "title": "🌍 Page language",
            "type": "string",
            "description": "Optional language code such as en-US, en-GB or de-DE. Amazon is asked for pages in this language where the marketplace offers it. Leave empty for the marketplace's default.",
            "default": ""
          },
          "proxyCountry": {
            "title": "📍 Connection country",
            "type": "string",
            "description": "Two-letter country code (for example US, GB, DE) for the connection the actor uses when no proxy is selected below. AUTO uses the marketplace's own country, which is what Amazon needs to show sellers on product pages.",
            "default": "AUTO"
          },
          "maxConcurrency": {
            "title": "⚡ Max parallel requests",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many Amazon pages load at the same time. Higher is faster; lower (1–5) is gentler when Amazon refuses many requests.",
            "default": 10
          },
          "proxyConfiguration": {
            "title": "🌐 Proxy configuration",
            "type": "object",
            "description": "Leave as is to use Apify's residential proxy in the marketplace's country (see Connection country). Select Apify Proxy groups or your own proxies to use them instead."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}