{ "openapi": "3.0.1", "info": { "title": "eBay Sold Listings + Seller Intelligence (10 marketplaces)", "description": "Two modes in one actor. SELLER: paste any eBay URL (/usr/, /str/, /itm/), get a JSON record with feedback, DSR, 90-day GMV, sell-through, repeat-buyer ratio, tier. KEYWORD: paste phrases, get sold/active listings with prices. 10 marketplaces, multilingual, pay-per-event ($5-15/1k).", "version": "0.1", "x-build-id": "C1OvUDcRXJKIQDnjf" }, "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": "Mode", "enum": [ "SELLER_INTELLIGENCE", "KEYWORD_SEARCH" ], "type": "string", "description": "SELLER_INTELLIGENCE: profile/feedback/GMV intelligence per seller (default). KEYWORD_SEARCH: paginated /sch/i.html search by keyword + filters (active or sold listings).", "default": "SELLER_INTELLIGENCE" }, "keywords": { "title": "Search keywords", "type": "array", "description": "Product / brand / model names to search for. Each phrase becomes a separate /sch/i.html query on the chosen eBay site. Used in KEYWORD_SEARCH mode.", "default": [], "items": { "type": "string" } }, "listingType": { "title": "Listing type", "enum": [ "SOLD", "ACTIVE", "COMPLETED" ], "type": "string", "description": "Which listings to fetch. SOLD: completed orders in the last ~90 days (default - best for price research). ACTIVE: currently live listings. COMPLETED: ended (sold OR unsold).", "default": "SOLD" }, "daysToScrape": { "title": "Days to scrape", "minimum": 1, "maximum": 90, "type": "integer", "description": "How many days back to scan (only for SOLD/COMPLETED). Sold dates older than this cutoff are skipped. Max 90 (eBay's hard cap).", "default": 30 }, "count": { "title": "Max listings per keyword", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper bound on items pulled per keyword. Pagination stops when this count is reached or eBay runs out of results.", "default": 100 }, "category": { "title": "Category ID (optional)", "minimum": 0, "type": "integer", "description": "eBay category number ID (e.g. 58058 = Computers/Tablets/Networking, 6000 = eBay Motors, 11450 = Clothing). Empty/0 = All Categories." }, "sortOrder": { "title": "Sort order", "enum": [ "endedRecently", "newlyListed", "endingSoonest", "priceLowest", "priceHighest", "bestMatch" ], "type": "string", "description": "eBay's _sop sort parameter.", "default": "endedRecently" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Lower bound on listing price (in the marketplace's currency). Empty = no lower bound." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Upper bound on listing price. Empty = no upper bound." }, "itemLocation": { "title": "Item location", "enum": [ "DEFAULT", "LOCAL_COUNTRY", "WORLDWIDE" ], "type": "string", "description": "Where the item is located. DEFAULT respects the marketplace's natural setting; LOCAL_COUNTRY restricts to the marketplace's country; WORLDWIDE allows any.", "default": "DEFAULT" }, "condition": { "title": "Condition", "enum": [ "ANY", "NEW", "NEW_OTHER", "MANUFACTURER_REFURBISHED", "SELLER_REFURBISHED", "USED", "FOR_PARTS_NOT_WORKING" ], "type": "string", "description": "Item-condition filter. ANY = no filter.", "default": "ANY" }, "detailedSearch": { "title": "Detailed search (visit item pages)", "type": "boolean", "description": "When enabled, also fetch each /itm/{ID} page for full description, item specifics, and seller info. Roughly doubles per-listing cost and latency.", "default": false }, "profileUrls": { "title": "Seller URLs", "type": "array", "description": "Paste any eBay URL pointing to the seller - actor auto-resolves to the seller's username. Supported forms: profile (/usr/{user}, /fdbk/feedback_profile/{user}), store (/str/{slug}, stores.ebay.com/{slug}), search-by-seller (/sch/i.html?_ssn={user}, /sch/{user}/m.html), or ANY item listing (/itm/{ID} - actor fetches the page and pulls the seller from its JSON payload).", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "usernames": { "title": "Seller usernames (advanced - prefer URLs above)", "type": "array", "description": "Optional raw username slugs (e.g. \"musicmagpie\"). For most cases prefer the URL field above - it auto-resolves any eBay URL form. Display names with spaces are normalised lowercase + no-spaces (best-effort).", "default": [], "items": { "type": "string" } }, "datasetId": { "title": "Input Dataset ID", "type": "string", "description": "Optional Apify dataset id (e.g. from a previous eBay listings scraper run). Items are expected to expose a `seller`, `sellerName`, `sellerUsername`, `username`, or `profileUrl` field." }, "ebaySite": { "title": "eBay site", "enum": [ "EBAY_US", "EBAY_UK", "EBAY_DE", "EBAY_FR", "EBAY_IT", "EBAY_ES", "EBAY_CA", "EBAY_AU", "EBAY_IE", "EBAY_NL" ], "type": "string", "description": "Which eBay marketplace to query. Affects the feedback / listings / sold URLs and the assumed currency.", "default": "EBAY_US" }, "includeActiveListings": { "title": "Include active-listings summary", "type": "boolean", "description": "Fetch /sch/i.html?_ssn={user} to extract total active listings count and a sample of titles/prices/conditions. Disabling skips that request and shrinks runtime by ~30%.", "default": true }, "includeSoldListings": { "title": "Include 90-day sold summary (GMV estimate)", "type": "boolean", "description": "Fetch /sch/i.html?_ssn={user}&LH_Sold=1&LH_Complete=1 to extract sold count and prices for GMV / velocity / sell-through estimates. The 90-day window is set by eBay.", "default": true }, "includeRecentFeedback": { "title": "Include recent feedback comments", "type": "boolean", "description": "Include the 25 most recent feedback comments (buyer pseudonym, price, item id, comment, date bucket) on the output. Always pulled to compute the repeat-buyer ratio - disabling only suppresses the array.", "default": true }, "sampleListings": { "title": "Listing sample size per page", "minimum": 0, "maximum": 60, "type": "integer", "description": "How many active / sold listings to keep in the sample arrays (titles, prices, conditions). Doesn't affect the count totals or GMV estimate. 0 → no sample.", "default": 25 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many sellers to process in parallel. Each seller fans out to up to 3 internal HTTP requests; effective HTTP concurrency is roughly 3× this number.", "default": 5 }, "maxRetries": { "title": "Max retries per URL", "minimum": 0, "maximum": 15, "type": "integer", "description": "Retries on 403/429/5xx and bot-block pages (in addition to dedicated proxy/captcha retry budgets).", "default": 5 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy configuration. US residential proxies are the default and strongly recommended - eBay aggressively blocks datacenter ASNs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "rawOutput": { "title": "Include raw HTML in output", "type": "boolean", "description": "If enabled, each item also contains the raw HTML of the feedback profile page under `_raw.feedbackHtml`. Heavy - only useful for debugging.", "default": false }, "minFeedbackScore": { "title": "Filter - minimum lifetime feedback score", "minimum": 0, "type": "integer", "description": "Drop sellers with a lifetime feedback score below this threshold. Common values: 100 (drop hobbyists), 1000 (drop small sellers), 10 000 (drop everyone but power sellers)." }, "minPositivePercent": { "title": "Filter - minimum positive feedback %", "minimum": 0, "maximum": 100, "type": "integer", "description": "Drop sellers below this positive-feedback percentage (12-month). Common values: 95, 98, 99." }, "countries": { "title": "Filter - countries (allow-list)", "type": "array", "description": "Only push sellers registered in one of these countries. Accepts ISO codes (\"US\", \"UK\", \"DE\") and full names (\"United Kingdom\", \"Germany\"). Empty = no country filter.", "default": [], "items": { "type": "string" } }, "mustBeTopRated": { "title": "Filter - only Top-Rated sellers", "type": "boolean", "description": "When true, drop everyone without the Top Rated Seller badge.", "default": false }, "mustHaveStore": { "title": "Filter - only sellers with an eBay Store", "type": "boolean", "description": "When true, drop everyone without an eBay Store subscription.", "default": false }, "mustBeBusinessSeller": { "title": "Filter - only registered business sellers", "type": "boolean", "description": "When true, drop personal/individual sellers and keep only sellers registered as businesses.", "default": false }, "minMonthlyGmvEstimate": { "title": "Filter - minimum monthly GMV estimate", "minimum": 0, "type": "integer", "description": "Drop sellers below this estimated monthly GMV in the marketplace currency. Requires sold-listings collection to be enabled." }, "minActiveListings": { "title": "Filter - minimum active listings", "minimum": 0, "type": "integer", "description": "Drop sellers with fewer active listings than this. Requires active-listings collection to be enabled." }, "minSoldLast90Days": { "title": "Filter - minimum sales in last 90 days", "minimum": 0, "type": "integer", "description": "Drop dormant sellers below this sold-90-days count. Requires sold-listings collection to be enabled." }, "tiers": { "title": "Filter - allowed seller tiers", "uniqueItems": true, "type": "array", "description": "Only push sellers whose computed tier is in this list. Empty = no tier filter.", "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 } } } } } } } } } }