{ "openapi": "3.0.1", "info": { "title": "Poshmark Listings Scraper", "description": "Scrape public Poshmark browse and listing pages for resale sourcing, price research, and market analysis. Returns prices, brands, sizes, images, availability, engagement, timestamps, and public seller handles. Not for private accounts or contact harvesting. $0.018/listing plus platform usage.", "version": "1.1", "x-build-id": "GBE2wnCQd0XxOaqES" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~poshmark-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-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/khadinakbar~poshmark-listings-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-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/khadinakbar~poshmark-listings-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-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": { "searchQuery": { "title": "Search keyword", "minLength": 1, "maxLength": 200, "type": "string", "description": "Enter a product or brand phrase such as 'nike running shoes' or 'lululemon jacket'. The actor converts it to a public Poshmark browse URL and never calls the disallowed /search or /api paths. Defaults to 'nike shoes' for a working sample. This field is ignored when startUrls contains one or more URLs.", "default": "nike shoes" }, "startUrls": { "title": "Public Poshmark URLs", "maxItems": 50, "type": "array", "description": "Add public URLs whose path starts with /browse/, /brand/, /category/, or /listing/. For example, use a browse URL to retain Poshmark filters or a listing URL to extract one exact item. When provided, these URLs take precedence over searchQuery. Closet, profile, search, API, message, and non-Poshmark URLs are rejected.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Maximum listings", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap for complete validated listings saved and billed across the run. For example, set 10 for a low-cost proof run or 100 for broader assortment research. Defaults to 25 and cannot exceed 500. This is not a page-count or concurrency setting.", "default": 25 }, "includeDetails": { "title": "Enrich listing details", "type": "boolean", "description": "Open each public listing page before saving it to refresh price, inventory, images, engagement, and timestamps. Enable this for the richest and most current record or disable it for faster browse-page snapshots. Defaults to true. This never opens seller closets, private pages, or account endpoints.", "default": true }, "availability": { "title": "Availability filter", "enum": [ "available", "sold", "all" ], "type": "string", "description": "Choose whether to return available listings, sold listings, or both. 'Available' is useful for live sourcing, while 'Sold' supports comparable-sales research. Defaults to available. The actor also verifies the item-level inventory status before saving each record.", "default": "available" }, "department": { "title": "Poshmark department", "enum": [ "Women", "Men", "Kids", "Home", "Electronics", "Pets" ], "type": "string", "description": "Select the public Poshmark department for keyword-generated browse pages. An explicit department is required for Poshmark's server-rendered availability filter, including sold-comparable runs. Defaults to Women; choose Men, Kids, Home, Electronics, or Pets when relevant. Existing startUrls retain their own department parameters.", "default": "Women" }, "sortBy": { "title": "Browse sort order", "enum": [ "relevance_v2", "added_desc", "price_asc", "price_desc", "price_drop", "like_count" ], "type": "string", "description": "Select how keyword-generated browse results should be ordered on Poshmark. Use newest for monitoring, low or high price for range research, or most liked for demand signals. Defaults to relevance. Existing startUrls retain their own URL parameters unless pagination updates the page token.", "default": "relevance_v2" }, "maxConcurrency": { "title": "Maximum concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Control how many public Poshmark requests can run in parallel. Lower values are gentler and can reduce intermittent blocks; higher values are faster for larger detail runs. Defaults to 3 and maxes at 5, while a separate global rate limit still applies. This does not change maxResults or billing.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Configure the network route used for public Poshmark pages. The default uses Apify Residential proxy in the United States for steadier access. Supply a custom proxy only when you need to control egress or proxy billing. Disabling the proxy can increase blocking on cloud runs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }