{ "openapi": "3.0.1", "info": { "title": "eBay Seller Scraper By Keyword & Marketplace Search", "description": "πŸ›’ eBay Seller Scraper extracts seller profiles, store info, active listings, prices, ratings & feedback. πŸ“Š Ideal for competitor analysis, pricing, product research & lead gen. ⚑ Fast, reliable; export CSV/JSON for analytics & automation.", "version": "0.1", "x-build-id": "wdZ3PzMKdVvqtoijp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~ebay-seller-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-ebay-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/scrapier~ebay-seller-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-ebay-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/scrapier~ebay-seller-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-ebay-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": { "searchQueries": { "title": "πŸ” Keyword / Category Search Terms", "type": "array", "description": "πŸ“‹ **Discover NEW sellers by niche** β€” one search term per line (e.g. \"vintage camera\", \"nike sneakers\", \"pokemon cards\"). For each term, the actor searches the chosen marketplace, hops to each matching item page once to resolve the real seller, then scrapes that seller's storefront. Leave empty to skip discovery and only use the profile URLs below.", "items": { "type": "string" } }, "marketplaceDomain": { "title": "🌐 eBay Marketplace / Country Site", "enum": [ "ebay.com", "ebay.co.uk", "ebay.de", "ebay.fr", "ebay.it", "ebay.es", "ebay.ca", "ebay.com.au", "ebay.at", "ebay.ie", "ebay.nl", "ebay.pl", "ebay.ch", "ebay.com.hk", "ebay.com.my", "ebay.com.sg", "ebay.ph" ], "type": "string", "description": "πŸ—ΊοΈ **Which eBay locale to search/scrape on.** Applies to keyword discovery and to bare usernames entered below. Full seller profile URLs keep their own domain automatically." }, "maxSellersPerQuery": { "title": "πŸ”’ Max Sellers to Discover per Search Term", "minimum": 1, "type": "integer", "description": "🚦 Caps how many unique sellers get resolved (and then scraped) per search term, via the one-hop item-page lookup. Keeps discovery runs fast and predictable." }, "maxSearchResultPages": { "title": "πŸ“„ Search Result Pages per Term", "minimum": 1, "type": "integer", "description": "πŸ“š How many pages of search results to scan per search term when looking for sellers to discover. Increase this if a niche keyword needs a deeper scan to find enough distinct sellers." }, "sellerProfileUrls": { "title": "πŸ”— Known Seller Profile URLs (optional)", "type": "array", "description": "πŸ“‹ **Already know sellers?** One per line β€” a full profile URL (e.g. `https://www.ebay.co.uk/usr/your_seller_name`, any of the 16 supported marketplaces) or a bare username (uses the marketplace selected above). Works together with, or instead of, keyword discovery above.\n\n(Backward compatible: the base actor's `urls` input key is still accepted if you're reusing an old input JSON.)", "items": { "type": "string" } }, "proxyConfiguration": { "title": "πŸ›‘οΈ Proxy & connection (optional)", "type": "object", "description": "🌐 **You can skip this section** β€” the actor works out of the box.\n\nIf you open this block:\n- βœ… Choose **No proxy** for normal runs, **or**\n- βœ… Turn on **Apify Proxy** and pick a group (Datacenter / Residential), **or**\n- βœ… Add your own proxy URLs under **Own proxies**.\n\n⚠️ **Do not** select **Own proxies** and leave it empty β€” Apify will show a validation error. Pick **No proxy** instead." } } }, "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 } } } } } } } } } }