Poshmark Closet API Documentation Read a Poshmark seller closet: the public profile and one page of listings. The profile has the username, handle, bio, picture, join date, super seller flag and stats (followers, following, listings, items sold, orders shipped, average ship time in hours, 5 star ratings, vacation mode, last active). Real names, gender, city, state, college and other private data are never returned. Items are the same as in search; with availability sold they carry the sale price and date. Page 1 returns the profile and items. Pages with a cursor return items only. The closet is read on the site where the seller lives, so a US closet works with country ca too. An unknown username gives a 404 and costs nothing. Cost: 1 credit per request, only for successful requests.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
4 optional filters available.
string
Required
Poshmark username, e.g. example_closet.
example
string
Optional
available (default) or sold.
example
string
Optional
added_desc (default), price_asc, price_desc, like_count or price_drop.
relevance
string
Optional
The pagination.next_cursor value of the previous response. The cursor holds the closet site, so no country is needed with it.
0
string
Optional
Poshmark site: us (poshmark.com, USD) or ca (poshmark.ca, CAD). Defaults to us. Australia and India closed in 2023.
US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
meta
items
country
profile
success
pagination
filters_applied
Common items fields
id
url
size
sold
{
"meta": {
"billable": true,
"endpoint_family": "closet"
},
"items": [
{
"id": "6ae61cf76427002ad0c0cc10",
"url": "https://poshmark.com/listing/6ae61cf76427002ad0c0cc10",
"size": "S",
"sold": true,
"brand": "lululemon athletica",
"likes": 0,
"price": {
"amount": 70,
"currency": "USD"
},
"sizes": [
{
"size": "S",
"quantity_sold": 1,
"quantity_reserved": 0,
"quantity_available": 0
}
],
"title": "Lululemon Scuba Oversized Half-Zip Hoodie Black Gold Zipper",
"colors": [
"Black"
],
"images": [
{
"url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/24/6add1435970988aec90b770c/l_6add14c431f0f60722958b8a.jpg",
"thumbnail": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/24/6add1435970988aec90b770c/s_6add14c431f0f60722958b8a.jpg"
},
{
"url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/24/6add1435970988aec90b770c/l_6add14c5046d1f9d00426b12.jpg",
"thumbnail": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/24/6add1435970988aec90b770c/s_6add14c5046d1f9d00426b12.jpg"
},
{
"url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/24/6add1435970988aec90b770c/l_6add14c65551aa6f0d5e1b6a.jpg",
"thumbnail": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/24/6add1435970988aec90b770c/s_6add14c65551aa6f0d5e1b6a.jpg"
}
],
"seller": {
"username": "example_closet",
"picture_url": "https://di2ponv0v5otw.cloudfront.net/users/2026/02/07/8/t_698767ff3972a844fea8edaf.jpg",
"display_handle": "example_closet"
},
"shares": 0,
"sold_at": "2026-10-31T16:53:14+00:00",
"category": {
"name": "Tops",
"slug": "Tops"
},
"discount": {
"amount": 48,
"percent": 40.7
},
"condition": {
"code": "uln",
"label": "Like new"
},
"listed_at": "2026-10-31T16:53:11+00:00",
"department": "Women",
"sold_price": {
"amount": 70,
"currency": "USD"
},
"updated_at": "2026-10-31T16:53:14+00:00",
"description": "Lululemon Scuba Oversized Half-Zip Hoodie in classic black with a gold-tone zipper. Features a cozy oversized fit, adjustable hood, front kangaroo pocket, and thumbholes at the cuffs. A timeless athleisure staple perfect for everyday wear, errands, and travel.\n\nI listed it as xs and small but I only have ONE scuba \n21\u201d armpit to armpit flat\n16\u201d shoulder to hem",
"availability": "sold_out",
"days_to_sell": 0,
"category_path": [
"Women",
"Tops",
"Sweatshirts & Hoodies"
],
"comments_count": 0,
"original_price": {
"amount": 118,
"currency": "USD"
},
"category_features": [
{
"name": "Sweatshirts & Hoodies",
"slug": "Sweatshirts_&_Hoodies"
}
],
"first_listed_price": null
}
],
"country": "us",
"profile": {
"bio": null,
"url": "https://poshmark.com/closet/example_closet",
"stats": {
"listings": 383,
"followers": 8097,
"following": 14044,
"items_sold": "100+",
"on_vacation": false,
"last_active_at": "2026-11-03T08:00:00+00:00",
"orders_shipped": 107,
"average_ship_time_hours": 24.3,
"buyer_five_star_ratings": 4,
"seller_five_star_ratings": 15
},
"username": "example_closet",
"joined_at": "2026-02-07T16:25:44+00:00",
"home_market": "us",
"picture_url": "https://di2ponv0v5otw.cloudfront.net/users/2026/02/07/8/t_698767ff3972a844fea8edaf.jpg",
"super_seller": false,
"display_handle": "example_closet"
},
"success": true,
"pagination": {
"count": 48,
"total": 131,
"has_more": true,
"next_cursor": "us.ENC_eyJtYXhfaWRzIjpbNCwxLDFd",
"total_capped": false
},
"filters_applied": {
"sort": "added_desc",
"availability": "sold"
}
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"username": [
"A Poshmark username is required, e.g. example_closet."
]
},
"message": "The request validation failed"
}Not Found
No closet has this username. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "closet"
},
"error": {
"code": "NOT_FOUND",
"message": "Poshmark has no closet for this request."
},
"success": false
}Upstream Unavailable
Poshmark could not be reached or answered with an unexpected shape. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "closet"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Poshmark is temporarily unavailable. Please retry."
},
"success": false
}Upstream Timeout
Poshmark did not answer in time. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "closet"
},
"error": {
"code": "UPSTREAM_TIMEOUT",
"message": "Poshmark did not answer in time. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.