{
  "openapi": "3.0.1",
  "info": {
    "title": "Amazon Seller Scraper | Emails, Phones and Ratings",
    "description": "Amazon Seller Scraper: turn any keyword, product or best-seller list into a lead list of third-party sellers with business name, VAT number, phone, email, address and ratings over time. 15 sellers in 46 seconds, 35 fields each. Optional emails from seller websites, EU and US stores. No login.",
    "version": "1.0",
    "x-build-id": "irZwjp4RrdpFyYcbc"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~amazon-seller-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-amazon-seller-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/silentflow~amazon-seller-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-amazon-seller-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/silentflow~amazon-seller-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-amazon-seller-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": {
          "keywords": {
            "title": "🔎 Search keywords",
            "type": "array",
            "description": "Products to search on the marketplace, as a shopper would type them: <code>phone case</code>, <code>yoga mat</code>, <code>coffee grinder</code>. The actor opens the offers of each product found and returns the third-party sellers behind them, one row per seller. One results page brought 16 sellers for <code>phone case</code> on amazon.de; the search goes page after page until your maximum is reached.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Amazon links: sellers, products, best sellers, categories",
            "type": "array",
            "description": "Paste links copied from any Amazon store:<ul><li>a seller profile: <code>https://www.amazon.de/sp?seller=A18EE9GVRFMIY1</code></li><li>a storefront: <code>https://www.amazon.de/s?me=A18EE9GVRFMIY1</code></li><li>a product, for every seller offering it: <code>https://www.amazon.de/dp/B0CTCD7CS5</code></li><li>a best-seller list, for the sellers behind its top products: <code>https://www.amazon.com/gp/bestsellers/kitchen/</code></li><li>a search or category page, for the sellers of its products: <code>https://www.amazon.de/s?k=yoga+mat</code></li></ul>The store in the link wins over the marketplace field, so one run can mix countries.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "ids": {
            "title": "🆔 Seller ids or ASINs",
            "type": "array",
            "description": "A seller id (<code>A18EE9GVRFMIY1</code>, the value after <code>seller=</code> in a profile link) reads that seller. An ASIN (<code>B0CTCD7CS5</code>, the 10 characters after <code>/dp/</code>) reads every seller offering that product. Both are read on the marketplace below. An id Amazon does not know gives no row and is counted in the run summary.",
            "items": {
              "type": "string"
            }
          },
          "marketplace": {
            "title": "🌍 Marketplace",
            "enum": [
              "de",
              "com",
              "co.uk",
              "fr",
              "it",
              "es",
              "nl",
              "pl",
              "se",
              "com.be",
              "ca",
              "com.mx",
              "com.br",
              "com.au",
              "co.jp",
              "in",
              "sg",
              "ae",
              "sa",
              "com.tr"
            ],
            "type": "string",
            "description": "The Amazon store to search. European stores publish each business seller's legal details: <b>email, phone, VAT number, trade register number and address</b>. amazon.com publishes the business name and address. Links keep their own store.",
            "default": "de"
          },
          "marketplaces": {
            "title": "🌍 More marketplaces",
            "type": "array",
            "description": "Run the same keywords and ids on these stores too, in one run: add <code>fr</code>, <code>it</code> and <code>es</code> next to amazon.de to cover four European stores at once. Each store gives its own rows, and Max sellers is shared across them. Links keep their own store. Leave empty for the marketplace above only.",
            "items": {
              "type": "string",
              "enum": [
                "de",
                "com",
                "co.uk",
                "fr",
                "it",
                "es",
                "nl",
                "pl",
                "se",
                "com.be",
                "ca",
                "com.mx",
                "com.br",
                "com.au",
                "co.jp",
                "in",
                "sg",
                "ae",
                "sa",
                "com.tr"
              ],
              "enumTitles": [
                "amazon.de (Germany)",
                "amazon.com (United States)",
                "amazon.co.uk (United Kingdom)",
                "amazon.fr (France)",
                "amazon.it (Italy)",
                "amazon.es (Spain)",
                "amazon.nl (Netherlands)",
                "amazon.pl (Poland)",
                "amazon.se (Sweden)",
                "amazon.com.be (Belgium)",
                "amazon.ca (Canada)",
                "amazon.com.mx (Mexico)",
                "amazon.com.br (Brazil)",
                "amazon.com.au (Australia)",
                "amazon.co.jp (Japan)",
                "amazon.in (India)",
                "amazon.sg (Singapore)",
                "amazon.ae (UAE)",
                "amazon.sa (Saudi Arabia)",
                "amazon.com.tr (Turkey)"
              ]
            }
          },
          "maxItems": {
            "title": "🔢 Max sellers",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many sellers, shared fairly across your keywords, links, ids and stores. 20 sellers from a keyword take under a minute. Set it to what you need, the cost grows with it.",
            "default": 50
          },
          "sellerCountry": {
            "title": "📍 Seller country",
            "type": "string",
            "description": "Keep only sellers whose business address is in this country: pick it in the list, or type its code (<code>DE</code>, <code>DEU</code>) or its English name. Most sellers of a typical keyword are based abroad (10 Italian sellers out of 66 read for <code>borraccia termica</code> on amazon.it), so the search reads more products to fill your maximum and takes longer. Leave empty for every seller."
          },
          "enrichEmails": {
            "title": "💌 Find emails on the seller's website",
            "type": "boolean",
            "description": "Look up each business seller's own website and add the <b>emails and phones printed on it</b> (<code>websiteEmails</code>, <code>websitePhones</code>), whether it <b>takes payments online</b> and with what (<code>takesPayments</code>, <code>paymentProcessors</code>), and fill <code>contactEmail</code> when Amazon shows no email. A site counts only when it shows the seller's VAT or register number, its Amazon email or phone, its registered name, its office address or a link to its Amazon store, so a namesake's site is never returned; <code>websiteMatchedBy</code> says which. 12 sellers out of 15 got their website for <code>kaffeemühle</code> on amazon.de; on amazon.com, where seller pages show no email, 2 out of 15 got one from their site. Adds a few seconds per seller.",
            "default": false
          },
          "includeStorefront": {
            "title": "🏪 Add storefront size",
            "type": "boolean",
            "description": "Open each seller's storefront to add <b>how many products it lists</b> (<code>productCount</code>) and its departments, a quick way to tell a large brand from a small shop. Adds one page per seller. A storefront that cannot be read leaves the row with every other field.",
            "default": false
          },
          "maxFeedbackPerSeller": {
            "title": "⭐ Buyer feedback per seller",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Add each seller's newest buyer feedback to its row (<code>feedback</code>): stars, full comment, date, buyer name, Amazon's note when it struck a feedback from the score, and the seller's reply. <code>5</code> adds the latest five, up to <code>1000</code>; <code>feedbackComplete</code> says when the list holds all of them. <code>0</code> leaves feedback out. Every 5 feedback add one short page per seller.",
            "default": 0
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}