Get Poshmark closet listings

Try in Playground

List the listings in a Poshmark closet, available, sold or both, with keyword, brand, size, condition, color and price filters and sorting. Each listing has the same fields as search. Page with cursor; since and until select listing dates.

GET/v1/poshmark/closetx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

usernamestringquery

Closet username, case-sensitive (the name after poshmark.com/closet/).

Examplepm_editor

urlstringquery

A https://poshmark.com/closet/… link. Provide username or url.

max 600 chars

querystringquery

Keywords within the closet, up to 200 characters.

min 1 chars · max 200 chars

brandstringquery

Brand names as Poshmark shows them, comma-separated, up to 10 (for example Nike,Adidas).

max 1000 chars

sizestringquery

Sizes as Poshmark shows them, comma-separated, up to 10 (for example 8,8.5 or M).

max 1000 chars

conditionenumquery

nwt (new with tags), ret (boutique) or not_nwt (used and without tags).

one of: nwt, ret, not_nwt

colorstringquery

Colors, comma-separated: Red, Pink, Orange, Yellow, Green, Blue, Purple, Gold, Silver, Black, Gray, White, Cream, Brown or Tan.

max 1000 chars

minPricestringquery

Lowest price in whole US dollars.

maxPricestringquery

Highest price in whole US dollars.

availabilityenumquery

available (default), sold or all.

one of: available, sold, all

Exampleall

sortenumquery

best_match, newest (just in), price_asc, price_desc or most_liked.

one of: best_match, newest, price_asc, price_desc, most_liked

sincenumber | stringquery

Keep listings listed at or after this time: ISO 8601 or Unix seconds. Without sort, the grid is read newest first.

untilnumber | stringquery

Keep listings listed before this time: ISO 8601 or Unix seconds.

cursorstringquery

nextCursor from the previous page.

limitstringquery

Listings per page, 1–100 (default 48).

Response fields

120

requestIdstring

Request correlation UUID.

Upstream requests, decoded response bytes and elapsed milliseconds.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True when usable data is returned; inspect status and coverage for omissions.

statusenum

success, partial, failed or challenged. HTTP 200 can be partial.

one of: success, partial

sourceUrlstring

Poshmark public API URL the data was read from.

absolute HTTPS URL

fetchedAtstring

UTC retrieval time.

order is relevance for best_match, newest_first for newest, ranked for price or like sorts and source_order for a closet’s or party’s own order; window echoes since/until. Listings without a listing time are skipped in a window (undated_listings_skipped).

coverage.sourcestring

Always included.

coverage.completeboolean

Always included.

coverage.warningsstring[]

Always included.

coverage.orderenum

Always included.

one of: newest_first, oldest_first, ranked, relevance, source_order

Optional.

coverage.window.sincestringoptional

Optional.

coverage.window.untilstringoptional

Optional.

usernamestring

Closet username, case-sensitive (the name after poshmark.com/closet/).

Listings with Poshmark’s field names: id, title, description, brand, department, category_v2, category_features, size and size_obj, condition (nwt new with tags, ret boutique, other values for used), colors, style_tags, inventory (status available, sold_out, reserved or not_for_sale, with per-size quantities), price and original_price (numbers) with price_amount, original_price_amount and first_user_price_amount (string amounts with currency), price_drop, shipping_discount_type, like_count, comment_count, share_count, has_offer, cover_shot and pictures (image URLs), videos (thumbnail and MP4 URLs), seller identity (creator_id, creator_username, creator_full_name, creator_picture_url), created_at, first_published_at, first_available_at, status_changed_at and updated_at, plus listingUrl. Absent source values are omitted.

up to 100 items

listings.idstring

Always included.

listings.creator_idstringnullableoptional

Optional.

listings.creator_usernamestringnullableoptional

Optional.

listings.creator_display_handlestringnullableoptional

Optional.

listings.creator_full_namestringnullableoptional

Optional.

listings.creator_picture_urlstringnullableoptional

Optional.

listings.statusstringnullableoptional

Optional.

listings.typestringnullableoptional

Optional.

listings.titlestringnullableoptional

Optional.

listings.descriptionstringnullableoptional

Optional.

listings.brandstringnullableoptional

Optional.

listings.brand_idstringnullableoptional

Optional.

listings.department.idstring

Always included.

listings.department.displaystring

Always included.

listings.department.slugstring

Always included.

Optional.

listings.category_v2.idstring

Always included.

listings.category_v2.displaystring

Always included.

listings.category_v2.slugstring

Always included.

Optional.

up to 20 items

listings.category_features.idstring

Always included.

listings.category_features.displaystring

Always included.

listings.category_features.slugstring

Always included.

listings.sizestringnullableoptional

Optional.

