{ "openapi": "3.0.1", "info": { "title": "Poshmark Listings Scraper", "description": "Scrape public Poshmark listings using search phrases or supported search, brand, and category URLs. Results include titles, brands, sizes, asking prices, seller names, likes, comments, and image URLs. Embedded page data provides listing records without a separate request for every item.", "version": "1.0", "x-build-id": "6hc9rOQssB0Mfb7Wu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axiomworks~poshmark-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axiomworks-poshmark-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/axiomworks~poshmark-listings-scraper/runs": { "post": { "operationId": "runs-sync-axiomworks-poshmark-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/axiomworks~poshmark-listings-scraper/run-sync": { "post": { "operationId": "run-sync-axiomworks-poshmark-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": { "searchQueries": { "title": "Poshmark search phrases, e.g. nike hoodie", "type": "array", "description": "Search phrases as a string array, e.g. [\"nike hoodie\"]. Supply searchQueries, startUrls, or both; there is no automatic target for API calls. Default availability is sold. Targets run in order and share maxItems. Empty or blocked targets save no error rows; try a broader phrase or another public URL.", "items": { "type": "string" } }, "startUrls": { "title": "Poshmark search, brand or category URLs", "type": "array", "description": "Public HTTPS Poshmark search, brand or category URLs, e.g. [{\"url\":\"https://poshmark.com/brand/Levis\"}]. Use URL objects in schema-validated calls. Supply this or searchQueries. Listing-detail URLs and listing IDs are unsupported. Availability overrides the URL availability; non-empty input filters override matching URL filters.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "availability": { "title": "Listing availability: sold, active or all", "enum": [ "sold", "active", "all" ], "type": "string", "description": "Choose \"sold\" (default) for sold_out listings, \"active\" for listings not marked sold_out, or \"all\" for both. With all, sold listings get the first half of the remaining maxItems budget before active listings. Example: \"active\" for current asking prices.", "default": "sold" }, "brand": { "title": "Brand filter, e.g. Nike", "type": "string", "description": "Brand text sent to Poshmark search, e.g. \"Nike\". Default \"\" adds no brand filter and retains an existing URL brand parameter. A non-empty value overrides it. Filtering depends on Poshmark support; check returned brand values.", "default": "" }, "size": { "title": "Size filter, e.g. L", "type": "string", "description": "Size text sent to Poshmark search, e.g. \"L\" or \"8\". Default \"\" adds no size filter and retains an existing URL size parameter. A non-empty value overrides it. Size labels vary by category; check returned size values.", "default": "" }, "department": { "title": "Department filter, e.g. Men", "enum": [ "", "Women", "Men", "Kids", "Home", "Pets", "Electronics" ], "type": "string", "description": "Choose \"Women\", \"Men\", \"Kids\", \"Home\", \"Pets\", or \"Electronics\", e.g. \"Men\". Default \"\" adds no department filter and retains a URL department parameter. A non-empty choice overrides it. Department filtering depends on Poshmark search support.", "default": "" }, "minPrice": { "title": "Minimum listing price in USD, e.g. 20", "type": "number", "description": "Optional non-negative minimum listed price in USD, e.g. 20. Omit for no additional lower bound. Inclusive: listings below this value are excluded. Must be no greater than maxPrice when both are supplied. This is the public listed price, not a verified sale payment." }, "maxPrice": { "title": "Maximum listing price in USD, e.g. 100", "type": "number", "description": "Optional non-negative maximum listed price in USD, e.g. 100. Omit for no additional upper bound. Inclusive: listings above this value are excluded. Must be at least minPrice when both are supplied. Tight price bounds can return zero records." }, "maxItems": { "title": "Maximum unique listings across all targets", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum unique listings saved across all searchQueries and startUrls combined, 1-5000, default 50; e.g. 20 for a small sample or 1 for one result. Fewer are returned if matching pages run out, targets remain blocked, or the run reaches its spending limit. Duplicate IDs do not use the budget.", "default": 50 }, "proxyConfiguration": { "title": "Apify Proxy settings, e.g. RESIDENTIAL", "type": "object", "description": "Proxy settings for Poshmark requests, e.g. {\"useApifyProxy\":true,\"apifyProxyGroups\":[\"RESIDENTIAL\"]} (the existing default). Blocked or rate-limited requests retry with backoff on fresh proxy sessions. For direct local testing use {\"useApifyProxy\":false}; persistent blocks save no error records.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }