ScavioScavio
Pricing
Tools
Sign InsGet Startedg
Quick StartAPI & SDKsEcosystem

Poshmark

Poshmark Category API

One Poshmark category's listings in a market (us: USD, ca: CAD): department (required), category and subcategory as slugs or names from categories, answered with the department, category and subcategory Poshmark matched, then 48 listings per page with price, the original price the seller entered, size, brand, condition, colours, likes and seller username, plus facet counts. availability available (default), sold or all; seven sorts; brand, size, condition, colour and price filters. A category path Poshmark does not know is a charged 404 (Poshmark itself would fall back to the department). Costs 1 credit.

POST/api/v1/poshmark/category

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json
departmentenum<string>required

Department: Women, Men, Kids, Home, Pets, Electronics.

Example: Women

categorystring

Category slug or name from categories (Bags, Pants_&_Jumpsuits).

Example: Bags

subcategorystring

Subcategory slug or name from categories (Totes, Leggings). Needs category.

Example: Totes

countrystringdefault:us

The market: us (poshmark.com, USD) or ca (poshmark.ca, CAD). Results are that market's own listings in its currency. Any other value answers 400, not charged.

Example: ca

pageintegerdefault:1

Page, 1 to 105, 48 listings each (about 5,000 reachable per query). Sold listings stop at page 10.

Example: 2

availabilityenum<string>default:available

Which listings: available, sold or all. Sold pages stop at 10 (480 listings).

Example: sold

  • available — Listings for sale. The default.
  • sold — Sold listings, with sold_at. Up to 480 per query and filter combination.
  • all — Available and sold together.
sortenum<string>default:relevance

Result order.

Example: price_asc

  • relevance — Poshmark's default order.
  • just_shared — Recently shared listings first.
  • just_in — Newest listed first.
  • price_asc — Price low to high.
  • price_desc — Price high to low.
  • price_drop — Recently price-dropped listings first.
  • most_liked — Most liked first.
brandstring | string[]

Brand names as Poshmark writes them (items[].brand, brands, suggestions), one or up to 10.

Example: ["Coach"]

sizestring | string[]

Sizes as Poshmark writes them (items[].size: 10, M, OS), up to 10.

Example: ["10"]

conditionenum<string>

One condition. Each mapping was measured: every result carried the condition asked.

Example: new_with_tags

  • new_with_tags — New with tags (Poshmark NWT).
  • new_with_tags_or_boutique — New with tags or Boutique.
  • boutique — Boutique retail listings.
  • like_new — Like new.
  • good — Good.
  • fair — Fair.
colorstring | string[]

Colours, up to 5: Red, Pink, Orange, Yellow, Green, Blue, Purple, Gold, Silver, Black, Gray, White, Cream, Brown, Tan.

Example: ["Black"]

price_minnumber

Lowest price, whole units of the market's currency.

Example: 20

price_maxnumber

Highest price, whole units of the market's currency.

Example: 80

Notes

Markets. country is the market: us (poshmark.com, USD, default) or ca (poshmark.ca, CAD). Results are that market's own listings in its currency. Both storefronts are English (Poshmark Canada has no French storefront). Any other country answers 400 before anything is charged (Poshmark closed its Australia and India marketplaces).

countryMarketCurrencyLanguageCredits
usUnited States (poshmark.com)USDEnglish1
caCanada (poshmark.ca)CADEnglish1

Request

from statistics import median
from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key", timeout=180)

# Available vs sold in one category: 1 credit each.
for availability in ["available", "sold"]:
    data = client.poshmark.category(department="Women", category="Bags", subcategory="Totes",
                                    brand="Coach", availability=availability)["data"]
    prices = [i["price"]["amount"] for i in data["items"]]
    print(availability, data["count"], "listings, median", median(prices) if prices else None)

Response

"market": "us",
"currency": "USD",
"department": "Women",
"category": "Bags",
"subcategory": null,
"sort": "relevance",
"availability": "available",
"page": 1,
"page_size": 48,
"total": 5000,
"has_more": true,
"count": 48,
},
"response_time": 2994
}
PreviousPoshmark ProductNextPoshmark Brand
ScavioScavio

One scraper API for every social, search, e-commerce and real estate platform. Built for AI agents.

Product

  • Features
  • Pricing
  • Dashboard
  • Affiliates

Developers

  • Documentation
  • API Reference
  • Quickstart
  • MCP Integration
  • Python SDK

Alternatives

  • Tavily Alternative
  • SerpAPI Alternative
  • Firecrawl Alternative
  • Exa Alternative
  • Serper Alternative
  • Tavily vs Scavio
  • SerpAPI vs Scavio
  • All alternatives
  • Compare Scavio vs alternatives

Search APIs

  • Google Search API
  • Amazon Product API
  • YouTube API
  • Reddit API
  • Walmart Product API
  • TikTok API
  • Instagram API

Tools

  • All Tools

Ask AI about Scavio

© 2026 Scavio. All rights reserved.

Featured on TAAFT
Terms of ServicePrivacy Policy