{
  "openapi": "3.0.1",
  "info": {
    "title": "Poshmark Scraper - Listings, Sold Prices, Closets & Sellers",
    "description": "Scrape Poshmark US and Canada: search, brand, category and closet listings or sold listings with price, original and first price, sold date, days to sell, size, brand, condition, likes, description and photos. Seller profiles, comments, monitor mode. $0.90 per 1,000 listings.",
    "version": "0.1",
    "x-build-id": "N7B5ihRoOMrnqS1ks"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~poshmark-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-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/topapi~poshmark-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-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/topapi~poshmark-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-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": {
          "searchQueries": {
            "title": "Search words",
            "type": "array",
            "description": "Words to search on Poshmark, one search per line (e.g. \"coach bag\", \"lululemon align 6\"). Each search is read with the filters below.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Poshmark links or listing ids",
            "type": "array",
            "description": "Poshmark search, brand, category or closet page links (filters in the link are kept), listing links, or 24-character listing ids. poshmark.com and poshmark.ca.",
            "items": {
              "type": "string"
            }
          },
          "sellerUsernames": {
            "title": "Seller closets",
            "type": "array",
            "description": "Poshmark usernames (or closet links) whose closets to read.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country",
            "enum": [
              "us",
              "ca"
            ],
            "type": "string",
            "description": "Poshmark site for search words and usernames: us (poshmark.com, USD) or ca (poshmark.ca, CAD). Links keep their own site.",
            "default": "us"
          },
          "availability": {
            "title": "Availability",
            "enum": [
              "available",
              "sold_out",
              "all"
            ],
            "type": "string",
            "description": "Available listings, sold listings (sold price, sold date, days to sell) or both.",
            "default": "available"
          },
          "department": {
            "title": "Department",
            "enum": [
              "all",
              "women",
              "men",
              "kids",
              "home",
              "pets",
              "electronics"
            ],
            "type": "string",
            "description": "Poshmark department.",
            "default": "all"
          },
          "category": {
            "title": "Category",
            "type": "string",
            "description": "Category as Poshmark names it, e.g. \"Shoes\", \"Bags\", \"Pants & Jumpsuits\" (needs a department; Women when none is set)."
          },
          "subcategory": {
            "title": "Subcategory",
            "type": "string",
            "description": "Subcategory inside the category, e.g. \"Sneakers\", \"Shoulder Bags\"."
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "One or more brands as Poshmark names them, e.g. \"Nike\", \"Free People\".",
            "items": {
              "type": "string"
            }
          },
          "sizes": {
            "title": "Sizes",
            "type": "array",
            "description": "Sizes as Poshmark shows them, e.g. \"M\", \"10\", \"8.5\".",
            "items": {
              "type": "string"
            }
          },
          "colors": {
            "title": "Colors",
            "type": "array",
            "description": "Colors, e.g. \"Black\", \"Red\", \"Cream\".",
            "items": {
              "type": "string"
            }
          },
          "condition": {
            "title": "Condition",
            "enum": [
              "all",
              "nwt",
              "like_new",
              "good",
              "fair",
              "used",
              "boutique",
              "nwt_and_boutique"
            ],
            "type": "string",
            "description": "Any condition, new with tags, like new, good, fair, any used grade, boutique (retail) listings, or new with tags plus boutique.",
            "default": "all"
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest price in the site's currency."
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "integer",
            "description": "Highest price in the site's currency."
          },
          "shipping": {
            "title": "Shipping offer",
            "enum": [
              "all",
              "free",
              "discounted"
            ],
            "type": "string",
            "description": "Only listings with free shipping, or with discounted shipping.",
            "default": "all"
          },
          "sellerType": {
            "title": "Sellers",
            "enum": [
              "all",
              "posh_ambassador"
            ],
            "type": "string",
            "description": "All sellers or Posh Ambassadors only.",
            "default": "all"
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "best_match",
              "added_desc",
              "price_asc",
              "price_desc",
              "like_count",
              "price_drop"
            ],
            "type": "string",
            "description": "Order of the results: relevance, just in (newest listed first), price low to high or high to low, most likes, biggest price drop.",
            "default": "best_match"
          },
          "maxItems": {
            "title": "Maximum listings",
            "minimum": 0,
            "type": "integer",
            "description": "Listings to save across all searches, links and sellers. 0 = no limit.",
            "default": 50
          },
          "maxItemsPerSearch": {
            "title": "Maximum listings per search",
            "minimum": 0,
            "type": "integer",
            "description": "Listings to save from each search, link or closet. 0 = no per-search limit.",
            "default": 0
          },
          "includeSellerProfile": {
            "title": "Add the seller's profile ($0.0018 per seller)",
            "type": "boolean",
            "description": "Adds the seller's followers, following, listings, items sold, orders shipped, average ship time, love notes, joined date, last active, city, state, bio and Posh Ambassador flag to every row. Charged once per seller per run.",
            "default": false
          },
          "includeComments": {
            "title": "Add the listing's comments ($0.0018 per listing with comments)",
            "type": "boolean",
            "description": "Adds every comment (text, date, username, name, by the seller or not) read from the listing's public page. Charged only for listings that have comments.",
            "default": false
          },
          "includeSimilarResults": {
            "title": "Include similar results",
            "type": "boolean",
            "description": "When a search runs out of exact matches, Poshmark fills the page with loosely related listings. They are left out unless this is on (matchType tells them apart).",
            "default": false
          },
          "excludePlaceholders": {
            "title": "Leave out placeholder listings",
            "type": "boolean",
            "description": "Leave out live-show flyers, giveaway notices, \"unlisted inventory\" and do-not-buy placeholders, and listings priced $9,999 or more.",
            "default": true
          },
          "collapseCopies": {
            "title": "One row per copied listing",
            "type": "boolean",
            "description": "Sellers copy a listing to relist the same item; keep only the first copy found (copyOfListingId names the original).",
            "default": false
          },
          "listedWithinDays": {
            "title": "Listed within (days)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only listings first published within this many days. 0 = off.",
            "default": 0
          },
          "soldWithinDays": {
            "title": "Sold within (days)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only listings sold within this many days (use with Availability: Sold). 0 = off.",
            "default": 0
          },
          "splitLargeSearches": {
            "title": "Read past 5,000 results",
            "type": "boolean",
            "description": "Poshmark shows about 5,000 listings per search. When on, a larger search is split into price ranges so every listing can be read, up to Maximum listings.",
            "default": true
          },
          "monitorMode": {
            "title": "Monitor mode (only new or changed listings)",
            "type": "boolean",
            "description": "Each run delivers only listings that are new since the last run with the same input, listings whose price changed, and listings whose status changed (e.g. sold). Unchanged listings are not delivered or charged.",
            "default": false
          },
          "emitPriceChanges": {
            "title": "Monitor: deliver price changes",
            "type": "boolean",
            "description": "Deliver a listing again when its price changed since it was delivered (changeType price-changed, previousSeenPrice).",
            "default": true
          },
          "emitStatusChanges": {
            "title": "Monitor: deliver status changes",
            "type": "boolean",
            "description": "Deliver a listing again when its status changed, e.g. it sold (changeType status-changed, previousSeenStatus).",
            "default": true
          },
          "monitorStoreName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Keeps separate monitor memories for the same input (e.g. one per schedule)."
          },
          "resetMonitor": {
            "title": "Reset the monitor",
            "type": "boolean",
            "description": "Forget what earlier runs delivered and start again.",
            "default": false
          },
          "maxPages": {
            "title": "Maximum pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "Stop each search after this many result pages (up to 150 listings each). 0 = no limit.",
            "default": 0
          },
          "maxRunSeconds": {
            "title": "Maximum run time (seconds)",
            "minimum": 0,
            "type": "integer",
            "description": "Stop cleanly after this many seconds with the rows read so far. 0 = no limit.",
            "default": 0
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Not needed: the actor reads Poshmark directly and moves to Apify datacenter, then residential proxy only if Poshmark refuses a request. Set your own proxy here if you prefer.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}