Skip to content
scrapeatlas.Dashboard

Shopping

Poshmark API

Search Poshmark listings and read listings with comments, similar listings, closet profiles, closet listings, love notes, followers, people search, search suggestions and Posh Parties.

11 endpointsx-api-key

Eleven endpoints read Poshmark’s public US marketplace: listing search with filters and sold listings, full listings with comments, closet profiles, inventories and love notes, followers, people and suggestion search, and Posh Parties with their listings, using Poshmark’s field names and cursors.

API availability: Available

Base URL · local workerhttp://localhost:3053Public API: https://api.scrapeatlas.com.
Authenticationx-api-keyCustomer key from your account. See Authentication.

Endpoints

GET/v1/poshmark/search

Search Poshmark listings

Search Poshmark listings as poshmark.com search does: by keyword, brand or department, with category, size, condition, color, price, availability (available or sold) and sort filters. Each listing returns its title, brand, size, condition, prices, likes, photos and seller. Page with cursor; since and until select listing dates.

Reference
GET/v1/poshmark/listing

Get a Poshmark listing

Get one Poshmark listing by id or poshmark.com/listing link: title, description, brand, category, size and per-size quantities, condition, current, original and first price, availability, likes, shares, photos, videos and seller, with its public comments.

Reference
GET/v1/poshmark/listing-similar

Get similar Poshmark listings

Get the listings Poshmark shows as similar to a listing (usually 16), with the same listing fields as search.

Reference
GET/v1/poshmark/profile

Get a Poshmark closet profile

Get a Poshmark closet profile by username or closet link: name, location, join date, avatar and cover photo, followers, following, listing counts, shares, orders shipped, average ship time, five-star love-note counts, items sold and vacation hold.

Reference
GET/v1/poshmark/closet

Get Poshmark closet listings

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.

Reference
GET/v1/poshmark/love-notes

Get Poshmark love notes

Get the love notes (written five-star reviews) a Poshmark closet shows on its About page: notes buyers left for the seller (received) or notes the closet left as a buyer (submitted), each with the review text, date, listing id and photo, seller and buyer.

Reference
GET/v1/poshmark/user-connections

Get Poshmark followers or following

List the followers of a Poshmark closet, or the closets it follows, with each closet’s id, username, name, avatar and follow date. Page with cursor.

Reference
GET/v1/poshmark/search-users

Search Poshmark closets

Search Poshmark people by name or username, as poshmark.com people search does, returning each closet’s id, username, name and avatar. Page with cursor.

Reference
GET/v1/poshmark/search-suggestions

Get Poshmark search suggestions

Get the keyword and brand suggestions Poshmark shows while typing a search, with each brand’s id and icon.

Reference
GET/v1/poshmark/parties

List Poshmark Posh Parties

List the current Posh Parties: upcoming, ongoing and recently ended themed shopping events, with name, theme, start time, duration, status, hosts, cover image and the listing count in each collection (Main, Host Picks and more).

Reference
GET/v1/poshmark/party-listings

Get Poshmark party listings

List the listings shared to a Posh Party, available or sold, with 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.

Reference

Quick start

Create an API key on your account page, then call the public API. Values below are placeholders.

Terminal
curl "https://api.scrapeatlas.com/v1/poshmark/search?query=nike+dunk&availability=available&sort=newest" \
  -H "x-api-key: YOUR_API_KEY"

Coverage & limits

  • Independent, stateless worker: eight concurrent operations, with up to 16 more waiting at most 8 seconds for a slot; 25-second total deadline, including the wait; at most two upstream HTTP requests per operation: one read and one shared retry on a network failure or HTTP 5xx. HTTP 429 is never retried.
  • Fixed public HTTPS origin poshmark.com (the web client’s JSON API, US marketplace). No login, cookies, browser, outbound link visits, media downloads or result storage. The service API key is never forwarded.
  • At most 16 MiB decoded JSON per operation, depth 64 and 600,000 parsed nodes.
  • Page sizes: 100 listings (default 48), 100 closets (default 50). A listing returns up to 500 comments; similar listings up to 100; love notes up to 100; suggestions up to 50; parties up to 50.
  • Filters take up to 10 comma-separated brands, sizes or colors. Prices are whole US dollars.
  • Listing times (since/until) use first_available_at, falling back to first_published_at.
Error codes
12
HTTPfailure.codeMeaning
200partialUsable data with related_matches_only, comments_incomplete, comment_limit, love_note_limit or undated_listings_skipped warnings.
400invalid_requestMissing, duplicate, malformed or unsupported parameters, a link outside poshmark.com, or parameters Poshmark rejected.
401unauthorizedMissing or invalid worker API key.
403restricted_pagePoshmark shows the data only to signed-in users.
404not_foundUnknown listing, closet or party.
429upstream_rate_limitedPoshmark rate limited the request.
502upstream_challengedPoshmark refused the public request or answered with a page instead of JSON.
502unsupported_pageMalformed or mismatched source data.
502response_too_large payload_too_complexResponse exceeded byte or parsing limits.
502unsafe_redirect request_limit upstream_errorBounded source retrieval could not complete.
503busyAll worker slots and the waiting queue are occupied.
504timeoutTotal request deadline expired.