{ "openapi": "3.0.1", "info": { "title": "eBay Product Details Scraper With Multi-Marketplace Domains", "description": "eBay Product Details Scraper extracts detailed product data across multiple eBay marketplace domains, including titles, prices, descriptions, seller info, ratings, shipping, images, item specifics, availability, and URLs for e-commerce research and competitor analysis.", "version": "0.1", "x-build-id": "wQsR797SJMaK3SiJc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~ebay-product-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-ebay-product-details-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/api-empire~ebay-product-details-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-ebay-product-details-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/api-empire~ebay-product-details-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-ebay-product-details-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": { "itemTargets": { "title": "🎯 Item numbers or listing links", "type": "array", "description": "One entry per line. A bare eBay item number (for example 276582090868) is turned into a listing link on every marketplace you tick below. A full listing link is read from its own marketplace as-is. Repeated entries are collected once, never twice.", "items": { "type": "string" } }, "urls": { "title": "🔗 Listing URLs (classic field)", "type": "array", "description": "The original listing-URL list, kept so an existing input file keeps working unchanged. Anything added here is collected together with the targets above.", "items": { "type": "string" } }, "marketplaceDomains": { "title": "🌐 Country marketplaces", "type": "array", "description": "Tick every eBay country site an item number should be read from. Pick several to collect the same item number across markets in a single run — each row is tagged with its marketplace and the currency that market quotes. Leave empty to use ebay.com only.", "items": { "type": "string", "enum": [ "ebay.com", "ebay.co.uk", "ebay.de", "ebay.com.au", "ebay.ca", "ebay.fr", "ebay.it", "ebay.es", "ebay.at", "ebay.ch", "ebay.ie", "ebay.nl", "ebay.pl", "ebay.com.sg", "ebay.com.hk", "ebay.com.my", "ebay.ph" ], "enumTitles": [ "🇺🇸 United States — ebay.com", "🇬🇧 United Kingdom — ebay.co.uk", "🇩🇪 Germany — ebay.de", "🇦🇺 Australia — ebay.com.au", "🇨🇦 Canada — ebay.ca", "🇫🇷 France — ebay.fr", "🇮🇹 Italy — ebay.it", "🇪🇸 Spain — ebay.es", "🇦🇹 Austria — ebay.at", "🇨🇭 Switzerland — ebay.ch", "🇮🇪 Ireland — ebay.ie", "🇳🇱 Netherlands — ebay.nl", "🇵🇱 Poland — ebay.pl", "🇸🇬 Singapore — ebay.com.sg", "🇭🇰 Hong Kong — ebay.com.hk", "🇲🇾 Malaysia — ebay.com.my", "🇵🇭 Philippines — ebay.ph" ] } }, "resolvePastedUrlsAcrossMarketplaces": { "title": "🔁 Also read pasted links on the ticked marketplaces", "type": "boolean", "description": "Off by default: a pasted listing link is read from its own marketplace only. Turn it on to take the item number out of every pasted link and read it on the ticked marketplaces too.", "default": false }, "includeImageSizeVariants": { "title": "🖼️ Photo links in three sizes", "type": "boolean", "description": "Adds a thumbnail (140px), medium (500px) and full (1600px) link for every photo in the listing gallery, plus the gallery photo count. Links only — no file is ever fetched or stored.", "default": true }, "includeGalleryVideo": { "title": "🎬 Gallery video links", "type": "boolean", "description": "Adds the listing's gallery video when it has one: video id, HLS and DASH stream links, poster frame and caption. Listings without a video report false, never a placeholder. Links only — no file is ever fetched or stored.", "default": true }, "proxyConfiguration": { "title": "🛡️ Connection routing", "type": "object", "description": "Leave enabled so the actor can reach every country marketplace reliably. Turning it off limits the run to a single unrouted connection." } } }, "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 } } } } } } } } } }