Poshmark

Poshmark sold listings

Search one page of Poshmark sold listings by keyword, on Poshmark US or Canada. Pages use a cursor. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.

get/poshmark/sold

Request

  • Base URL: https://api.soldgraph.com/v1
  • URL: https://api.soldgraph.com/v1/poshmark/sold
  • Auth: HTTP bearer

Query parameters

qstring required

Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.

pageinteger

Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.

min_priceinteger

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_priceinteger

Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.

marketplace'poshmark'

Optional. If sent, it must be poshmark.

country'us' | 'ca'

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

cursorstring

The previous page's next_cursor. Leave it out on page 1. Required on every later page.

Headers

Idempotency-Keystring

Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.

Response

Complete, including cache hits. Costs 1 request.

request_idstring required

ID of this request. Poll it at /v1/jobs/{request_id}.

status'pending' | 'complete' | 'failed' required

pending, complete or failed. Always check it, even on HTTP 200.

creditsinteger required

Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed.

cachedboolean required

True when the result came from the 15-minute cache.

poll_urlstring

Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL.

Changes

No recorded changes to this operation across all 1 revision of this API.