{
  "openapi": "3.0.1",
  "info": {
    "title": "eBay Business Leads Scraper",
    "description": "Find registered business sellers on eBay by keyword, category or seller and export the legal details eBay displays: company, address, email, phone, VAT ID and register number. 12 marketplaces, incl. ebay.com.",
    "version": "0.1",
    "x-build-id": "eaZ1i0jOqmmgGHDC6"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/epicscrapers~ebay-business-leads-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-epicscrapers-ebay-business-leads-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/epicscrapers~ebay-business-leads-scraper/runs": {
      "post": {
        "operationId": "runs-sync-epicscrapers-ebay-business-leads-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/epicscrapers~ebay-business-leads-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-epicscrapers-ebay-business-leads-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": {
          "marketplaces": {
            "title": "eBay marketplaces",
            "type": "array",
            "description": "Select the eBay sites for keyword and category searches. Seller usernames without a URL use the first selected site. Every site returns company names, addresses, email addresses, phone numbers, and VAT IDs when the seller provides them.",
            "items": {
              "type": "string",
              "enum": [
                "ebay.de",
                "ebay.co.uk",
                "ebay.fr",
                "ebay.it",
                "ebay.es",
                "ebay.nl",
                "ebay.at",
                "ebay.ie",
                "ebay.pl",
                "ebay.com",
                "ebay.ca",
                "ebay.com.au"
              ],
              "enumTitles": [
                "ebay.de 🇩🇪",
                "ebay.co.uk 🇬🇧",
                "ebay.fr 🇫🇷",
                "ebay.it 🇮🇹",
                "ebay.es 🇪🇸",
                "ebay.nl 🇳🇱",
                "ebay.at 🇦🇹",
                "ebay.ie 🇮🇪",
                "ebay.pl 🇵🇱",
                "ebay.com 🇺🇸",
                "ebay.ca 🇨🇦",
                "ebay.com.au 🇦🇺"
              ]
            },
            "default": [
              "ebay.com"
            ]
          },
          "queries": {
            "title": "Keywords",
            "type": "array",
            "description": "Enter search terms. The Actor searches each selected site for each term. It checks sellers from the search results until a limit is reached.",
            "items": {
              "type": "string"
            }
          },
          "categoryIds": {
            "title": "Category IDs",
            "type": "array",
            "description": "Enter eBay category IDs to search without keywords. For example, use 16191 for ink cartridges on ebay.de. Find the ID after _sacat= in an eBay search URL. The Actor searches each category on each selected site.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "eBay search or category URLs",
            "type": "array",
            "description": "Enter eBay search URLs (/sch/i.html?_nkw=...) or category URLs (/b/.../bn_...) from a supported site. You can include filters in the URLs. Each URL sets the search site. The selected sites do not change it.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "sellers": {
            "title": "Sellers",
            "type": "array",
            "description": "Enter seller usernames, profile URLs (/usr/name), store URLs (/str/name), or search URLs with _ssn=name. Each URL sets the eBay site. Usernames without a URL use the first selected site. The Actor checks these sellers before it starts the other searches.",
            "items": {
              "type": "string"
            }
          },
          "searchBusinessSellersOnly": {
            "title": "Search business sellers only",
            "type": "boolean",
            "description": "Add the eBay business seller filter (LH_SellerType=2) to searches on EU and UK sites that do not already specify a seller type filter. This reduces private seller results. On ebay.com, ebay.ca, and ebay.com.au the filter is never added, because it hides most US sellers there. Private sellers are still skipped and never saved.",
            "default": true
          },
          "maxSellers": {
            "title": "Maximum business sellers",
            "minimum": 1,
            "type": "integer",
            "description": "Set the maximum number of business seller results to save. The run stops when it reaches this limit. Each seller on each eBay site is a separate result.",
            "default": 100
          },
          "maxListingsToScan": {
            "title": "Maximum listings to scan per search",
            "minimum": 1,
            "type": "integer",
            "description": "Set the maximum number of listings to read for each search. This limit applies separately to each keyword, category, or URL search on each site. A seller can have more than one listing.",
            "default": 1000
          },
          "countries": {
            "title": "Business countries",
            "type": "array",
            "description": "Save only sellers with a business address in these countries. Enter two-letter ISO country codes, such as DE, AT, or GB (English names such as Germany also work). The Actor then searches only items located in each country, so most sellers it checks match. Leave this field empty to remove the country filter.",
            "items": {
              "type": "string"
            }
          },
          "minFeedbackScore": {
            "title": "Minimum feedback score",
            "minimum": 0,
            "type": "integer",
            "description": "Set the minimum eBay feedback score. Do not save sellers with a lower score.",
            "default": 0
          },
          "requireEmail": {
            "title": "Only sellers with an email address",
            "type": "boolean",
            "description": "Save only business sellers with an email address shown by eBay.",
            "default": false
          },
          "requirePhone": {
            "title": "Only sellers with a phone number",
            "type": "boolean",
            "description": "Save only business sellers with a phone number shown by eBay.",
            "default": false
          },
          "skipSellersWithoutBusinessInfo": {
            "title": "Skip business sellers without legal details",
            "type": "boolean",
            "description": "Do not save business sellers if eBay shows none of these details: company name, address, email address, phone number, VAT ID, or register number.",
            "default": true
          },
          "includeStoreDetails": {
            "title": "Add eBay Store page details",
            "type": "boolean",
            "description": "Read the seller's eBay Store web page. Add the number of items sold, followers, seller location, and business details shown only on that page. This adds one request per store and increases run time. This option is off by default.",
            "default": false
          },
          "includePrivateSellerCount": {
            "title": "Count skipped private sellers",
            "type": "boolean",
            "description": "Show the number of private sellers that the Actor did not process in the run summary and status message.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}