Poshmark
Poshmark Search API
Search Poshmark listings in one market (us: poshmark.com, USD; ca: poshmark.ca, CAD): each listing with its id, title, price, the original price the seller entered, the price it was first listed at, price-drop badge, size, brand, condition, department, category, colours, likes, comments, shares, shipping discount, seller username and dates, plus facet counts per brand, colour and category. availability available (default), sold or all; seven sorts; brand, department, category, subcategory, size, condition, colour and price filters. 48 listings per page, about 5,000 reachable per query; sold listings stop at 480 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: lululemon align
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.
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)
# Asking prices next to the original price the seller entered: 1 credit per page.
data = client.poshmark.search(query="lululemon align", condition="like_new")["data"]
shares = [i["price"]["amount"] / i["original_price"] for i in data["items"] if i["original_price"]]
print(data["total"], "matches;", len(shares), "of", data["count"], "with an original price;",
"median share", round(median(shares), 2) if shares else None)Response