listings.size_obj.idstringoptional

Optional.

listings.size_obj.displaystringoptional

Optional.

listings.size_obj.display_with_size_setstringoptional

Optional.

listings.size_obj.size_systemstringoptional

Optional.

listings.conditionstringnullableoptional

Optional.

up to 20 items

listings.colors.namestringoptional

Optional.

listings.colors.rgbstringoptional

Optional.

listings.style_tagsstring[]optional

Optional.

up to 50 items

Optional.

listings.inventory.statusstringoptional

Optional.

listings.inventory.status_changed_atstringoptional

Optional.

listings.inventory.multi_itembooleanoptional

Optional.

up to 200 items

listings.inventory.size_quantities.size_idstringoptional

Optional.

listings.inventory.size_quantities.quantity_availableintegeroptional

Optional.

listings.inventory.size_quantities.quantity_reservedintegeroptional

Optional.

listings.inventory.size_quantities.quantity_soldintegeroptional

Optional.

listings.inventory.size_quantities.size_obj.idstringoptional

Optional.

listings.inventory.size_quantities.size_obj.displaystringoptional

Optional.

listings.inventory.size_quantities.size_obj.display_with_size_setstringoptional

Optional.

listings.inventory.size_quantities.size_obj.size_systemstringoptional

Optional.

listings.pricenumberoptional

Optional.

listings.original_pricenumberoptional

Optional.

listings.price_amount.valstring

Always included.

listings.price_amount.currency_codestring

Always included.

listings.price_amount.currency_symbolstringoptional

Optional.

listings.original_price_amount.valstring

Always included.

listings.original_price_amount.currency_codestring

Always included.

listings.original_price_amount.currency_symbolstringoptional

Optional.

listings.first_user_price_amount.valstring

Always included.

listings.first_user_price_amount.currency_codestring

Always included.

listings.first_user_price_amount.currency_symbolstringoptional

Optional.

listings.price_drop.percentagenumberoptional

Optional.

listings.shipping_discount_typestringnullableoptional

Optional.

listings.deal_info.typestringoptional

Optional.

listings.posh_pass_eligiblebooleanoptional

Optional.

listings.has_offerbooleanoptional

Optional.

listings.like_countintegeroptional

Optional.

listings.comment_countintegeroptional

Optional.

listings.share_countintegeroptional

Optional.

listings.cover_shot.idstringoptional

Optional.

listings.cover_shot.urlstring

Always included.

listings.cover_shot.url_smallstringnullableoptional

Optional.

listings.cover_shot.url_largestringnullableoptional

Optional.

listings.cover_shot.photo_angle_idstringnullableoptional

Optional.

up to 50 items

listings.pictures.idstringoptional

Optional.

listings.pictures.urlstring

Always included.

listings.pictures.url_smallstringnullableoptional

Optional.

listings.pictures.url_largestringnullableoptional

Optional.

listings.pictures.photo_angle_idstringnullableoptional

Optional.

up to 20 items

listings.videos.idstringoptional

Optional.

listings.videos.statusstringoptional

Optional.

listings.videos.created_atstringoptional

Optional.

listings.videos.media.durationnumberoptional

Optional.

listings.videos.media.thumbnail_contentobjectoptional

Optional.

listings.videos.media.video_media_contentobjectoptional

Optional.

listings.created_atstringnullableoptional

Optional.

listings.first_published_atstringnullableoptional

Optional.

listings.first_available_atstringnullableoptional

Optional.

listings.status_changed_atstringnullableoptional

Optional.

listings.updated_atstringnullableoptional

Optional.

listings.listingUrlstring

Always included.

totalintegernullable

Listings in the closet matching the filters, as Poshmark counts them, or null.

nextCursorstringnullable

Cursor for the next page, or null at the end (or once a newest-first page is older than since).

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
200	`partial`	Usable data with related_matches_only, comments_incomplete, comment_limit, love_note_limit or undated_listings_skipped warnings.
400	`invalid_request`	Missing, duplicate, malformed or unsupported parameters, a link outside poshmark.com, or parameters Poshmark rejected.
401	`unauthorized`	Missing or invalid worker API key.
403	`restricted_page`	Poshmark shows the data only to signed-in users.
404	`not_found`	Unknown listing, closet or party.
429	`upstream_rate_limited`	Poshmark rate limited the request.
502	`upstream_challenged`	Poshmark refused the public request or answered with a page instead of JSON.
502	`unsupported_page`	Malformed or mismatched source data.
502	`response_too_large` `payload_too_complex`	Response exceeded byte or parsing limits.
502	`unsafe_redirect` `request_limit` `upstream_error`	Bounded source retrieval could not complete.
503	`busy`	All worker slots and the waiting queue are occupied.
504	`timeout`	Total request deadline expired.

