{
"openapi": "3.0.1",
"info": {
"title": "Poshmark Scraper - Listings, Sold Comps & Seller Leads",
"description": "Scrape Poshmark listings with brand, size, condition, price + original price, photos & engagement, plus real sold comps (sold price & days-to-sell), full seller closets, and rich seller leads with followers, ratings, website & linked Instagram. Monitoring mode. JSON, CSV, Excel.",
"version": "0.1",
"x-build-id": "BM26Uz9ZaQrHAfTke"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~poshmark-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~poshmark-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-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/scrapesage~poshmark-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-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": {
"mode": {
"title": "What to scrape",
"enum": [
"search",
"soldComps",
"closet",
"sellers",
"itemDetail"
],
"type": "string",
"description": "Search = live listings for sale (the default). Sold comps = recently SOLD listings with final price & days-to-sell (the data Poshmark hides — pricing gold for resellers). Closet = every listing in a seller's closet. Seller leads = rich seller profiles with followers, ratings, website & socials. Item detail = full data for specific listings.",
"default": "search"
},
"searchQueries": {
"title": "Search queries",
"type": "array",
"description": "Keywords to search on Poshmark, e.g. nike air force 1, lululemon align leggings, coach bag, vintage levis. Each query is combined with the filters below. Leave empty to browse purely by filters (e.g. all Nike in Women under $50). Used in Search, Sold comps and Seller-leads modes.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "Paste Poshmark URLs directly: listing pages (poshmark.com/listing/...), closet pages (poshmark.com/closet/<username>), or search URLs (poshmark.com/search?query=...). Used in addition to the inputs above.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"sellerUsernames": {
"title": "Seller usernames",
"type": "array",
"description": "Poshmark usernames for Closet and Seller leads modes, e.g. thriftqueen. You can paste a full closet URL too — the username is extracted.",
"items": {
"type": "string"
}
},
"listingIds": {
"title": "Listing IDs",
"type": "array",
"description": "Specific Poshmark listing IDs (the 24-character hex id at the end of a listing URL) for Item detail mode.",
"items": {
"type": "string"
}
},
"brand": {
"title": "Brand",
"type": "string",
"description": "Filter by brand, e.g. Nike, Lululemon, Coach, Zara, Free People."
},
"department": {
"title": "Department",
"enum": [
"All",
"Women",
"Men",
"Kids",
"Home",
"Pets",
"Electronics"
],
"type": "string",
"description": "Top-level Poshmark department.",
"default": "All"
},
"color": {
"title": "Color",
"type": "string",
"description": "Filter by color, e.g. Black, White, Red, Blue, Green."
},
"priceMin": {
"title": "Min price (USD)",
"minimum": 0,
"type": "integer",
"description": "Only listings at or above this price."
},
"priceMax": {
"title": "Max price (USD)",
"minimum": 0,
"type": "integer",
"description": "Only listings at or below this price."
},
"conditionFilter": {
"title": "Condition",
"enum": [
"any",
"nwt",
"used"
],
"type": "string",
"description": "Keep only listings of this condition (applied to results).",
"default": "any"
},
"sortBy": {
"title": "Sort order",
"enum": [
"relevance",
"newest",
"price_low",
"price_high",
"most_liked",
"just_shared"
],
"type": "string",
"description": "How to order search results.",
"default": "relevance"
},
"enrichSellerLeads": {
"title": "Also emit seller-lead records",
"type": "boolean",
"description": "In Search / Sold comps / Closet modes, also push one deduplicated seller-lead record (type = \"seller\") for every unique seller found — with followers, items sold, ratings, website and linked socials.",
"default": false
},
"crawlSellerWebsites": {
"title": "Crawl seller websites for emails & phones",
"type": "boolean",
"description": "For seller leads that list a personal website, fetch it (home + contact page) and extract emails, phone numbers. Adds a few requests per seller with a website.",
"default": false
},
"maxResults": {
"title": "Max listings",
"minimum": 1,
"type": "integer",
"description": "Maximum number of listings (or sold comps) to scrape across all queries. Poshmark returns up to ~5,000 results per search — use several focused queries to go deeper.",
"default": 200
},
"maxSellers": {
"title": "Max seller leads",
"minimum": 1,
"type": "integer",
"description": "Maximum number of seller-lead profiles to fetch (Seller-leads mode, or when \"emit seller-lead records\" is on).",
"default": 200
},
"deduplicateResults": {
"title": "Deduplicate within a run",
"type": "boolean",
"description": "Skip records already emitted in this run (recommended).",
"default": true
},
"monitorMode": {
"title": "Monitoring mode — only new records",
"type": "boolean",
"description": "Remember ids across runs in a named key-value store and emit ONLY records not seen before (new listings, new sold comps, new sellers). Perfect for deal alerts and price-watching. Works with Apify Schedules.",
"default": false
},
"monitorKey": {
"title": "Monitor key",
"type": "string",
"description": "Names the memory used by monitoring mode. Use a distinct key per saved search so different watches don't share state.",
"default": "default"
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 16,
"type": "integer",
"description": "Maximum parallel requests. 6–10 is a good balance.",
"default": 6
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy settings. The default Apify Proxy (datacenter) works well with Poshmark.",
"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
}
}
}
}
}
}
}
}
}
}