{ "openapi": "3.0.1", "info": { "title": "eBay Price Tracker", "description": "Track live eBay prices for any keyword search. Returns every active listing with its price, shipping, condition, seller and format, and flags every price drop, price rise, new listing and disappearance since your last run.", "version": "0.1", "x-build-id": "Jtvg0BZfNEpPESp5g" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arched_friend~ebay-price-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arched_friend-ebay-price-tracker", "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/arched_friend~ebay-price-tracker/runs": { "post": { "operationId": "runs-sync-arched_friend-ebay-price-tracker", "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/arched_friend~ebay-price-tracker/run-sync": { "post": { "operationId": "run-sync-arched_friend-ebay-price-tracker", "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", "required": [ "keywords" ], "properties": { "keywords": { "title": "Search terms", "type": "array", "description": "What to search for on eBay, one per line. Each term is tracked separately across runs.", "items": { "type": "string" } }, "site": { "title": "eBay site", "enum": [ "US", "UK", "DE", "FR", "IT", "ES", "CA", "AU", "IE", "NL", "PL" ], "type": "string", "description": "Which eBay site to search. The proxy exit country is pinned to match, so prices come back in that site's currency.", "default": "US" }, "maxListingsPerKeyword": { "title": "Listings per search", "minimum": 1, "maximum": 240, "type": "integer", "description": "Upper limit on how many listings to keep for each search term.", "default": 60 }, "sort": { "title": "Sort order", "enum": [ "best", "price-low", "price-high", "newest" ], "type": "string", "description": "How eBay should order the results before they are read.", "default": "best" }, "condition": { "title": "Item condition", "enum": [ "any", "new", "used" ], "type": "string", "description": "Restrict the search to new or used items before it runs.", "default": "any" }, "buyItNowOnly": { "title": "Buy It Now only", "type": "boolean", "description": "Exclude auctions and return only fixed-price listings.", "default": false }, "onlyChanged": { "title": "Only what changed since last run", "type": "boolean", "description": "Return only price drops, price rises and new listings. Turn this on for scheduled monitoring so each run is a short alert list.", "default": false }, "reportDisappeared": { "title": "Report listings that ended or sold", "type": "boolean", "description": "Include a row for every listing that was present last run and is gone now, which on eBay usually means it sold.", "default": true }, "minPrice": { "title": "Minimum total price", "minimum": 0, "type": "integer", "description": "Keep only listings at or above this price including postage. 0 means no minimum.", "default": 0 }, "maxPrice": { "title": "Maximum total price", "minimum": 0, "type": "integer", "description": "Keep only listings at or below this price including postage. 0 means no maximum.", "default": 0 }, "freeShippingOnly": { "title": "Free shipping only", "type": "boolean", "description": "Keep only listings that ship free.", "default": false }, "conditions": { "title": "Keep only these conditions", "type": "array", "description": "Keep only listings matching these conditions, for example new, used, refurbished, open-box or for-parts.", "items": { "type": "string" } }, "formats": { "title": "Keep only these formats", "type": "array", "description": "Keep only listings matching these formats: auction, buy-it-now or best-offer.", "items": { "type": "string" } }, "titleExcludes": { "title": "Exclude titles containing", "type": "array", "description": "Drop any listing whose title contains one of these words. Useful for filtering out replicas, cases and accessories.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "eBay challenges datacentre IPs, so this defaults to Apify residential proxy pinned to the site's country.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "timeBudgetSecs": { "title": "Time budget (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "How long the run may spend searching before it returns what it has. eBay rate limits in bursts, so this stops a challenged keyword from stretching the run. Raise it for long keyword lists.", "default": 240 } } }, "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 } } } } } } } } } }