Skip to main content
POST
Poshmark items search

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
query
string

Search term (optional). e.g. nike shoes

domain
enum<string>
default:poshmark.com

Domain. Options: poshmark.com = poshmark.com, poshmark.ca = poshmark.ca

Available options:
poshmark.com,
poshmark.ca
max_items
integer
default:25

Max items (up to 500)

Required range: 1 <= x <= 500
start_page
integer

Starting page

Required range: x >= 1
sort
enum<string>

Sort by. Options: relevance = Relevance, just_in = Just in, price_low_to_high = Price: low to high, price_high_to_low = Price: high to low

Available options:
relevance,
just_in,
price_low_to_high,
price_high_to_low
availability
enum<string>

Availability. Options: all = All, available = Available, available_and_dropping_soon = Available and dropping soon, dropping_soon = Dropping soon, sold = Sold, not_for_sale = Not for sale

Available options:
all,
available,
available_and_dropping_soon,
dropping_soon,
sold,
not_for_sale
department
enum<string>

Department. Options: Women = Women, Men = Men, Kids = Kids, Home = Home, Electronics = Electronics, Pets = Pets, Beauty & Wellness = Beauty & Wellness

Available options:
Women,
Men,
Kids,
Home,
Electronics,
Pets,
Beauty & Wellness
condition
enum<string>

Condition. Options: all = All conditions, nwt = New with tags (NWT)

Available options:
all,
nwt
category
string

Category. e.g. e.g. Shoes, Dresses, Bags

subcategory
string

Subcategory. e.g. e.g. Athletic Shoes, Sneakers

brand
string

Brand. e.g. e.g. Nike, Coach

size
string

Sizes (comma separated). e.g. e.g. 8, M

price_min
number

Min price

Required range: x >= 0
price_max
number

Max price

Required range: x >= 0
shipping
enum<string>

Shipping. Options: free = Free shipping, discounted = Discounted shipping

Available options:
free,
discounted
color
enum<string>[]

Colors

Available options:
Red,
Pink,
Orange,
Yellow,
Green,
Blue,
Purple,
Gold,
Silver,
Black,
Gray,
White,
Cream,
Brown,
Tan

Response

Run completed.

session_id
string

Session identifier for this run.

kind
string

Data source identifier for this endpoint.

query
string
domain
string
max_items
integer
start_page
integer
partial
boolean

True when the scrape stopped early and returned the records collected so far.

human
string

Markdown summary of the result, for display.

machine
object

Structured result payload.

total_points
integer

Points charged for this run.