--- title: "Poshmark API: JSON data, 4 endpoints, 1 credit per call" description: "Poshmark API for listing search by brand, size, condition and price, sold listings, listing details and closets as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/poshmark --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Poshmark 1 credit per call 4 endpoints 24 datapoints # Poshmark API Poshmark API for listing search by brand, size, condition and price, sold listings, listing details and closets as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Poshmark GET /v1/poshmark/search?query=jacket&brand\[\]=Zara&condition\[\]=nwt&price\_max=60&sort=price\_asc ``` { "success": true, "items": [ { "id": "63e9a765932a8a0f0f5160a6", "url": "https://poshmark.com/listing/63e9a765932a8a0f0f5160a6", "title": "Jackets", "description": "Jackets", "brand": "Zara", "department": "Women", "category": { "slug": "Jackets_&_Coats", "name": "Jackets & Coats" }, "category_path": [ "Women", "Jackets & Coats" ], "colors": [ "Blue" ], "condition": { "code": "nwt", "label": "New with tags" }, "size": "S", "sizes": [ { "size": "S", "quantity_available": 1, "quantity_sold": 0, "quantity_reserved": 0 } ], "price": { "amount": 3, "currency": "USD" }, "original_price": { "amount": 3, "currency": "USD" }, "first_listed_price": { "amount": 1, "currency": "USD" }, "images": [ { "url": "https://di2ponv0v5otw.cloudfront.net/posts/2023/02/12/63e9a765932a8a0f0f5160a6/l_63e9a7818d7a3caaccf283e1.jpg", "thumbnail": "https://di2ponv0v5otw.cloudfront.net/posts/2023/02/12/63e9a765932a8a0f0f5160a6/s_63e9a7818d7a3caaccf283e1.jpg" } ], "likes": 1, "comments_count": 0, "shares": 5, "listed_at": "2023-02-13T03:00:45+00:00", "updated_at": "2025-12-10T14:47:10+00:00", "seller": { "username": "aracelynajar", "display_handle": "aracelynajar", "picture_url": "https://di2ponv0v5otw.cloudfront.net/users/2022/04/27/19/t_6269f6fa6200d1ffccef00d4.jpg" }, "availability": "available", "sold": false }, { "id": "6abbe055728253db5936c234", "url": "https://poshmark.com/listing/6abbe055728253db5936c234", "title": "Zara Kids Jacket in Beige Size 3 Years NWT", "description": "Zara kids jacket in beige with long sleeves, front pockets, and silver-tone snap buttons. Size 3 Years (98 cm). New with tags. Has 2 red smudges", "brand": "Zara", "department": "Kids", "category": { "slug": "Jackets_&_Coats", "name": "Jackets & Coats" }, "category_features": [ { "slug": "Jean_Jackets", "name": "Jean Jackets" } ], "category_path": [ "Kids", "Jackets & Coats", "Jean Jackets" ], "condition": { "code": "nwt", "label": "New with tags" }, "size": "98 cm", "sizes": [ { "size": "98 cm", "quantity_available": 1, "quantity_sold": 0, "quantity_reserved": 0 } ], "price": { "amount": 3, "currency": "USD" }, "original_price": { "amount": 30, "currency": "USD" }, "discount": { "percent": 90, "amount": 27 }, "first_listed_price": { "amount": 5, "currency": "USD" }, "images": [ { "url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/09/29/6abbe055728253db5936c234/l_6abbe0965fc54f3d1cf8df07.jpg", "thumbnail": "https://di2ponv0v5otw.cloudfront.net/posts/2026/09/29/6abbe055728253db5936c234/s_6abbe0965fc54f3d1cf8df07.jpg" }, { "url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/09/29/6abbe055728253db5936c234/l_6abbe08f7e297ba1373cf08c.jpg", "thumbnail": "https://di2ponv0v5otw.cloudfront.net/posts/2026/09/29/6abbe055728253db5936c234/s_6abbe08f7e297ba1373cf08c.jpg" }, { "url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/09/29/6abbe055728253db5936c234/l_6abbe0a17282535b2b36c618.jpg", "thumbnail": "https://di2ponv0v5otw.cloudfront.net/posts/2026/09/29/6abbe055728253db5936c234/s_6abbe0a17282535b2b36c618.jpg" } ], "likes": 2, "comments_count": 0, "shares": 17, "listed_at": "2026-09-29T16:04:11+00:00", "updated_at": "2026-10-19T19:20:40+00:00", "seller": { "username": "_myboutique_", "display_handle": "_myboutique_", "picture_url": "https://di2ponv0v5otw.cloudfront.net/users/2026/09/29/12/t_6abc0eebff8a47859bcb46b1.jpg" }, "availability": "available", "sold": false }, { "id": "6ada52e232f934cdce2f2680", "url": "https://poshmark.com/listing/6ada52e232f934cdce2f2680", "title": "Zara Red and Black Plaid Cropped Jacket", "description": "Cropped plaid jacket by Zara. Button-front closure. Elasticized hem for a snug fit. Lightweight and easy to layer.", "brand": "Zara", "department": "Women", "category": { "slug": "Jackets_&_Coats", "name": "Jackets & Coats" }, "category_features": [ { "slug": "Blazers_&_Suit_Jackets", "name": "Blazers & Suit Jackets" } ], "category_path": [ "Women", "Jackets & Coats", "Blazers & Suit Jackets" ], "colors": [ "Orange", "Red" ], "condition": { "code": "nwt", "label": "New with tags" }, "size": "XS", "sizes": [ { "size": "XS", "quantity_available": 1, "quantity_sold": 0, "quantity_reserved": 0 } ], "price": { "amount": 7, "currency": "USD" }, "first_listed_price": { "amount": 7, "currency": "USD" }, "images": [ { "url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/22/6ada52e232f934cdce2f2680/l_6ada52f92313936273f9f1c7.jpg", "thumbnail": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/22/6ada52e232f934cdce2f2680/s_6ada52f92313936273f9f1c7.jpg" } ], "likes": 5, "comments_count": 0, "shares": 2, "listed_at": "2026-10-22T18:18:01+00:00", "updated_at": "2026-11-11T17:01:51+00:00", "seller": { "username": "brysha_tobias", "display_handle": "brysha_tobias", "picture_url": "https://di2ponv0v5otw.cloudfront.net/users/2021/04/14/10/t_607723f03c135cc4dc0e3282.jpg" }, "availability": "available", "sold": false } ], "pagination": { "next_cursor": "ENC_eyJtYXhfaWRzIjpbNDksMSwxXSwibWF4X2lkX3NjaGVtZSI6Im9yZyIsInBhZ2VfbnVtIjoyLCJwYWdlX2dyb3VwX2lkIjoiNmFmNWI4ODA3ZDkwNTcyM2ZjODk2N2QxIn0", "has_more": true, "count": 48, "total": 5000, "total_capped": true }, "filters_applied": { "query": "jacket", "price_max": "60", "sort": "price_asc", "brand": [ "Zara" ], "condition": [ "nwt" ], "availability": "available" }, "country": "us", "meta": { "endpoint_family": "search", "request_id": "req_85bf4c911e4b4bb6a08eb3870442e45c", "credits_charged": 1, "credits_remaining": 1920 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id string | url url | title string | description string | brand string | department string | category object | category\_path string\[\] | colors string\[\] | condition object | size string | sizes object\[\] | price object | original\_price object | first\_listed\_price object | images object\[\] | likes integer | comments\_count integer | shares integer | listed\_at string | updated\_at string | seller object | availability string | sold boolean | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 63e9a765932a8a0f0f5160a6 | https://poshmark.com/listing/63e9a765932a8a0f0f5160a6 | Jackets | Jackets | Zara | Women | {2 fields} | \[2 items\] | \[1 item\] | {2 fields} | S | \[1 item\] | {2 fields} | {2 fields} | {2 fields} | \[1 item\] | 1 | 0 | 5 | 2023-02-13T03:00:45+00:00 | 2025-12-10T14:47:10+00:00 | {3 fields} | available | false | | 2 | 6abbe055728253db5936c234 | https://poshmark.com/listing/6abbe055728253db5936c234 | Zara Kids Jacket in Beige Size 3 Years NWT | Zara kids jacket in beige with long sleeves, front pockets, and silver-tone snap buttons. Size 3 Years (98 cm). New with tags. Has 2 red smudges | Zara | Kids | {2 fields} | \[3 items\] | — | {2 fields} | 98 cm | \[1 item\] | {2 fields} | {2 fields} | {2 fields} | \[3 items\] | 2 | 0 | 17 | 2026-09-29T16:04:11+00:00 | 2026-10-19T19:20:40+00:00 | {3 fields} | available | false | | 3 | 6ada52e232f934cdce2f2680 | https://poshmark.com/listing/6ada52e232f934cdce2f2680 | Zara Red and Black Plaid Cropped Jacket | Cropped plaid jacket by Zara. Button-front closure. Elasticized hem for a snug fit. Lightweight and easy to layer. | Zara | Women | {2 fields} | \[3 items\] | \[2 items\] | {2 fields} | XS | \[1 item\] | {2 fields} | — | {2 fields} | \[1 item\] | 5 | 0 | 2 | 2026-10-22T18:18:01+00:00 | 2026-11-11T17:01:51+00:00 | {3 fields} | available | false | Recorded from our API · 3 items shown · 24 datapoints per item GET /v1/poshmark/search?query=jacket&brand\[\]=Zara&condition\[\]=nwt&price\_max=60&sort=price\_asc 24 datapoints ### Identity - id string - title string - brand string - category object - category\_path string\[\] ### Contact - url url - seller object ### Reputation - images object\[\] ### Price - price object - original\_price object - first\_listed\_price object ### Other - description string - department string - colors string\[\] - condition object - size string - sizes object\[\] - likes integer - comments\_count integer - shares integer - listed\_at string - updated\_at string - availability string - sold boolean Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/poshmark/search?query=jacket&brand[]=Zara&condition[]=nwt&price_max=60&sort=price_asc" \ -H "X-API-Key: $API_KEY" ``` Poshmark · 4 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/poshmark/closet`](https://perceptlayer.com/apis/poshmark/closet) | `username` +5 optional | 1 credit | | [GET `/v1/poshmark/listing`](https://perceptlayer.com/apis/poshmark/listing) | none +3 optional | 1 credit | | [GET `/v1/poshmark/search`](https://perceptlayer.com/apis/poshmark/search) | none +16 optional | 1 credit | | [GET `/v1/poshmark/suggestions`](https://perceptlayer.com/apis/poshmark/suggestions) | `query` +1 optional | 1 credit | Overview ## About the Poshmark API ## What you can get The Poshmark API returns Poshmark marketplace data as JSON through 4 endpoints. Each takes an optional `country` of us or ca. - **Search:** `search` takes a `query`, with `category`, `category_feature`, `department` (Women, Men or Kids), `price_min`, `price_max`, `availability` (available, sold, not\_for\_sale or all), `sort` (relevance, price\_asc, price\_desc, added\_desc, price\_drop or like\_count), `cursor`, `page` and `count`. `brand[]`, `size[]`, `color[]` and `condition[]` (nwt, uln, ug or uf) are repeatable. `suggestions` takes a partial `query`. - **Listings:** `listing` takes an `id` or a `url`. - **Closets:** `closet` takes a `username`, with `availability` (available or sold), `sort` (added\_desc, price\_asc, price\_desc, like\_count or price\_drop), `cursor` and `page`. The recorded search for "jacket" with `brand[]=Zara`, `condition[]=nwt`, `price_max=60` and `sort=price_asc` returns `items`, each with `id`, `url`, `title`, `brand`, `department`, `category`, `colors`, `condition` (code and label), `size`, `price`, `original_price`, `first_listed_price`, `likes`, `shares`, `listed_at`, `seller` (with `username`), `availability` and `sold`. It also returns `pagination` with `next_cursor` and `has_more`, and `filters_applied`. ## How a call works Search listings: `GET /v1/poshmark/search?query=jacket&brand[]=Zara&condition[]=nwt&price_max=60&sort=price_asc` with your key in the `X-API-Key` header. Each result carries an `id`, which `listing` takes, and a seller `username`, which `closet` takes. Pass `next_cursor` as `cursor` for the next page. Every successful call costs 1 credit; failed calls cost nothing. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) Use cases ### Track resale prices for a brand with \`availability=sold\` `` Use the Poshmark API to track resale prices for a brand with `availability=sold` `` ### Compare a listing's \`price\` with its \`original\_price\` and \`first\_listed\_price\` `` Use the Poshmark API to compare a listing's `price` with its `original_price` and `first_listed_price` `` ### Watch price drops with \`sort=price\_drop\` `` Use the Poshmark API to watch price drops with `sort=price_drop` `` ### Follow a seller's closet, available and sold `Use the Poshmark API to follow a seller's closet, available and sold` FAQ ## Questions **How much does the Poshmark API cost?** Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale. **Can I search sold listings?** Yes. Pass \`availability=sold\` to \`search\` or \`closet\`. **Do I need a Poshmark account?** No. You call this Poshmark API with your Perceptlayer key in the \`X-API-Key\` header, with no Poshmark login. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Should I build a Poshmark scraper instead?** You can, but a Poshmark scraper is code you maintain: page changes break it, requests get blocked, and Poshmark's terms govern how you collect data. The Poshmark API gives you 4 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Poshmark API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)