{
  "openapi": "3.0.1",
  "info": {
    "title": "Amazon Seller Email Scraper — Public Contact Finder",
    "description": "Find publicly disclosed Amazon seller contact emails from seller profiles and the sellers' own business websites. Returns email provenance, legal name, address, marketplace and source URLs.",
    "version": "1.1",
    "x-build-id": "IcTH8nLm3GzMF0zu2"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~amazon-seller-email-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-amazon-seller-email-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/khadinakbar~amazon-seller-email-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-amazon-seller-email-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/khadinakbar~amazon-seller-email-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-amazon-seller-email-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": "Use this to find sellers by what they sell. Each keyword is searched on the selected marketplaces and the sellers behind the results are checked. Example: [\"phone case\", \"yoga mat\"]. This is not a seller name or an email address.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "asins": {
            "title": "Product ASINs",
            "type": "array",
            "description": "Use this to check every third-party seller offering specific products. Enter 10-character ASINs such as B0C1234567. This is not a seller ID.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "sellerIds": {
            "title": "Amazon seller IDs",
            "type": "array",
            "description": "Use this when you know Amazon merchant IDs. Enter 13-14 uppercase characters such as A3CZCQADWCJIMK. The same ID works on every EU marketplace. This is not a 10-character ASIN or a website domain.",
            "items": {
              "type": "string",
              "pattern": "^[A-Z0-9]{13,14}$"
            },
            "default": []
          },
          "startUrls": {
            "title": "Amazon seller, storefront, or product URLs",
            "type": "array",
            "description": "Use this when you already have Amazon URLs: seller pages (/sp?seller=), storefronts (me=), product pages (/dp/ASIN) or search result pages (/s?k=keyword). Product and search pages are expanded into their sellers. This is not for company websites; use companyWebsites for those.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "marketplace": {
            "title": "Amazon marketplace",
            "enum": [
              "US",
              "UK",
              "DE",
              "FR",
              "CA",
              "ES",
              "IT",
              "JP",
              "AU",
              "IN",
              "MX",
              "BR",
              "NL",
              "SE",
              "PL",
              "TR",
              "AE",
              "SG"
            ],
            "type": "string",
            "description": "Use this to choose the Amazon marketplace for seller IDs and keywords when you use only one. Defaults to DE (Germany). EU marketplaces (DE, FR, IT, ES, NL, SE, PL) publish a seller email; others do not. A supplied Amazon URL overrides it.",
            "default": "DE"
          },
          "marketplaces": {
            "title": "Marketplaces for keyword search",
            "type": "array",
            "description": "Use this to search the same keywords on several marketplaces in one run, for example [\"DE\",\"FR\",\"IT\",\"ES\"]. Sellers found on more than one marketplace are returned once. Leave empty to use the single marketplace above.",
            "items": {
              "type": "string",
              "enum": [
                "US",
                "UK",
                "DE",
                "FR",
                "CA",
                "ES",
                "IT",
                "JP",
                "AU",
                "IN",
                "MX",
                "BR",
                "NL",
                "SE",
                "PL",
                "TR",
                "AE",
                "SG"
              ]
            },
            "default": []
          },
          "discoverWebsiteEmails": {
            "title": "Discover emails on official seller websites",
            "type": "boolean",
            "description": "Use this to open the seller's own website when Amazon shows no email, and look for one on the homepage and a few contact pages. Included in the price at no extra charge. Defaults to true. It never searches the open web or guesses addresses.",
            "default": true
          },
          "companyWebsites": {
            "title": "Known official seller websites",
            "type": "array",
            "description": "Use this to supply an official company website for a specific seller ID when Amazon does not link one. Each item needs a sellerId and a full HTTPS URL, for example {\"sellerId\":\"A1ODG4ICFE5MU3\",\"url\":\"https://example.com\"}. It is optional and only used when website discovery is enabled. This is not a list of email addresses or a general web-search query.",
            "items": {
              "type": "object",
              "properties": {
                "sellerId": {
                  "type": "string",
                  "title": "Seller ID",
                  "description": "Amazon merchant ID to which this official website belongs. Use 13–14 uppercase characters, for example A1ODG4ICFE5MU3. It must also appear in sellerIds or resolve from a start URL. This is not an ASIN or a company registration number."
                },
                "url": {
                  "type": "string",
                  "title": "Official website URL",
                  "description": "Full public company website URL to inspect for the mapped seller. Use an HTTPS URL such as https://example.com. The actor stays on this site and only follows a few contact-oriented pages. This is not an email address, social-media profile, or Amazon URL."
                }
              },
              "required": [
                "sellerId",
                "url"
              ]
            },
            "default": []
          },
          "maxResults": {
            "title": "Maximum emails to find",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Use this to cap how many sellers with an email you want to pay for. The run stops as soon as this many are found. Enter 1 to 1000; each email found is charged once, and sellers without an email are free. Defaults to 10.",
            "default": 10
          },
          "maxSellersToCheck": {
            "title": "Maximum seller pages to check",
            "minimum": 1,
            "maximum": 3000,
            "type": "integer",
            "description": "Use this to cap cost when many sellers have no public email. The run stops after this many seller pages. Leave empty to use 3 times the email target (or your seller ID list size). Enter 1 to 3000. Runs also stop early if fewer than 1 in 5 EU sellers show an email after 40 checks."
          },
          "maxContactPages": {
            "title": "Maximum official website pages per seller",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Use this to limit extra official-site crawling for a seller without an Amazon-page email. The homepage is included, followed by same-site contact, support, imprint, or legal pages. Defaults to 3 and accepts 1–5. This does not crawl social networks, marketplaces, or arbitrary external links.",
            "default": 3
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}