# Grailed Listing API Documentation

<p><strong>Grailed Listing API Documentation</strong> Get one Grailed listing by id or url. The item has the title, full description, designers, category path, department, size, condition, price, price drops with the original price and discount, minimum price, sold data (sold date, sold price, sold shipping), shipping prices by region, all photos in full size with width and height, measurements with names in inches and centimetres, traits, styles, badges, likes, buy now and make offer flags, authentication flag, availability (available, sold, expired, deleted or unavailable) and a seller block with member since date, location, rating average and count, rating tags, items sold, active listings, followers and trust flags. Sold and deleted listings stay readable. If Grailed cannot give the full detail, the item comes from the search data with source search_index and fewer fields. A listing that does not exist is a 404. Cost: 1 credit per request, only for successful requests.

- **Documentation:** [https://scrappa.co/docs/grailed-api/grailed_listing](https://scrappa.co/docs/grailed-api/grailed_listing)
- **API group:** Grailed API
- **Endpoint:** `GET https://scrappa.co/api/grailed/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 | Listing id: the number in a Grailed listing url, e.g. 102875164. Required unless you send a url. |
| `url` | string | No | Grailed listing url, e.g. https://www.grailed.com/listings/102875164-title. Required unless you send an id. |

## Example response

```json
{
    "item": {
        "id": 102875164,
        "url": "https://www.grailed.com/listings/102875164",
        "size": "10.5",
        "sold": true,
        "likes": 20,
        "price": {
            "amount": 153,
            "currency": "USD"
        },
        "title": "Brown Suede Vibram Moccasins Boat Shoes Creepers",
        "badges": [],
        "market": "grailed",
        "photos": [
            {
                "url": "https://media-assets.grailed.com/prd/listing/37082753/25d57be691d542518dc3b967e65bb411",
                "width": 1200,
                "height": 1600
            },
            {
                "url": "https://media-assets.grailed.com/prd/listing/37082753/371cb34e7b504a4697ece0128479365c",
                "width": 1200,
                "height": 1600
            },
            {
                "url": "https://media-assets.grailed.com/prd/listing/37082753/a21ecdc0092b41d09ea60a8ed6a32c29",
                "width": 1200,
                "height": 1600
            }
        ],
        "seller": {
            "id": 200894,
            "trust": {
                "verified": false,
                "speedy_shipper": false,
                "trusted_seller": true,
                "quick_responder": false,
                "trusted_partner": false
            },
            "rating": {
                "tags": [
                    "item-as-described",
                    "fast-shipper",
                    "quick-replies"
                ],
                "count": 142,
                "average": 4.9
            },
            "location": "United States",
            "username": "lefargerd",
            "followers": 28,
            "following": 2,
            "avatar_url": null,
            "items_sold": 251,
            "country_code": "US",
            "member_since": "2016-04-08T20:38:51.994Z",
            "active_listings": 8,
            "items_bought_and_sold": 680
        },
        "source": "listing_detail",
        "styles": [],
        "traits": [
            {
                "name": "color",
                "value": "brown"
            }
        ],
        "buy_now": true,
        "pricing": {
            "price_history": [
                {
                    "amount": 170,
                    "currency": "USD"
                },
                {
                    "amount": 153,
                    "currency": "USD"
                }
            ],
            "last_drop_from": {
                "amount": 170,
                "currency": "USD"
            },
            "original_price": {
                "amount": 170,
                "currency": "USD"
            },
            "discount_percent": 10,
            "price_drop_count": 1
        },
        "reposts": 1,
        "sold_at": "2026-10-27T13:03:58.155Z",
        "category": "footwear",
        "shipping": {
            "au": {
                "amount": 50,
                "enabled": true
            },
            "ca": {
                "amount": 20,
                "enabled": true
            },
            "eu": {
                "amount": 40,
                "enabled": true
            },
            "uk": {
                "amount": 40,
                "enabled": true
            },
            "us": {
                "amount": 14.99,
                "enabled": true
            },
            "asia": {
                "amount": 40,
                "enabled": true
            },
            "other": {
                "amount": 50,
                "enabled": true
            }
        },
        "condition": {
            "key": "is_gently_used",
            "label": "Gently Used"
        },
        "designers": [
            {
                "id": 35383,
                "name": "Maine Mountain Moccasin"
            },
            {
                "id": 31737,
                "name": "New England Outerwear"
            }
        ],
        "listed_at": "2026-08-10T22:34:14.448Z",
        "created_at": "2026-08-10T22:34:00.200Z",
        "department": "menswear",
        "make_offer": true,
        "size_label": "US 10.5 / EU 43-44",
        "sold_price": {
            "amount": 137,
            "currency": "USD"
        },
        "description": "Amazing pair of hand made moccasins from New England Outerwear Company. Classic design that can be dressed up or down for everyday wear. Unique black Vibram sole gives these some character.\n\nGently used and well cared for. Some\nminor signs of wear as pictured.\n\nBrand is New England Outerwear Company. Suede upper with Vibram sole. Size is 10.5. Measurements below:\n\nLength: 12.5\u201d (sole - toe to heel)\nLength 11.5\u201d (upper - toe to heel)\n\nVisit our page for carefully chosen clothing and select items from our collection.",
        "subcategory": "Casual Leather Shoes",
        "availability": "sold",
        "measurements": [],
        "authenticated": false,
        "category_path": "footwear.leather",
        "minimum_price": null,
        "price_updated_at": "2026-08-17T21:45:54.734Z",
        "sold_shipping_price": {
            "amount": 20,
            "currency": "USD"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | Grailed has no listing for this request. This response is not billable. |
| 503 | Upstream Unavailable | Grailed could not be reached or answered with an unexpected shape. Retry later. 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)