Poshmark
Poshmark Brand API
One brand's Poshmark listings in a market (us: USD, ca: CAD), optionally in one department and category: the brand's id and name, then 48 listings per page with price, the original price the seller entered, size, condition, category, colours, likes and seller username, plus facet counts. availability available (default), sold or all; seven sorts; size, condition, colour and price filters. brand takes a name (Coach, lululemon athletica) or a slug (items[].brand_slug). An unknown brand is a charged 404. Costs 1 credit.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonbrandstringrequiredOne brand: its name (Coach, lululemon athletica) or slug (items[].brand_slug, e.g. lululemon_athletica).
Example: Coach
departmentenum<string>Department: Women, Men, Kids, Home, Pets, Electronics.
Example: Women
categorystringCategory slug or name from categories. Needs department.
Example: Bags
countrystringdefault:usThe 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:1Page, 1 to 105, 48 listings each (about 5,000 reachable per query). Sold listings stop at page 10.
Example: 2
availabilityenum<string>default:availableWhich 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:relevanceResult 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.
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_minnumberLowest price, whole units of the market's currency.
Example: 20
price_maxnumberHighest 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).
| country | Market | Currency | Language | Credits |
|---|---|---|---|---|
us | United States (poshmark.com) | USD | English | 1 |
ca | Canada (poshmark.ca) | CAD | English | 1 |
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=180)
# What a brand's sold listings show next to the original price the seller entered.
data = client.poshmark.brand(brand="Coach", availability="sold", department="Women", category="Bags")["data"]
for i in data["items"]:
share = i["price"]["amount"] / i["original_price"] if i["original_price"] else None
print(i["sold_at"][:10], i["price"]["amount"], i["original_price"], share and round(share, 2), i["title"])Response