{ "openapi": "3.0.1", "info": { "title": "eBay Business Seller Leads — Emails, VAT & Company Numbers", "description": "Verified business-seller contacts from eBay's EU/UK marketplaces — company name, email, phone, VAT number, company registration number and registered address. One row per seller, $0.02 each.", "version": "0.3", "x-build-id": "yvIWbwlzbhQPYTedJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/programmx~ebay-business-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-programmx-ebay-business-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/programmx~ebay-business-leads/runs": { "post": { "operationId": "runs-sync-programmx-ebay-business-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/programmx~ebay-business-leads/run-sync": { "post": { "operationId": "run-sync-programmx-ebay-business-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", "required": [ "domains" ], "properties": { "keywords": { "title": "Search keywords", "type": "array", "description": "What the sellers you want are selling — e.g. 'car parts', 'vintage watches', 'pet supplies'. Each keyword is searched on each selected domain with eBay's business-seller filter applied, then the legally-mandated trader block (name, email, phone, VAT, address) is pulled from each seller. One keyword per niche you want to prospect.", "items": { "type": "string" } }, "startUrls": { "title": "eBay search / category URLs (advanced)", "type": "array", "description": "Optional alternative to keywords. Apply any filters you like on eBay itself (category, condition, price, item location), then paste the resulting URL here — the actor inherits every filter in the URL. Tip: add &LH_SellerType=2 to restrict the search to business sellers.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "domains": { "title": "eBay domains", "minItems": 1, "type": "array", "description": "Which marketplaces to search. Every keyword is searched on every domain you pick, so two domains cost roughly twice as much as one — start with one. Only EU/UK domains are offered: the trader block is an EU/UK legal requirement and ebay.com (US) does not carry it.", "items": { "type": "string", "enum": [ "ebay.co.uk", "ebay.de", "ebay.fr", "ebay.it", "ebay.es", "ebay.ie", "ebay.at", "ebay.nl", "ebay.pl" ], "enumTitles": [ "United Kingdom (ebay.co.uk)", "Germany (ebay.de)", "France (ebay.fr)", "Italy (ebay.it)", "Spain (ebay.es)", "Ireland (ebay.ie)", "Austria (ebay.at)", "Netherlands (ebay.nl)", "Poland (ebay.pl)" ] }, "default": [ "ebay.co.uk" ] }, "sellerCountries": { "title": "Seller countries (optional)", "type": "array", "description": "ISO country codes, e.g. GB, DE, FR. Leave empty for sellers anywhere. Worth setting: a large share of business sellers on a European marketplace are registered overseas (a typical ebay.co.uk search returns roughly half Chinese exporters), so 'UK marketplace' does not mean 'UK company'. This filters on the seller's own registered country from their trader block. Sellers outside your list are discarded and never billed.", "items": { "type": "string" } }, "requireEmail": { "title": "Only return sellers with an email address", "type": "boolean", "description": "On (recommended): sellers whose trader block publishes no email address are discarded and never billed — you only pay for contactable leads. Turn off to also receive sellers where only a phone number, VAT ID or postal address was published.", "default": true }, "mode": { "title": "Run mode", "enum": [ "full", "monitor" ], "type": "string", "description": "Monitor mode returns only business sellers this saved task has not seen before. Save the task and schedule it (daily/weekly) to get a recurring feed of newly-discovered sellers in your niche.", "default": "full" }, "maxSellers": { "title": "Max unique sellers", "minimum": 1, "type": "integer", "description": "Hard cap on unique business sellers returned — and the only thing you are billed for. Billing is per unique seller, never per listing or per page. Start small to check the data quality for your niche, then raise it.", "default": 100 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is used by default and is required — eBay's bot protection blocks unproxied traffic. Leave this as-is unless you have a specific reason to change it.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } }