{ "openapi": "3.0.1", "info": { "title": "Poshmark Listings Scraper - Search, Sold Items & Closets", "description": "Scrapes Poshmark (poshmark.com) listings by keyword, brand, category, seller closet or link. Sold and available items with prices, original price, discount, sold date, brand, size, condition, photos, likes, seller details and comments. Filters, cache for new items only.", "version": "1.0", "x-build-id": "tT9vmxWR0ciJZHW90" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/confidential_gnat~poshmark-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-confidential_gnat-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/confidential_gnat~poshmark-listings-scraper/runs": { "post": { "operationId": "runs-sync-confidential_gnat-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/confidential_gnat~poshmark-listings-scraper/run-sync": { "post": { "operationId": "run-sync-confidential_gnat-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": { "startUrls": { "title": "Poshmark URLs", "type": "array", "description": "Search pages (https://poshmark.com/search?query=nike&type=listings), brand pages, category pages, seller closets (https://poshmark.com/closet/username) or single listings. Filters in the URL are kept; the filter fields below replace them when filled in.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQueries": { "title": "Search keywords", "type": "array", "description": "Keywords to search, one per entry, for example a brand or product name. The filters below apply to each of them.", "items": { "type": "string" } }, "sellers": { "title": "Seller usernames", "type": "array", "description": "Poshmark usernames whose closet to scrape, for example prettyflowers1.", "items": { "type": "string" } }, "cacheProjectName": { "title": "Cache project name", "type": "string", "description": "Use the same name on each scheduled run to get only new or changed listings. Listings already saved under this name with the same price and status are skipped, not charged and not counted towards Max items. Each record gets a changeType: new or updated." }, "maxItems": { "title": "Max items per input", "minimum": 1, "type": "integer", "description": "Maximum listings saved for each URL, keyword or seller. Poshmark shows about 5,000 listings for one search; above that the actor splits the search by department, price and color automatically to collect more.", "default": 5 }, "scrapeDetails": { "title": "Scrape full details", "type": "boolean", "description": "Also open each listing to add shipping cost, the comments, who liked it and the seller profile (followers, items sold, location, member since). Slower, a few extra requests per listing.", "default": true }, "availability": { "title": "Listing status", "enum": [ "available", "sold_out" ], "type": "string", "description": "Available listings still for sale, or sold listings (with the sold date). Pasted URLs that already carry a status keep it unless you pick sold here.", "default": "available" }, "department": { "title": "Department", "enum": [ "Women", "Men", "Kids", "Home", "Pets", "Electronics" ], "type": "string", "description": "Narrow the search to one department." }, "category": { "title": "Category", "type": "string", "description": "Poshmark category name, used together with a department, for example Tops, Shoes, Dresses or Bags." }, "brand": { "title": "Brand", "type": "string", "description": "Brand name exactly as Poshmark writes it, for example Nike or lululemon athletica." }, "sizes": { "title": "Sizes", "type": "array", "description": "Sizes to keep, for example M, 8 or XL. Which sizes exist depends on the department.", "items": { "type": "string" } }, "colors": { "title": "Colors", "type": "array", "description": "Colors to keep, for example Black or Red (Poshmark color names).", "items": { "type": "string" } }, "condition": { "title": "Condition", "enum": [ "all", "nwt" ], "type": "string", "description": "All conditions, or only items that are new with tags.", "default": "all" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Lowest price in whole dollars." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Highest price in whole dollars." }, "sortBy": { "title": "Sort by", "enum": [ "best_match", "added_desc", "price_asc", "price_desc", "like_count", "price_drop" ], "type": "string", "description": "Order of the results. Newest first combines well with the cache to pick up only new listings.", "default": "best_match" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Datacenter proxies are enough for Poshmark and used by default. Turn Apify Proxy off only if you run from an address Poshmark does not block.", "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 }, "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 } } } } } } } } } }