{ "openapi": "3.0.1", "info": { "title": "Poshmark Sold Listings Scraper", "description": "Export public Poshmark sold-listing prices, brands, sizes, sellers, images and listing URLs for resale comps and pricing research.", "version": "0.1", "x-build-id": "wIWw9SY6OaUTjd6uw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~poshmark-sold-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-poshmark-sold-listings-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/fetch_cat~poshmark-sold-listings-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-poshmark-sold-listings-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/fetch_cat~poshmark-sold-listings-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-poshmark-sold-listings-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": { "query": { "title": "Search query", "type": "string", "description": "Keyword or phrase for sold listings, such as a brand, model, or item type. Supply a non-empty query or at least one startUrls or resumeUrls entry. When combined, all supplied searches are processed within the shared record limit." }, "startUrls": { "title": "Poshmark search URLs", "type": "array", "description": "Optional public Poshmark search URLs. Keep any filters you need; the actor always requests sold-out listings.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum sold listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of sold listing records to save.", "default": 50 }, "sortBy": { "title": "Sort order", "enum": [ "added_desc", "price_desc", "price_asc", "like_count_desc" ], "type": "string", "description": "Poshmark sorting parameter for the search generated from query. Does not override sorting already present in startUrls or resumeUrls and does not re-sort the combined dataset. The form default is Recently added; an API call omitting this field leaves sorting to Poshmark.", "default": "added_desc" }, "maxPages": { "title": "Maximum search pages", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum pages to request per search, from 1 to 100. Actual results per page vary; maxItems caps saved rows across all searches.", "default": 10 }, "maxRunSeconds": { "title": "Maximum run time (seconds)", "minimum": 1, "maximum": 270, "type": "integer", "description": "Processing budget from 1 to 270 seconds, including startup. A shorter platform/API timeout takes precedence, with time reserved for saving the summary. Unfinished required extraction fails truthfully while preserving saved rows and available PENDING_URLS.", "default": 270 }, "resumeUrls": { "title": "Resume search URLs", "type": "array", "description": "Optional public Poshmark search URLs from PENDING_URLS after a partial run. The actor always requests sold-out listings.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use the proxy editor to select no proxy, Apify Proxy, or your own proxy URLs. The form is prefilled with managed Apify Proxy (useApifyProxy: true), which can incur proxy usage. Direct requests can be blocked by Poshmark. Requests use the supplied configuration from the first page; there is no automatic switch after blocking. For API calls, omitting proxyConfiguration or supplying an empty object retains the SDK managed Apify Proxy behavior, which can incur proxy usage. Set useApifyProxy: false explicitly for direct requests. Custom proxyUrls and supported managed group/country settings are honored as supplied. Malformed or unsupported settings are rejected rather than converted into an automatic route." } } }, "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 } } } } } } } } } }