{ "openapi": "3.0.1", "info": { "title": "eBay Product Listing Scraper (Location, Condition & Shipping)", "description": "eBay Product Listing Scraper extracts product listings with location, condition, shipping details, prices, seller information, ratings, product titles, and listing URLs. Ideal for price comparison, marketplace research, inventory analysis, competitor monitoring, and product sourcing.", "version": "0.1", "x-build-id": "7fbrxXmBccFfdwt6e" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~ebay-product-listing-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-ebay-product-listing-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-product-listing-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-ebay-product-listing-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-product-listing-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-ebay-product-listing-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": { "searchUrls": { "title": "📍 eBay Search URLs", "type": "array", "description": "Paste one or more eBay search or category URLs. Example: search results for \"Nike shoes\", a category page, or a saved search. The filters below are applied on top of each URL.", "items": { "type": "string" } }, "urls": { "title": "🔗 eBay Search URLs (legacy field)", "type": "array", "description": "Legacy field name, kept for backward compatibility with the base eBay Product Listing Scraper. If you're setting up a new run, use 'searchUrls' above instead — this field is only read when 'searchUrls' is empty.", "items": { "type": "string" } }, "preferredLocation": { "title": "🌍 Item Location", "enum": [ "any", "domestic", "worldwide" ], "type": "string", "description": "Filter listings by item ship-from location. 'Any' leaves eBay's own default (unfiltered) results." }, "itemCondition": { "title": "🏷️ Item Condition", "type": "array", "description": "Filter listings by condition. Select one or more; leave empty for all conditions.", "items": { "type": "string", "enum": [ "new", "newOther", "certifiedRefurbished", "sellerRefurbished", "used", "forPartsNotWorking" ], "enumTitles": [ "New", "New (other)", "Certified Refurbished", "Seller Refurbished", "Used", "For parts or not working" ] } }, "priceMin": { "title": "💵 Minimum Price", "minimum": 0, "type": "integer", "description": "Only return listings priced at or above this amount (in the search page's local currency). Leave empty for no minimum." }, "priceMax": { "title": "💰 Maximum Price", "minimum": 0, "type": "integer", "description": "Only return listings priced at or below this amount (in the search page's local currency). Leave empty for no maximum." }, "sortBy": { "title": "↕️ Sort Order", "enum": [ "bestMatch", "priceLowest", "priceHighest", "newlyListed" ], "type": "string", "description": "How eBay should order the search results before they're scraped." }, "proxyConfiguration": { "title": "🌐 Proxy Settings", "type": "object", "description": "Optional Apify proxy settings. Default: no proxy; the actor falls back automatically if needed." } } }, "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 } } } } } } } } } }