Poshmark sold listings API reference
GET /v1/poshmark/sold searches one page of Poshmark sold listings by keyword, on Poshmark US or Canada, with condition and price filters, and returns JSON.
https://api.soldgraph.com/v1/poshmark/soldSearch Poshmark sold listings by keyword, on Poshmark US or Canada. Each call returns one page of results, not a full sales history. Poshmark has no public API of its own. See Poshmark API. For a one-page overview, see the Poshmark sold listings API page.
displayed_price is the listing's asking price, not what the buyer paid. Offers and bundles can change the final price. Rows have no shipping fields, because Poshmark search doesn't show shipping.
sold_date_text is when the listing changed to sold out, as a full timestamp. sold_date is its date part, like 2026-09-28. condition is Poshmark's own code, like nwt or ug. brand and size are what the seller entered.
| Parameter | Type | Default | Description |
|---|---|---|---|
q | string | Required | Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition. |
page | integer, 1–100 | 1 | Source page to fetch. Where an endpoint has cursor, pages after 1 also need it. |
min_price | integer, 0–1000000 | Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price. | |
max_price | integer, 0–1000000 | Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price. | |
marketplace | poshmark | poshmark | Optional. If sent, it must be poshmark. |
country | us or ca | us | Which Poshmark site to search: us (poshmark.com, US dollars) or ca (poshmark.ca, Canadian dollars). Results, prices, min_price and max_price use that site's currency. Optional. |
condition | nwt, uln, ug or uf | One of Poshmark's own condition codes: nwt (new with tags), uln (like new), ug (good) or uf (fair). Rows use the same codes. Poshmark filters one condition at a time, so more than one returns 422. | |
cursor | string | The previous page's next_cursor. Leave it out on page 1. Required on every later page. |
curl -G https://api.soldgraph.com/v1/poshmark/sold \ -H "Authorization: Bearer $SOLDGRAPH_KEY" \ --data-urlencode "q=Levis 501" \ -d page=1The first call usually returns 202 and a job to poll. Search jobs covers polling and retries.
#Filters
conditiontakes one Poshmark code:nwt,uln,ugoruf. Poshmark filters one condition at a time, so more than one returns422.min_priceandmax_priceare whole units of the site's currency: US dollars, or Canadian dollars withcountry=ca. You can send either one alone.
Poshmark applies the filters, so reported_total counts only matching listings. Keep the same filters on every page.
#Countries
country picks the Poshmark site. Leave it out for Poshmark US.
country | Poshmark site | Currency |
|---|---|---|
us | poshmark.com | USD |
ca | poshmark.ca | CAD |
- Prices,
min_priceandmax_priceare in that site's currency. linkpoints to the listing on that site.- Each country is its own search and costs one request.
- Condition codes and cursors work the same on both sites.
- Use a cursor with the country it came from.
#Condition codes
The API returns Poshmark's condition code as-is. It doesn't turn codes into words or match them to eBay's conditions. For reference, the codes mean:
| Code | Meaning | Can filter by it |
|---|---|---|
nwt | New with tags | Yes |
not_nwt | New without tags | No |
ret | Boutique or retail | No |
uln | Like new | Yes |
ug | Good | Yes |
uf | Fair | Yes |
#Pages and cursors
Start with page=1 and no cursor. For the next page, send the same q and country with page set to next_page and cursor set to next_cursor from the last result.
- A later page without a cursor, a cursor from a different search or page, or a cursor in the wrong format returns
422. - A cursor Poshmark doesn't accept fails the job with
error.coderejected. It costs nothing. - When
next_cursoris null, you're on the last page. You can request at most 100 pages. page_sizecounts the rows Poshmark returned before we removed listings that aren't sold. Socountcan be smaller.- Results are in Poshmark's order, and
reported_totalmay be capped. - If Poshmark finds no matches, we drop the unrelated suggestions it shows and return an empty page.
In the Try it panel below, set page and paste next_cursor into cursor to get a later page. The dashboard Playground has a Next page button that does this for you.
curl -G "https://api.soldgraph.com/v1/poshmark/sold" \ -H "Authorization: Bearer $SOLDGRAPH_KEY" \ --data-urlencode "q=YOUR SEARCH" \ --data-urlencode "page=2" \ --data-urlencode "cursor=NEXT_CURSOR_FROM_PAGE_1"#Price summary
summary is plain maths over the rows on the page: how many show a price, the median, the lowest and the highest, plus the oldest and newest sold dates.
- Prices are asking prices, as on every Poshmark row.
- Sold dates are Pacific-time dates, the same as
sold_date. - Nothing is removed from
data. The summary counts rows; it never filters them. - It covers one page. Page through to cover more.
#Example response
{ "request_id": "00000000-0000-4000-8000-000000000001", "status": "complete", "credits": 1, "cached": false, "result": { "provider": "poshmark", "country": "us", "query": "Levis 501", "page": 1, "page_size": 48, "count": 1, "reported_total": 1, "next_page": null, "collected_at": "2026-09-23T14:02:11Z", "schema_version": 2, "completeness": "provider_page_only", "summary": { "priced_count": 1, "currency": "USD", "median": 35, "low": 35, "high": 35, "p25": 35, "p75": 35, "earliest_sold_date": "2026-09-28", "latest_sold_date": "2026-09-28" }, "data": [ { "id": "000000000000000000000001", "title": "Example Levi’s 501 jeans", "link": "https://poshmark.com/listing/000000000000000000000001", "displayed_price": { "amount": 35, "currency": "USD" }, "displayed_price_text": "$35.00", "sold_date": "2026-09-28", "sold_date_text": "2026-09-28T22:16:54-07:00", "condition": "ug", "seller_text": "closetofkate", "brand": "Levi's", "size": "32", "image": "https://di2ponv0v5otw.cloudfront.net/posts/example.jpg" } ], "field_notes": "Displayed prices are listing asks, not verified transaction or accepted-offer amounts. sold_date_text is the inventory sold_out status change time. Only listings with sold_out inventory are included.", "next_cursor": null }}| Field | Type | Description |
|---|---|---|
request_id | string | ID of this request. Poll it at /v1/jobs/{request_id}. |
status | string | pending, complete or failed. Always check it, even on HTTP 200. |
credits | integer | Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed. |
cached | boolean | True when the result came from the 15-minute cache. |
poll_url | string | Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL. |
error.code | string | Only when failed. See failed job codes. |
error.message | string | Only when failed. What the code means, in plain words. |
result | object | Only when complete. One source page from the marketplace. |
result.provider | string | Marketplace ID, like ebay or poshmark. |
result.country | string | The country searched: us, or on eBay the country you sent. |
result.query | string | The q you sent, with extra spaces removed. |
result.page | integer | The page you asked for. |
result.count | integer | Rows in result.data on this page. |
result.reported_total | integer | Total matches the marketplace reports for the search. It may be rounded or capped. |
result.next_page | integer | null | Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served. |
result.collected_at | string | When we collected the page, as an ISO 8601 timestamp. |
result.schema_version | integer | Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning. |
result.completeness | string | provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only. |
result.field_notes | string | Plain-text notes on how to read this page's fields. |
result.page_size | integer | Rows Poshmark returned before we removed listings that aren't sold. It can be larger than count. |
result.summary | object | Price maths over the rows on this page: priced_count, currency, median, low, high, p25, p75, earliest_sold_date and latest_sold_date. No row is removed from data. Rows with no single readable price are left out of the maths. |
result.next_cursor | string | null | Send this as cursor, with page=next_page, to get the next page. Null on the last page. |
result.data[].id | string | The marketplace's listing ID. |
result.data[].title | string | null | Listing title as shown. |
result.data[].link | string | URL of the listing on the marketplace. |
result.data[].displayed_price | object | { amount, currency } of the listing's asking price, in the country's currency. Not what the buyer paid. |
result.data[].displayed_price_text | string | null | The price text as shown, like $189.00, or C$40.00 on Poshmark Canada. |
result.data[].sold_date | string | Date part of sold_date_text, as YYYY-MM-DD. |
result.data[].sold_date_text | string | When the listing's inventory changed to sold out, as an ISO 8601 timestamp. Not a verified sale time. |
result.data[].condition | string | null | Poshmark's own condition code, as Poshmark returns it, like nwt or ug. See condition codes. |
result.data[].seller_text | string | null | The seller's Poshmark username. |
result.data[].brand | string | null | Brand as the seller entered it. |
result.data[].size | string | null | Size as the seller entered it. |
result.data[].image | string | null | Image URL on Poshmark's image CDN. |
The nwt filter can also return legacy ret (Boutique) rows. We observed this in live sold search; Poshmark announced conversion of Boutique listings to NWT. Returned condition codes are preserved rather than rewritten.
Overviews: eBay sold listings API · findCompletedItems alternative · Poshmark sold listings API · Mercari sold listings API · Pokémon card price API · Sold comps API for reseller apps