{
  "openapi": "3.0.1",
  "info": {
    "title": "Amazon Seller Data Extractor Scraper",
    "description": "Amazon Seller Data Extractor Scraper extracts comprehensive seller information from Amazon: seller names, storefront URLs, ratings, product catalogs, fulfillment methods, feedback scores, locations, and contact links. Use for competitive analysis, supplier discovery, monitoring, and automation",
    "version": "0.1",
    "x-build-id": "B1jwQlJ7aCUP3jOtW"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/simpleapi~amazon-seller-data-extractor-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-simpleapi-amazon-seller-data-extractor-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/simpleapi~amazon-seller-data-extractor-scraper/runs": {
      "post": {
        "operationId": "runs-sync-simpleapi-amazon-seller-data-extractor-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/simpleapi~amazon-seller-data-extractor-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-simpleapi-amazon-seller-data-extractor-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",
        "properties": {
          "asinInputs": {
            "title": "📦 Amazon ASINs (product codes)",
            "type": "array",
            "description": "One ASIN per row (example: B00P8XQPY4). We open each product page and pull the seller behind the offer 🏷️✨",
            "items": {
              "type": "string"
            }
          },
          "usernameInputs": {
            "title": "👤 Seller usernames / merchant IDs",
            "type": "array",
            "description": "Amazon seller IDs like A33W53J5GVPZ8K — perfect when you already know exactly who you're researching 🎯",
            "items": {
              "type": "string"
            }
          },
          "keywordInputs": {
            "title": "🔎 Keywords (discover sellers)",
            "type": "array",
            "description": "Search phrases (e.g. \"wireless earbuds\", \"handmade ceramics\"). We run each search, take the top results, and resolve the seller behind each product — great for prospecting new storefronts 🧠💡 (Example: 1 keyword → up to ~8 products scanned → their unique sellers.)",
            "items": {
              "type": "string"
            }
          },
          "categoryUrls": {
            "title": "🗂️ Category / search result URLs",
            "type": "array",
            "description": "Paste full Amazon search or category URLs (e.g. https://www.amazon.com/s?k=coffee+grinder). We expand each into products and resolve their sellers 🧭",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Direct seller page URLs",
            "type": "array",
            "description": "Full Amazon seller profile links (e.g. https://www.amazon.com/sp?seller=…). Paste as many as you need — we follow each one 🔗🚀",
            "items": {
              "type": "string"
            }
          },
          "includeProducts": {
            "title": "📦 Include seller product listings",
            "type": "boolean",
            "description": "Scrape each seller's storefront catalog and emit each product as its own row (type=product, isChild=true) linked to the parent seller. Example: includeProducts=true + maxProductsPerSeller=30 → up to 30 product rows per seller. Default is OFF.",
            "default": false
          },
          "maxProductsPerSeller": {
            "title": "🔢 Max products per seller",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "Cap product rows collected per seller (0 = grab everything the storefront paginates — slower). Only used when 'Include product listings' is ON. Default is 20.",
            "default": 20
          },
          "maxFeedbackPages": {
            "title": "📄 Max feedback pages",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many seller-feedback pages to paginate (1 = first page only). Example: 3 → collect feedback from pages 1–3 (still capped by 'Max reviews per seller'). Default is 1.",
            "default": 1
          },
          "minRatingPositive": {
            "title": "👍 Min positive rating (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Drop sellers whose positive-feedback percentage is below this (0 = no filter). Example: 90 → only sellers with ≥90% positive. Default is 0.",
            "default": 0
          },
          "minLifetimeRatings": {
            "title": "🔢 Min lifetime ratings",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Drop sellers with fewer lifetime ratings than this (0 = no filter). Example: 100 → only established sellers. Default is 0.",
            "default": 0
          },
          "fulfillmentType": {
            "title": "🚚 Fulfillment type",
            "enum": [
              "any",
              "FBA",
              "FBM"
            ],
            "type": "string",
            "description": "Keep only sellers with a given fulfillment method (detected from the product offer when scraping via ASIN). 'Any' = no filter. Note: fulfillment is only known for ASIN-sourced sellers.",
            "default": "any"
          },
          "amazonDomain": {
            "title": "🌐 Amazon domain",
            "type": "string",
            "description": "Examples: amazon.com, amazon.co.uk, amazon.de, amazon.co.jp — pick the storefront your customers actually see 🗺️",
            "default": "amazon.com"
          },
          "language": {
            "title": "🗣️ Page language (locale)",
            "type": "string",
            "description": "Optional locale string (en-US, en-GB, de-DE…). When set, it is sent as the Accept-Language header so Amazon serves that locale. Leave blank to let Amazon decide 🎛️",
            "default": ""
          },
          "sortOrder": {
            "title": "⭐ Review sort order",
            "enum": [
              "recent",
              "helpful",
              "rating"
            ],
            "type": "string",
            "description": "How collected feedback is ordered in each seller row: 🆕 Recent (newest date first), 👍 Helpful (Amazon's on-page order), ⭐ By rating (highest stars first). Default is Recent.",
            "default": "recent"
          },
          "maxComments": {
            "title": "💬 Max reviews per seller",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Cap feedback rows per seller (0 = grab everything the pages allow — slower but exhaustive 📚). Default is 10.",
            "default": 10
          },
          "proxyCountry": {
            "title": "🌎 Proxy country hint",
            "type": "string",
            "description": "ISO-style country for routing (or AUTO ✨, which derives from the Amazon domain) — helps requests feel local and natural 🧭",
            "default": "AUTO"
          },
          "maxConcurrency": {
            "title": "⚡ Max parallel requests",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Higher = faster 🏎️ but hotter on Amazon's radar. Lower (1–5) = gentler, great for fragile storefronts 🐢💚. Default is 10.",
            "default": 10
          },
          "proxyConfiguration": {
            "title": "🧩 Proxy configuration (optional)",
            "type": "object",
            "description": "🏠 Heads-up: this actor always runs on residential proxies for reliability. UI choices here stay for compatibility but may be overridden automatically — expand when you need granular proxy JSON 🛠️💡"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}