{ "openapi": "3.0.1", "info": { "title": "Poshmark Listings & Sold Comps Scraper", "description": "Search Poshmark by keyword for active listings or sold comps in one actor. Sold results carry the final sale price and the sold date, the resale comps Poshmark does not expose anywhere else. Returns price, original price, condition, brand, size, colors, category, seller and engagement counts.", "version": "0.1", "x-build-id": "X6hTWbMhaEJs7eXW7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cirkit~poshmark-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cirkit-poshmark-search-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/cirkit~poshmark-search-scraper/runs": { "post": { "operationId": "runs-sync-cirkit-poshmark-search-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/cirkit~poshmark-search-scraper/run-sync": { "post": { "operationId": "run-sync-cirkit-poshmark-search-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", "required": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Search terms", "minItems": 1, "type": "array", "description": "Keywords to search Poshmark for, one search per entry. Use the same wording you would type into the Poshmark search box, for example \"nike air max 90\" or \"lululemon align leggings\".", "default": [ "nike air max" ], "items": { "type": "string" } }, "inventoryStatus": { "title": "Listing status", "enum": [ "active", "sold" ], "type": "string", "description": "Choose \"active\" for listings currently for sale, or \"sold\" for completed sales. Sold results carry the final sale price and the date it sold, which is the comps data used to price an item before listing it.", "default": "active" }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on the number of listings written to the dataset, counted across all search terms. Must be 1 or more. Poshmark caps any single search at 5,000 results.", "default": 200 }, "department": { "title": "Department", "enum": [ "All", "Women", "Men", "Kids", "Home", "Pets", "Electronics" ], "type": "string", "description": "Restrict the search to one Poshmark department. Applied by Poshmark itself, so it does not cost extra requests.", "default": "All" }, "sortBy": { "title": "Sort by", "enum": [ "best_match", "added_desc", "price_asc", "price_desc" ], "type": "string", "description": "Result ordering. Use \"added_desc\" to watch new listings as they appear, or \"price_asc\" to find the cheapest first. Poshmark's own index order is returned as-is, so \"added_desc\" tracks the published date closely but is not a strict sort on it.", "default": "best_match" }, "brands": { "title": "Brands", "type": "array", "description": "Keep only listings whose brand exactly matches one of these, case insensitive. Poshmark has no brand filter on this endpoint, so the actor applies it after fetching. Leave empty for no brand filter.", "default": [], "items": { "type": "string" } }, "minPrice": { "title": "Minimum price (USD)", "minimum": 0, "type": "integer", "description": "Keep only listings at or above this price. Poshmark ignores price bounds on this endpoint, so the actor applies them after fetching. Very narrow ranges make a run fetch more pages for fewer results." }, "maxPrice": { "title": "Maximum price (USD)", "minimum": 0, "type": "integer", "description": "Keep only listings at or below this price. Applied by the actor after fetching, same as the minimum." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings. The default datacenter proxy is sufficient and is what the cost model assumes. Poshmark throttles a single IP after roughly a dozen requests, so the actor rotates sessions automatically. Residential proxies are not required.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }