{ "openapi": "3.0.1", "info": { "title": "eBay Scraper - SOLD Listings, Prices & Seller Data", "description": "Extract active listings, feedback-confirmed SOLD records and seller profiles from eBay. Get prices, shipping costs, watchers, item details, photos and reviews. Compare price ranges, flag query mismatches and export structured data to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "AV7zjnpjzCT4LYmdQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trakk~ebay-seller-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trakk-ebay-seller-intelligence", "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/trakk~ebay-seller-intelligence/runs": { "post": { "operationId": "runs-sync-trakk-ebay-seller-intelligence", "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/trakk~ebay-seller-intelligence/run-sync": { "post": { "operationId": "run-sync-trakk-ebay-seller-intelligence", "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": { "mode": { "title": "🎯 What to scrape", "enum": [ "KEYWORD_SEARCH", "SELLER_INTELLIGENCE", "ITEM_DETAILS" ], "type": "string", "description": "Use Keyword search for live products and prices. Use Seller intelligence when you already have sellers, stores, item URLs, or an input dataset.", "default": "KEYWORD_SEARCH" }, "keywords": { "title": "🔤 Search keywords", "type": "array", "description": "One literal search phrase per entry. Empty input is rejected before source requests; separate comma-separated phrases into separate entries if desired.", "default": [], "items": { "type": "string" } }, "listingType": { "title": "🏷️ Listing type", "enum": [ "ACTIVE", "SOLD" ], "type": "string", "description": "Choose live active listings or recent public SOLD transactions confirmed by eBay as verified purchases. SOLD needs no login or session export and reports its one-month sample coverage in every result.", "default": "ACTIVE" }, "count": { "title": "🔢 Max listings per keyword", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum successfully saved new listings per keyword. Already saved duplicates and failed writes do not consume the allowance. Source availability and page/charge limits can return fewer.", "default": 50 }, "ebaySite": { "title": "🌍 eBay marketplace", "enum": [ "EBAY_US", "EBAY_UK", "EBAY_DE", "EBAY_FR", "EBAY_IT", "EBAY_ES", "EBAY_CA", "EBAY_AU", "EBAY_IE", "EBAY_NL" ], "type": "string", "description": "Marketplace to search. Source currency is preserved. Canadian public searches encountered access verification in current checks; inspect OUTPUT for availability.", "default": "EBAY_US" }, "category": { "title": "🗂️ Category ID", "minimum": 0, "type": "integer", "description": "Optional eBay category number. Leave empty for all categories. In SOLD mode this guides seller discovery; it is not claimed as a verified field on each transaction." }, "sortOrder": { "title": "↕️ Sort order", "enum": [ "endedRecently", "newlyListed", "endingSoonest", "priceLowest", "priceHighest", "bestMatch" ], "type": "string", "description": "Sort order for eBay search results.", "default": "bestMatch" }, "minPrice": { "title": "💵 Minimum price", "minimum": 0, "type": "integer", "description": "Lower price bound in the marketplace currency." }, "maxPrice": { "title": "💸 Maximum price", "minimum": 0, "type": "integer", "description": "Upper price bound in the marketplace currency." }, "condition": { "title": "✨ Condition", "enum": [ "ANY", "NEW", "NEW_OTHER", "MANUFACTURER_REFURBISHED", "SELLER_REFURBISHED", "USED", "FOR_PARTS_NOT_WORKING" ], "type": "string", "description": "Optional item condition filter. In SOLD mode this guides seller discovery because the public transaction evidence does not publish condition.", "default": "ANY" }, "itemLocation": { "title": "📍 Item location", "enum": [ "DEFAULT", "LOCAL_COUNTRY", "WORLDWIDE" ], "type": "string", "description": "Where listed items should be located. In SOLD mode this guides seller discovery rather than asserting a location on each transaction.", "default": "DEFAULT" }, "detailedSearch": { "title": "🔬 Fetch full item details", "type": "boolean", "description": "Fetch item pages for available current item-page prices, gallery images, seller information and product rating summaries. Search prices remain available in separate fields; no extra detail requests run when disabled.", "default": false }, "includeProductPhotos": { "title": "🖼️ Add product photos", "type": "boolean", "description": "Adds the main product photo to listing rows. With full item details enabled, also saves extra image URLs when eBay exposes them.", "default": true }, "includeSellerReviewsFromSearch": { "title": "⭐ Add seller reviews from search results", "type": "boolean", "description": "After keyword search, saves seller feedback reviews for sellers found in listing cards. Faster and cheaper than opening every item page.", "default": false }, "profileUrls": { "title": "👤 Seller, store, or item URLs", "type": "array", "description": "Paste eBay profile URLs, feedback URLs, store URLs, seller search URLs, or item URLs. Used in Seller intelligence mode.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "usernames": { "title": "🧑 Seller usernames", "type": "array", "description": "Optional raw eBay usernames such as musicmagpie. URLs are usually safer because they can be resolved automatically.", "default": [], "items": { "type": "string" } }, "datasetId": { "title": "🗃️ Input dataset ID", "type": "string", "description": "Optional Apify dataset ID containing seller-like fields such as seller, sellerName, sellerUsername, username, profileUrl, or url." }, "includeActiveListings": { "title": "🟢 Add active-listings summary", "type": "boolean", "description": "Adds active listing count and a small sample to seller intelligence rows.", "default": true }, "includeRecentFeedback": { "title": "⭐ Add seller feedback reviews", "type": "boolean", "description": "Includes recent seller feedback samples when available.", "default": true }, "saveReviewRows": { "title": "📝 Save reviews as separate rows", "type": "boolean", "description": "Creates one dataset row per seller feedback review, so review text is visible in the Reviews output tab.", "default": true }, "maxReviewRowsPerSeller": { "title": "🔢 Max review rows per seller", "minimum": 0, "maximum": 100, "type": "integer", "description": "Maximum seller feedback reviews to save as separate rows for each seller.", "default": 25 }, "sampleListings": { "title": "🎚️ Seller sample size", "minimum": 0, "maximum": 60, "type": "integer", "description": "How many active sample listings to keep on seller intelligence rows.", "default": 10 }, "minFeedbackScore": { "title": "📈 Minimum feedback score", "minimum": 0, "type": "integer", "description": "Keep sellers with at least this lifetime feedback score." }, "minPositivePercent": { "title": "👍 Minimum positive feedback %", "minimum": 0, "maximum": 100, "type": "integer", "description": "Keep sellers at or above this positive feedback percentage." }, "countries": { "title": "🌐 Seller countries", "type": "array", "description": "Country allow-list. Accepts ISO codes or full names. Empty means any country.", "default": [], "items": { "type": "string" } }, "mustBeTopRated": { "title": "🏅 Only Top Rated sellers", "type": "boolean", "description": "Keep only sellers with the Top Rated badge.", "default": false }, "mustHaveStore": { "title": "🏬 Only sellers with a store", "type": "boolean", "description": "Keep only sellers with an eBay Store.", "default": false }, "mustBeBusinessSeller": { "title": "💼 Only business sellers", "type": "boolean", "description": "Keep only registered business sellers.", "default": false }, "minMonthlyGmvEstimate": { "title": "💹 Minimum monthly GMV estimate", "minimum": 0, "type": "integer", "description": "Keep sellers above this estimated monthly GMV in the marketplace currency." }, "minActiveListings": { "title": "📦 Minimum active listings", "minimum": 0, "type": "integer", "description": "Keep sellers with at least this many active listings." }, "tiers": { "title": "🎖️ Allowed seller tiers", "uniqueItems": true, "type": "array", "description": "Optional tier allow-list. Example: MEGA, ENTERPRISE, POWER, PRO.", "default": [], "items": { "type": "string" } }, "maxConcurrency": { "title": "⚡ Max concurrency", "minimum": 1, "maximum": 30, "type": "integer", "description": "Maximum parallel seller workflows. Keyword search pagination stays sequential per keyword.", "default": 3 }, "maxRetries": { "title": "🔁 Max retries", "minimum": 0, "maximum": 15, "type": "integer", "description": "Retry budget for temporary HTTP errors.", "default": 2 }, "rawOutput": { "title": "🐛 Include raw debug fields", "type": "boolean", "description": "Includes selected raw HTML/debug fields. Use only when debugging.", "default": false }, "proxy": { "title": "🌐 Connection settings", "type": "object", "description": "Apify AUTO proxy is enabled for reliable request-only runs. Choose Residential only when you specifically need a country-pinned route.", "default": { "useApifyProxy": true } }, "maxPagesPerSearch": { "title": "Maximum pages per keyword", "minimum": 1, "maximum": 42, "type": "integer", "description": "Safety cap on eBay pages per keyword. OUTPUT distinguishes this cap from source exhaustion.", "default": 42 }, "itemUrls": { "title": "Item URLs", "type": "array", "description": "Direct eBay item pages for Item details mode. Each requested item uses one listing event.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "itemIds": { "title": "Item IDs", "type": "array", "description": "eBay item numbers. The selected marketplace supplies the item URL.", "default": [], "items": { "type": "string" } } } }, "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 } } } } } } } } } }