# Poshmark Closet API Documentation

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.

- **Documentation:** [https://scrappa.co/docs/poshmark-api/poshmark_closet](https://scrappa.co/docs/poshmark-api/poshmark_closet) - **API group:** Poshmark API - **Endpoint:** `GET https://scrappa.co/api/poshmark/closet` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `username` | string | Yes | Poshmark username, e.g. example_closet. | | `availability` | string | No | available (default) or sold. | | `sort` | string | No | added_desc (default), price_asc, price_desc, like_count or price_drop. | | `cursor` | string | No | The pagination.next_cursor value of the previous response. The cursor holds the closet site, so no country is needed with it. | | `country` | string | No | Poshmark site: us (poshmark.com, USD) or ca (poshmark.ca, CAD). Defaults to us. Australia and India closed in 2023. | ## Example response ```json { "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 | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. | | 404 | Not Found | No closet has this username. This response is not billable. | | 502 | Upstream Unavailable | Poshmark could not be reached or answered with an unexpected shape. This response is not billable. | | 504 | Upstream Timeout | Poshmark did not answer in time. This response is not billable. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)