Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / Poshmark

1 credit per call4 endpoints24 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 keyRun 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 OKJSONX-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.

#idstringurlurltitlestringdescriptionstringbrandstringdepartmentstringcategoryobjectcategory_pathstring[]colorsstring[]conditionobjectsizestringsizesobject[]priceobjectoriginal_priceobjectfirst_listed_priceobjectimagesobject[]likesintegercomments_countintegersharesintegerlisted_atstringupdated_atstringsellerobjectavailabilitystringsoldboolean
163e9a765932a8a0f0f5160a6https://poshmark.com/listing/63e9a765932a8a0f0f5160a6JacketsJacketsZaraWomen{2 fields}[2 items][1 item]{2 fields}S[1 item]{2 fields}{2 fields}{2 fields}[1 item]1052023-02-13T03:00:45+00:002025-12-10T14:47:10+00:00{3 fields}availablefalse
26abbe055728253db5936c234https://poshmark.com/listing/6abbe055728253db5936c234Zara Kids Jacket in Beige Size 3 Years NWTZara 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 smudgesZaraKids{2 fields}[3 items]—{2 fields}98 cm[1 item]{2 fields}{2 fields}{2 fields}[3 items]20172026-09-29T16:04:11+00:002026-10-19T19:20:40+00:00{3 fields}availablefalse
36ada52e232f934cdce2f2680https://poshmark.com/listing/6ada52e232f934cdce2f2680Zara Red and Black Plaid Cropped JacketCropped plaid jacket by Zara. Button-front closure. Elasticized hem for a snug fit. Lightweight and easy to layer.ZaraWomen{2 fields}[3 items][2 items]{2 fields}XS[1 item]{2 fields}—{2 fields}[1 item]5022026-10-22T18:18:01+00:002026-11-11T17:01:51+00:00{3 fields}availablefalse

Recorded from our API · 3 items shown · 24 datapoints per itemGET /v1/poshmark/search?query=jacket&brand[]=Zara&condition[]=nwt&price_max=60&sort=price_asc

24 datapoints

Identity

  • idstring
  • titlestring
  • brandstring
  • categoryobject
  • category_pathstring[]

Contact

  • urlurl
  • sellerobject

Reputation

  • imagesobject[]

Price

  • priceobject
  • original_priceobject
  • first_listed_priceobject

Other

  • descriptionstring
  • departmentstring
  • colorsstring[]
  • conditionobject
  • sizestring
  • sizesobject[]
  • likesinteger
  • comments_countinteger
  • sharesinteger
  • listed_atstring
  • updated_atstring
  • availabilitystring
  • soldboolean

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/poshmark/closet
username+5 optional
1 credit
GET/v1/poshmark/listing
none+3 optional
1 credit
GET/v1/poshmark/search
none+16 optional
1 credit
GET/v1/poshmark/suggestions
query+1 optional
1 credit

Overview

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.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

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 keyRead the docs