Poshmark
Poshmark Sold Listings API
Sold Poshmark listings by keyword in one market (us: poshmark.com, USD; ca: poshmark.ca, CAD), with the price shown on each sold listing and sold_at, the date Poshmark marked it sold, plus the original price the seller entered, the price it was first listed at, size, brand, condition, category, colours, likes and seller username. Poshmark says a sold listing reflects the final order price; offers are private and not returned. Filter by brand, department, category, subcategory, size, condition, colour and price; seven sorts. 48 per page, up to 10 pages: 480 sold listings per query and filter combination. 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/jsonquerystringrequiredSearch keywords, 1-200 characters.
Example: coach bag
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 10, 48 sold listings each (480 per query and filter combination). Page 11 and up answers 400, not charged.
Example: 2
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.
brandstring | string[]Brand names as Poshmark writes them (items[].brand, brands, suggestions), one or up to 10.
Example: ["Coach"]
departmentenum<string>Department: Women, Men, Kids, Home, Pets, Electronics.
Example: Women
categorystringCategory slug or name from categories (Bags, Pants_&_Jumpsuits). Needs department. An unknown category is a charged 404.
Example: Bags
subcategorystringSubcategory slug or name from categories (Totes, Leggings). Needs category.
Example: Totes
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 statistics import median
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=180)
# Sold prices for one brand, split by condition: 1 credit per page of 48.
# Each query + filter combination reaches 480 sold listings, so narrow
# with filters (or price_min / price_max ranges) to read more.
for condition in ["new_with_tags", "like_new", "good"]:
items = []
for page in range(1, 4):
data = client.poshmark.sold(query="coach bag", brand="Coach", condition=condition, page=page)["data"]
items += data["items"]
if not data["has_more"]:
break
prices = [i["price"]["amount"] for i in items]
print(condition, len(prices), "sold, median", median(prices) if prices else None,
"latest sold_at", max(i["sold_at"] for i in items) if items else None)Response