{ "openapi": "3.0.1", "info": { "title": "eBay Resale Research — Seller Feedback Prices", "description": "Collect prices displayed with verified purchases on selected public eBay seller feedback pages. Filter item titles and get source links plus separate price summaries for each eBay listing and currency. Feedback samples are not complete sales history.", "version": "0.1", "x-build-id": "OfGMdMmU1AM0uLyGT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/agency-shift~ebay-resale-research/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-agency-shift-ebay-resale-research", "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/agency-shift~ebay-resale-research/runs": { "post": { "operationId": "runs-sync-agency-shift-ebay-resale-research", "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/agency-shift~ebay-resale-research/run-sync": { "post": { "operationId": "run-sync-agency-shift-ebay-resale-research", "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": [ "sellerUsernames" ], "properties": { "sellerUsernames": { "title": "eBay seller usernames", "minItems": 1, "maxItems": 10, "type": "array", "description": "Enter 1–10 public seller usernames, one per line. Use usernames only, not URLs or account credentials. Sellers are processed in this order; a run-wide result or spending limit can leave later sellers unprocessed.", "items": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,63}$" } }, "query": { "title": "Words required in the item title", "maxLength": 150, "type": "string", "description": "Optional title filter, up to 150 characters. Every word must occur as a complete word in the normalized title; matching ignores case and punctuation. Leave empty to include all usable observations from the selected sellers. This does not search eBay for additional sellers or listings.", "default": "" }, "excludeKeywords": { "title": "Exclude title words or phrases", "maxItems": 30, "type": "array", "description": "Optional list of up to 30 words or phrases, each at most 80 characters. A title containing any complete normalized phrase is excluded. Use terms such as case, charger or parts only when those items are unwanted in your research.", "items": { "type": "string", "minLength": 1, "maxLength": 80 }, "default": [] }, "maxResults": { "title": "Maximum price observations", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Run-wide maximum of 1–1,000 delivered observations, also limited by your spending cap. Separate verified feedback purchases for the same item can each produce a record. Available matching feedback can be much smaller than this limit.", "default": 100 }, "maxPagesPerSeller": { "title": "Maximum feedback pages per seller", "minimum": 1, "maximum": 10, "type": "integer", "description": "Read up to 1–10 accessible public feedback pages for each selected seller. This is a ceiling, not a promised page or observation count. The scan stops when no further supported feedback is available or a result/spending limit is reached.", "default": 3 }, "minSampleSize": { "title": "Small-sample flag threshold", "minimum": 1, "maximum": 100, "type": "integer", "description": "Mark a listing-level analytics group lowSample when fewer than this number of usable observations are present. Does not filter observations or suppress small groups. A larger sample is not a guarantee of price accuracy or representative market coverage.", "default": 5 } } }, "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 } } } } } } } } } }