# Poshmark Listing API Documentation

<p><strong>Poshmark Listing API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/poshmark-api/poshmark_listing](https://scrappa.co/docs/poshmark-api/poshmark_listing)
- **API group:** Poshmark API
- **Endpoint:** `GET https://scrappa.co/api/poshmark/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | No | The 24 character id at the end of a Poshmark listing url, e.g. 6ae92ff4b55223d89d84966c. Send this or url. |
| `url` | string | No | A poshmark.com or poshmark.ca listing url. A poshmark.ca url selects the Canadian site. Send this or id. |
| `country` | string | No | Poshmark site: us (poshmark.com, USD) or ca (poshmark.ca, CAD). Defaults to us. Australia and India closed in 2023. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | No listing has this id. This response is not billable. |
| 502 | Upstream Unavailable | Poshmark could not be reached or answered with an unexpected shape. This response is not billable. |
| 504 | Upstream Timeout | Poshmark did not answer in time. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)