{ "openapi": "3.0.1", "info": { "title": "eBay & Mercari Sold Listings Scraper — Comps & Deal Sniper", "description": "Scrape eBay & Mercari sold listings and completed sale prices by keyword or URL. Returns true realized sold prices (Accepted Best Offers), IQR spread, sell-through rate, 13.25% fee net flip profit, and Webhook/Telegram underpriced deal alerts. Pure HTTP, $0.0025/comp on Bronze+.", "version": "1.0", "x-build-id": "rpM5JdgH2KT6D6cHd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cea_digital~ebay-sold-listings-comps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cea_digital-ebay-sold-listings-comps-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/cea_digital~ebay-sold-listings-comps-scraper/runs": { "post": { "operationId": "runs-sync-cea_digital-ebay-sold-listings-comps-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/cea_digital~ebay-sold-listings-comps-scraper/run-sync": { "post": { "operationId": "run-sync-cea_digital-ebay-sold-listings-comps-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": { "fbMarketplaceDatasetId": { "title": "1-Click Chained Dataset ID (Facebook Marketplace / Craigslist)", "type": "string", "description": "Paste a Dataset ID from apify/facebook-marketplace-scraper to automatically compute eBay/Mercari sold comps and net flip profit for every local listing." }, "ebaySearchUrl": { "title": "Direct eBay / Mercari Search URL (Optional)", "type": "string", "description": "Optional direct eBay or Mercari search URL to extract sold comps from." }, "keywords": { "title": "Product Keywords / Model Numbers / SKUs", "type": "array", "description": "List of exact product titles, SKUs, or model numbers to price-check. Leave empty to run the 6-second instant live demo.", "default": [], "items": { "type": "string" } }, "condition": { "title": "Item Condition Filter", "enum": [ "any", "new", "used", "for_parts" ], "type": "string", "description": "Filter completed sold comps by item condition so for-parts listings never skew used/new medians.", "default": "used" }, "filterDealers": { "title": "Exclude Commercial Bulk Dealers & Accessories Spam", "type": "boolean", "description": "Automatically strip replacement boxes, cables-only spam, and commercial drop-shippers from median comp math.", "default": true }, "monitorMode": { "title": "Enable Real-Time Underpriced Deal Sniper Mode", "type": "boolean", "description": "When enabled, checks active Buy-It-Now listings against 30-day median sold prices and fires instant Webhook/Telegram alerts on underpriced deals.", "default": false }, "underpricedThresholdPct": { "title": "Underpriced Alert Threshold (% Below 30-Day Median Sold Price)", "type": "number", "description": "Trigger an underpriced-deal-alert when an active Buy-It-Now listing is at least this percentage below the 30-day median realized sold price.", "default": 25 }, "webhookUrl": { "title": "Real-Time Deal Sniper Webhook URL", "type": "string", "description": "Optional HTTP POST webhook URL triggered when an underpriced deal is found." }, "telegramChatId": { "title": "Telegram Deal Sniper Chat ID", "type": "string", "description": "Optional Telegram Chat ID for instant mobile deal alerts." }, "watchlistId": { "title": "Recurring Watchlist ID (KV Deduplication)", "type": "string", "description": "Set a Watchlist ID when running on an hourly/5-minute Schedule so previously evaluated listings are never billed twice." }, "onlyNew": { "title": "Only Evaluate Net-New Listings", "type": "boolean", "description": "When paired with watchlistId, skips any SKU/listing already processed in previous runs ($0.00 charged on duplicates).", "default": true }, "feedback": { "title": "Request a Custom Marketplace or Fee Schedule", "type": "string", "description": "Need StockX, Goat, Chrono24, or Reverb fee calculators? Let us know here." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }