Grailed Listing API Documentation 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.
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.
2 optional filters available.
string
Optional
Listing id: the number in a Grailed listing url, e.g. 102875164. Required unless you send a url.
1234567890
string
Optional
Grailed listing url, e.g. https://www.grailed.com/listings/102875164-title. Required unless you send an id.
https://example.com/product
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
item
meta
success
{
"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
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
Grailed has no listing for this request. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "listing"
},
"error": {
"code": "NOT_FOUND",
"message": "Grailed has no listing for this request."
},
"success": false
}Upstream Unavailable
Grailed could not be reached or answered with an unexpected shape. Retry later. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "listing"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Grailed is temporarily unavailable. 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.