Code example

curl "https://api.scrapeatlas.com/v1/poshmark/closet?username=pm_editor&availability=all" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/poshmark/closet?username=pm_editor&availability=all",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/poshmark/closet?username=pm_editor&availability=all",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Poshmark request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/poshmark/closet",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "username": "pm_editor",
        "availability": "all"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/poshmark/closet?username=pm_editor&availability=all", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/poshmark/closet?username=pm_editor&availability=all"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://poshmark.com/vm-rest/users/synthetic_closet/posts/filtered?request=%7B%22experience%22%3A%22all%22%2C%22count%22%3A48%7D&summarize=true",
  "fetchedAt": "2026-10-22T00:00:00.000Z",
  "coverage": {
    "source": "public_api",
    "complete": true,
    "warnings": [],
    "order": "source_order"
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 290000,
    "durationMs": 820
  },
  "username": "synthetic_closet",
  "listings": [
    {
      "id": "0a1b2c3d4e5f60718293a4b5",
      "creator_id": "5f4e3d2c1b0a99887766554a",
      "creator_username": "synthetic_closet",
      "creator_display_handle": "synthetic_closet",
      "creator_full_name": "Synthetic Closet",
      "creator_picture_url": "https://di2ponv0v5otw.cloudfront.net/users/2026/01/01/t_5f4e3d2c1b0a99887766554a.jpg",
      "status": "published",
      "title": "Synthetic Leather Ankle Boots",
      "description": "Synthetic description of a pair of boots in very good condition.",
      "brand": "Synthbrand",
      "brand_id": "53d96e505632a02800000aaa",
      "department": {
        "id": "01008c10d97b4e1245005764",
        "display": "Women",
        "slug": "Women"
      },
      "category_v2": {
        "id": "04008c10d97b4e1245005764",
        "display": "Shoes",
        "slug": "Shoes"
      },
      "category_features": [
        {
          "id": "0a009813d97b4e3995005764",
          "display": "Ankle Boots & Booties",
          "slug": "Ankle_Boots_&_Booties"
        }
      ],
      "size": "8",
      "size_obj": {
        "id": "8",
        "display": "8",
        "display_with_size_set": "8",
        "size_system": "us"
      },
      "condition": "not_nwt",
      "colors": [
        {
          "name": "Brown",
          "rgb": "#663509"
        }
      ],
      "style_tags": [
        "western"
      ],
      "inventory": {
        "status": "available",
        "status_changed_at": "2026-10-20T09:15:02-07:00",
        "multi_item": false,
        "size_quantities": [
          {
            "size_id": "8",
            "quantity_available": 1,
            "quantity_reserved": 0,
            "quantity_sold": 0,
            "size_obj": {
              "id": "8",
              "display": "8",
              "display_with_size_set": "8",
              "size_system": "us"
            }
          }
        ]
      },
      "price": 45,
      "original_price": 180,
      "price_amount": {
        "val": "45.0",
        "currency_code": "USD",
        "currency_symbol": "$"
      },
      "original_price_amount": {
        "val": "180.0",
        "currency_code": "USD",
        "currency_symbol": "$"
      },
      "first_user_price_amount": {
        "val": "55.0",
        "currency_code": "USD",
        "currency_symbol": "$"
      },
      "price_drop": {
        "percentage": 18
      },
      "shipping_discount_type": null,
      "deal_info": {},
      "posh_pass_eligible": false,
      "has_offer": true,
      "like_count": 14,
      "comment_count": 1,
      "share_count": 9,
      "cover_shot": {
        "id": "6ad8bc2db55223e609411e2c",
        "url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/20/0a1b2c3d4e5f60718293a4b5/m_6ad8bc2db55223e609411e2c.jpg",
        "url_small": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/20/0a1b2c3d4e5f60718293a4b5/s_6ad8bc2db55223e609411e2c.jpg",
        "url_large": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/20/0a1b2c3d4e5f60718293a4b5/l_6ad8bc2db55223e609411e2c.jpg",
        "photo_angle_id": "front"
      },
      "pictures": [
        {
          "id": "6ad8bc471b53fe118bc92df4",
          "url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/20/0a1b2c3d4e5f60718293a4b5/m_6ad8bc471b53fe118bc92df4.jpg",
          "url_small": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/20/0a1b2c3d4e5f60718293a4b5/s_6ad8bc471b53fe118bc92df4.jpg",
          "url_large": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/20/0a1b2c3d4e5f60718293a4b5/l_6ad8bc471b53fe118bc92df4.jpg",
          "photo_angle_id": "side"
        }
      ],
      "videos": [],
      "created_at": "2026-10-20T09:10:44-07:00",
      "first_published_at": "2026-10-20T09:15:01-07:00",
      "first_available_at": "2026-10-20T09:15:02-07:00",
      "status_changed_at": "2026-10-21T18:02:11-07:00",
      "updated_at": "2026-10-21T18:02:11-07:00",
      "listingUrl": "https://poshmark.com/listing/0a1b2c3d4e5f60718293a4b5"
    },
    {
      "id": "0a1b2c3d4e5f60718293a4c6",
      "creator_id": "5f4e3d2c1b0a99887766554a",
      "creator_username": "synthetic_closet",
      "creator_display_handle": "synthetic_closet",
      "creator_full_name": "Synthetic Closet",
      "creator_picture_url": "https://di2ponv0v5otw.cloudfront.net/users/2026/01/01/t_5f4e3d2c1b0a99887766554a.jpg",
      "status": "published",
      "title": "Synthetic Suede Booties",
      "description": "Synthetic description of a pair of boots in very good condition.",
      "brand": "Synthbrand",
      "brand_id": "53d96e505632a02800000aaa",
      "department": {
        "id": "01008c10d97b4e1245005764",
        "display": "Women",
        "slug": "Women"
      },
      "category_v2": {
        "id": "04008c10d97b4e1245005764",
        "display": "Shoes",
        "slug": "Shoes"
      },
      "category_features": [
        {
          "id": "0a009813d97b4e3995005764",
          "display": "Ankle Boots & Booties",
          "slug": "Ankle_Boots_&_Booties"
        }
      ],
      "size": "8",
      "size_obj": {
        "id": "8",
        "display": "8",
        "display_with_size_set": "8",
        "size_system": "us"
      },
      "condition": "not_nwt",
      "colors": [
        {
          "name": "Brown",
          "rgb": "#663509"
        }
      ],
      "inventory": {
        "status": "available",
        "status_changed_at": "2026-10-20T09:15:02-07:00",
        "multi_item": false,
        "size_quantities": [
          {
            "size_id": "8",
            "quantity_available": 1,
            "quantity_reserved": 0,
            "quantity_sold": 0,
            "size_obj": {
              "id": "8",
              "display": "8",
              "display_with_size_set": "8",
              "size_system": "us"
            }
          }
        ]
      },
      "price": 32,
      "original_price": 180,
      "price_amount": {
        "val": "32.0",
        "currency_code": "USD",
        "currency_symbol": "$"
      },
      "original_price_amount": {
        "val": "180.0",
        "currency_code": "USD",
        "currency_symbol": "$"
      },
      "first_user_price_amount": {
        "val": "55.0",
        "currency_code": "USD",
        "currency_symbol": "$"
      },
      "shipping_discount_type": null,
      "deal_info": {},
      "posh_pass_eligible": false,
      "has_offer": true,
      "like_count": 3,
      "comment_count": 1,
      "share_count": 9,
      "cover_shot": {
        "id": "6ad8bc2db55223e609411e2c",
        "url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/20/0a1b2c3d4e5f60718293a4b5/m_6ad8bc2db55223e609411e2c.jpg",
        "url_small": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/20/0a1b2c3d4e5f60718293a4b5/s_6ad8bc2db55223e609411e2c.jpg",
        "url_large": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/20/0a1b2c3d4e5f60718293a4b5/l_6ad8bc2db55223e609411e2c.jpg",
        "photo_angle_id": "front"
      },
      "pictures": [
        {
          "id": "6ad8bc471b53fe118bc92df4",
          "url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/20/0a1b2c3d4e5f60718293a4b5/m_6ad8bc471b53fe118bc92df4.jpg",
          "url_small": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/20/0a1b2c3d4e5f60718293a4b5/s_6ad8bc471b53fe118bc92df4.jpg",
          "url_large": "https://di2ponv0v5otw.cloudfront.net/posts/2026/10/20/0a1b2c3d4e5f60718293a4b5/l_6ad8bc471b53fe118bc92df4.jpg",
          "photo_angle_id": "side"
        }
      ],
      "created_at": "2026-10-20T09:10:44-07:00",
      "first_published_at": "2026-10-20T09:15:01-07:00",
      "first_available_at": "2026-10-20T09:15:02-07:00",
      "status_changed_at": "2026-10-21T18:02:11-07:00",
      "updated_at": "2026-10-21T18:02:11-07:00",
      "listingUrl": "https://poshmark.com/listing/0a1b2c3d4e5f60718293a4c6"
    }
  ],
  "total": 139,
  "nextCursor": "ENC_eyJwYWdlX251bSI6Mn0"
}

Missing, duplicate, malformed or unsupported parameters, a link outside poshmark.com, or parameters Poshmark rejected.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": false,
  "status": "failed",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}