{ "openapi": "3.0.1", "info": { "title": "Poshmark Scraper", "description": "Scrapes Poshmark product listings from search results and seller closets. Returns each listing as a flat row with price, title, size, brand, condition, and availability. Filter by department, price range, color, and shipping before data is collected.", "version": "1.0", "x-build-id": "XB7egR0Z9CDhc7sFq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~poshmark-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-poshmark-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/parseforge~poshmark-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-poshmark-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/parseforge~poshmark-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-poshmark-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": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Keyword to search for listings (e.g. \"nike shoes\"). Used when scrapeMode is \"search\"." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 100. Paid users: Optional, max 1,000,000." }, "scrapeMode": { "title": "Scrape Mode", "enum": [ "search", "seller_closet" ], "type": "string", "description": "Search listings by keyword, or scrape all items from a seller's closet." }, "sellerUsername": { "title": "Seller Username", "type": "string", "description": "Poshmark username whose closet to scrape (e.g. \"tiffanymars000\"). Required when scrapeMode is \"seller_closet\"." }, "department": { "title": "Department", "enum": [ "", "Women", "Men", "Kids", "Home", "Electronics", "Pets", "Luxury", "Beauty & Wellness" ], "type": "string", "description": "Filter by department." }, "availability": { "title": "Availability", "enum": [ "all", "available", "available_dropping_soon", "dropping_soon", "sold_out" ], "type": "string", "description": "Filter by listing availability status." }, "condition": { "title": "Condition", "enum": [ "all", "nwt" ], "type": "string", "description": "Filter by item condition." }, "listingType": { "title": "Listing Type", "enum": [ "", "closet", "boutique" ], "type": "string", "description": "Filter by listing type: regular closet or boutique items." }, "priceMin": { "title": "Min Price ($)", "minimum": 0, "type": "integer", "description": "Minimum listing price in USD." }, "priceMax": { "title": "Max Price ($)", "minimum": 0, "type": "integer", "description": "Maximum listing price in USD." }, "shipping": { "title": "Shipping", "enum": [ "", "free", "free_discounted" ], "type": "string", "description": "Filter by shipping offer." }, "color": { "title": "Color", "type": "string", "description": "Filter by color (e.g. \"Red\", \"Black\", \"Blue\")." }, "size": { "title": "Size", "type": "string", "description": "Filter by size (e.g. \"8\", \"XL\", \"Medium\"). Depends on the selected department." }, "sortBy": { "title": "Sort By", "enum": [ "best_match", "added_desc", "price_desc", "price_asc", "price_drop", "like_count", "relevance_v2" ], "type": "string", "description": "How to sort search results." }, "includeSellerProfile": { "title": "🧑‍💼 Include seller profile", "type": "boolean", "description": "Adds a sellerProfile block to each listing: followers, following, listings count, items sold, orders shipped, 5 star rating counts, city, state, website, member since, last active date and vacation hold. One extra request per unique seller. Charged once per unique seller per run, only when the profile came back.", "default": false }, "includeEngagement": { "title": "💬 Include comments and likers", "type": "boolean", "description": "Adds the public comments on each listing (text, author, date) and the list of users who liked it (username, profile URL, date). One extra request per listing. Charged only for a row that receives at least one comment or liker.", "default": false }, "includePriceInsights": { "title": "📉 Include price insights", "type": "boolean", "description": "Adds a priceInsights block: the seller's first listed price, the change to the current price in dollars and percent, and per-size inventory (available, reserved, sold). No extra request. Charged only for a row that receives it.", "default": false } } }, "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 } } } } } } } } } }