Depop

Depop active listings

Search one page of Depop active listings by keyword, from sellers in the US, UK, Australia or Canada, up to 100 rows. Pages use a cursor. Results are cached for 15 minutes. A cache miss returns 202 and a job to poll.

get/depop/listings

Request

  • Base URL: https://api.soldgraph.com/v1
  • URL: https://api.soldgraph.com/v1/depop/listings
  • 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'depop'

Optional. If sent, it must be depop.

country'us' | 'uk' | 'au' | 'ca'

Which country's sellers to search: us (US dollars), uk (pounds), au (Australian dollars) or ca (Canadian dollars). Results, prices, min_price and max_price use that country's currency. Optional.

condition'brand_new' | 'used_like_new' | 'used_excellent' | 'used_good' | 'used_fair'

One Depop condition: brand_new, used_like_new, used_excellent, used_good or used_fair. Rows return the same codes.

countinteger

Most rows per page. Depop can return fewer.

cursorstring

The previous page's next_cursor. Leave it out on page 1. Keep the query, filters and count the same.

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.