{ "openapi": "3.0.1", "info": { "title": "eBay Seller Scraper ā€” Full Listings, Specifics & Shipping", "description": "eBay Seller Scraper ā€” Full Listings, Specifics & Shipping extracts seller listings, product specifics, prices, SKUs, item condition, shipping details, seller information, ratings, and listing URLs. Ideal for product research, seller analysis, price monitoring, and competitor insights.", "version": "0.1", "x-build-id": "4CMd4dmFndMWM5pRK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~ebay-seller-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-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/scrapio~ebay-seller-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-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/scrapio~ebay-seller-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-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": { "sellerProfileLinks": { "title": "šŸ”— Seller Profile Links", "type": "array", "description": "šŸ“‹ **Add your targets here.** One eBay seller profile URL per line ā€” supports a single seller or a whole list for bulk runs.\n\nāœ… Example format: `https://www.ebay.co.uk/usr/your_seller_name`\n\n(Backward compatible: the base actor's `urls` input key is also accepted if you're reusing an old input JSON.)", "items": { "type": "string" } }, "fetchFullItemDetails": { "title": "šŸ”Ž Fetch Full Item Details Per Listing", "type": "boolean", "description": "When ON, the actor opens EACH listing's own item page (one extra GET per listing) to collect condition, shipping, delivery, returns, item specifics, full description, full image gallery, and item number. Turn OFF for a faster run that only harvests the listing-card fields (title, price, deep link, condition, image, discount %, shipping text) with zero extra requests." }, "maxListingsToEnrichPerSeller": { "title": "šŸ”¢ Max Listings To Enrich Per Seller", "minimum": 0, "type": "integer", "description": "Caps how many listings per seller get the full item-detail GET (above). Keeps runs fast and predictable on sellers with hundreds of items. 0 = enrich every listing found (can be slow for very large sellers)." }, "fetchAllListingPages": { "title": "šŸ“„ Fetch All Listing Pages (Full Inventory)", "type": "boolean", "description": "When ON, the actor pages through a seller's FULL listing catalog (`_pgn=2,3,4ā€¦`) until no more results appear, instead of stopping at page 1. Turn OFF to scrape only the first page (matches the original base actor's behaviour)." }, "maxPagesPerSeller": { "title": "šŸ“š Max Pages Per Seller", "minimum": 0, "type": "integer", "description": "Safety cap on how many listing pages to fetch per seller when 'Fetch All Listing Pages' is ON. 0 = no explicit cap (an internal safety limit of 50 pages still applies so a run can never loop forever)." }, "proxyConfiguration": { "title": "šŸ›”ļø Proxy & connection (optional)", "type": "object", "description": "šŸŒ **You can skip this section** ā€” the actor works with seller URLs only.\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 } } } } } } } } } }