Poshmark Listing API Documentation Read one Poshmark listing by id or url. The item has the full description, all photos in full size, price, original price and discount, size variants with stock (available, sold and reserved), brand, category path, condition, colours, likes, comments with text and username, shipping text, seller discount text and the seller handle. A sold listing shows sold, sold_at, sold_price and days_to_sell. Seller names and other private seller data are not returned. An unknown id gives a 404 and costs nothing. Cost: 1 credit per request, only for successful requests.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
3 optional filters available.
string
Optional
The 24 character id at the end of a Poshmark listing url, e.g. 6ae92ff4b55223d89d84966c. Send this or url.
1234567890
string
Optional
A poshmark.com or poshmark.ca listing url. A poshmark.ca url selects the Canadian site. Send this or id.
https://example.com/product
string
Optional
Poshmark site: us (poshmark.com, USD) or ca (poshmark.ca, CAD). Defaults to us. Australia and India closed in 2023.
US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
item
meta
country
success
{
"item": {
"id": "6ae92ff4b55223d89d84966c",
"url": "https://poshmark.com/listing/6ae92ff4b55223d89d84966c",
"size": "S",
"sold": false,
"brand": "Zara",
"likes": 0,
"price": {
"amount": 48,
"currency": "USD"
},
"sizes": [
{
"size": "S",
"quantity_sold": 0,
"quantity_reserved": 0,
"quantity_available": 1
}
],
"title": "Zara Olive Green Military Patch Long Duster Jacket",
"colors": [
"Green"
],
"images": [
{
"url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/11/02/6ae92ff4b55223d89d84966c/l_6ae93003b9dd70e489e799bc.jpg",
"thumbnail": "https://di2ponv0v5otw.cloudfront.net/posts/2026/11/02/6ae92ff4b55223d89d84966c/s_6ae93003b9dd70e489e799bc.jpg"
},
{
"url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/11/02/6ae92ff4b55223d89d84966c/l_6ae9300424cc87d28cea1801.jpg",
"thumbnail": "https://di2ponv0v5otw.cloudfront.net/posts/2026/11/02/6ae92ff4b55223d89d84966c/s_6ae9300424cc87d28cea1801.jpg"
},
{
"url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/11/02/6ae92ff4b55223d89d84966c/l_6ae930058091ef04c79ac971.jpg",
"thumbnail": "https://di2ponv0v5otw.cloudfront.net/posts/2026/11/02/6ae92ff4b55223d89d84966c/s_6ae930058091ef04c79ac971.jpg"
}
],
"seller": {
"username": "example_closet",
"picture_url": "https://di2ponv0v5otw.cloudfront.net/users/2026/02/07/8/t_698767ff3972a844fea8edaf.jpg",
"display_handle": "example_closet"
},
"shares": 0,
"sold_at": null,
"category": {
"name": "Jackets & Coats",
"slug": "Jackets_&_Coats"
},
"comments": [
{
"text": "Does this fit a size 6?",
"username": "example_buyer",
"created_at": "2026-11-03T18:15:00+00:00"
}
],
"discount": {
"amount": 81,
"percent": 62.8
},
"shipping": [
"$6.49 Shipping"
],
"condition": {
"code": "uln",
"label": "Like new"
},
"listed_at": "2026-11-04T11:51:18+00:00",
"department": "Women",
"sold_price": null,
"updated_at": "2026-11-04T12:31:57+00:00",
"description": "Stylish Zara olive green long duster jacket featuring military-inspired detailing, embroidered patches, button-front closure, pointed collar, chest pocket, and subtle contrast trim. Relaxed, oversized silhouette with side slits. Perfect for layering and adding a vintage-inspired utility look to any outfit.\n\n19.4\u201d armpit to armpit flat\n41\u201d shoulder to hem",
"home_market": "us",
"availability": "available",
"days_to_sell": null,
"category_path": [
"Women",
"Jackets & Coats",
"Utility Jackets"
],
"comments_count": 0,
"original_price": {
"amount": 129,
"currency": "USD"
},
"seller_discounts": [],
"category_features": [
{
"name": "Utility Jackets",
"slug": "Utility_Jackets"
}
],
"first_listed_price": {
"amount": 48,
"currency": "USD"
}
},
"meta": {
"billable": true,
"endpoint_family": "listing"
},
"country": "us",
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"id": [
"Send a listing id or a listing url."
]
},
"message": "The request validation failed"
}Not Found
No listing has this id. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "listing"
},
"error": {
"code": "NOT_FOUND",
"message": "Poshmark has no listing for this request."
},
"success": false
}Upstream Unavailable
Poshmark could not be reached or answered with an unexpected shape. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "listing"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Poshmark is temporarily unavailable. Please retry."
},
"success": false
}Upstream Timeout
Poshmark did not answer in time. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "listing"
},
"error": {
"code": "UPSTREAM_TIMEOUT",
"message": "Poshmark did not answer in time. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.