{
  "openapi": "3.0.1",
  "info": {
    "title": "Amazon Third-Party Seller Discovery & Lead Finder",
    "description": "Find third-party Amazon sellers behind keywords, categories, best-seller lists, brands or ASINs. Each seller row carries the published business name, address, country, VAT/registration, phone and email where shown, ratings over 30 days to lifetime, offer and FBA context, and optional buyer feedback.",
    "version": "1.0",
    "x-build-id": "svyCUjXMdJfmabGYX"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/xyrelith-data~amazon-seller-discovery-leads/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-xyrelith-data-amazon-seller-discovery-leads",
        "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/xyrelith-data~amazon-seller-discovery-leads/runs": {
      "post": {
        "operationId": "runs-sync-xyrelith-data-amazon-seller-discovery-leads",
        "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/xyrelith-data~amazon-seller-discovery-leads/run-sync": {
      "post": {
        "operationId": "run-sync-xyrelith-data-amazon-seller-discovery-leads",
        "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": {
          "mode": {
            "title": "Discovery mode",
            "enum": [
              "keyword",
              "category",
              "bestsellers",
              "brand",
              "asins"
            ],
            "type": "string",
            "description": "How seller leads are discovered. Keyword search, category page, best-seller list, brand search or a list of ASINs. Every mode walks the products found and reads the sellers behind their offers.",
            "default": "keyword"
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Product keywords to search on each selected marketplace. Each search is paged until the product limit is reached, then the offers behind every product are read and their sellers collected.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "categoryUrls": {
            "title": "Category or browse-node URLs",
            "type": "array",
            "description": "Amazon category pages or browse nodes, for example https://www.amazon.com/b?node=172282, https://www.amazon.com/s?rh=n%3A172282 or just 172282. A URL keeps its own marketplace.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "bestSellerUrls": {
            "title": "Best Sellers lists",
            "type": "array",
            "description": "Amazon Best Sellers pages, for example https://www.amazon.com/gp/bestsellers/electronics/ or an /zgbs/ path. The page's top-100 product ranking is read without a browser.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "Brand names to search for, or Amazon brand-store URLs. A bare brand runs on every selected marketplace.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "asins": {
            "title": "ASINs",
            "type": "array",
            "description": "Product ASINs or product URLs whose every visible offer should be scanned. A URL keeps its own marketplace; a bare ASIN runs on the selected marketplaces.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "marketplaces": {
            "title": "Marketplaces",
            "type": "array",
            "description": "Amazon stores to scan. Bare keywords, brands and ASINs run on every selected store; a pasted URL uses the store in the URL. EU stores publish the full legally required business identity (VAT, register number, phone, email).",
            "items": {
              "type": "string",
              "enum": [
                "amazon.com",
                "amazon.co.uk",
                "amazon.de",
                "amazon.fr",
                "amazon.it",
                "amazon.es",
                "amazon.ca",
                "amazon.co.jp",
                "amazon.in",
                "amazon.com.au"
              ],
              "enumTitles": [
                "United States (amazon.com)",
                "United Kingdom (amazon.co.uk)",
                "Germany (amazon.de)",
                "France (amazon.fr)",
                "Italy (amazon.it)",
                "Spain (amazon.es)",
                "Canada (amazon.ca)",
                "Japan (amazon.co.jp)",
                "India (amazon.in)",
                "Australia (amazon.com.au)"
              ]
            },
            "default": [
              "amazon.com"
            ]
          },
          "maxProducts": {
            "title": "Products to scan per input",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "How many product listings to inspect for each keyword, category, best-seller list, brand or ASIN input. Each product's offer list yields the sellers behind it.",
            "default": 10
          },
          "maxSellers": {
            "title": "Max seller leads",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Hard cap on unique seller rows emitted across the whole run, after filters. The actor keeps reading products until this many sellers pass or the inputs are exhausted.",
            "default": 50
          },
          "maxOfferPages": {
            "title": "Offer pages per product",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many pages of a product's All Offers Display to read. Each page holds up to 10 offers with their seller IDs. Two pages cover the featured offer plus 19 more.",
            "default": 2
          },
          "includeAllOffers": {
            "title": "Read every offer page",
            "type": "boolean",
            "description": "When on, each product's offer list is paged until Amazon's own reported offer count is reached, instead of stopping at the offer-page limit. Slower but finds the deepest-tail resellers.",
            "default": false
          },
          "businessCountries": {
            "title": "Only these seller countries",
            "type": "array",
            "description": "Keep only sellers whose published business address ends in one of these two-letter country codes, for example DE, GB or US. Leave empty to keep every country. A seller with no business address on Amazon is skipped when this filter is set.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "excludeBusinessCountries": {
            "title": "Exclude seller countries",
            "type": "array",
            "description": "Drop sellers whose published business address ends in one of these two-letter country codes, for example CN or HK. Many China-based sellers trade through a Hong Kong company, so list both to leave them out.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "minLifetimeRatings": {
            "title": "Minimum lifetime ratings",
            "minimum": 0,
            "maximum": 100000000,
            "type": "integer",
            "description": "Drop sellers below this lifetime rating count. Sellers Amazon shows no rating count for pass through.",
            "default": 0
          },
          "minPositivePercent": {
            "title": "Minimum 12-month positive percent",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Drop sellers below this share of positive ratings in the last 12 months, from 0 to 100. Sellers without a rating summary pass through.",
            "default": 0
          },
          "fulfillment": {
            "title": "Fulfillment filter",
            "enum": [
              "ANY",
              "FBA",
              "FBM"
            ],
            "type": "string",
            "description": "Keep only sellers with at least one discovered offer fulfilled by Amazon (FBA) or shipped by the merchant (FBM). ANY keeps everyone.",
            "default": "ANY"
          },
          "excludeAmazonRetail": {
            "title": "Exclude Amazon's own accounts",
            "type": "boolean",
            "description": "Skip offers sold by Amazon itself (Amazon.com, Amazon US, Amazon EU, Amazon Resale and similar) so every row is a third-party seller. Recommended on.",
            "default": true
          },
          "includeFeedback": {
            "title": "Include buyer feedback",
            "type": "boolean",
            "description": "Attach each seller's newest individual buyer feedback (stars, text, date, rater, whether Amazon struck it, seller reply) by paging Amazon's feedback endpoint. Adds one or more requests per seller.",
            "default": false
          },
          "maxFeedbackPerSeller": {
            "title": "Max feedback rows per seller",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "How many of the seller's newest feedback entries to attach when buyer feedback is on. Amazon serves 5 rows per request.",
            "default": 10
          },
          "proxyConfiguration": {
            "title": "Proxy configuration (optional)",
            "type": "object",
            "description": "Optional Apify Proxy override. The actor works with no setup and picks a working connection automatically when Amazon blocks a request."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}