Grailed collection

GET https://api.api.sh/grailed/v1/collection
1 credit / call e-commerce try it in the playground →

One editorial collection: name, description, image, followers, the number of listings picked, the listings themselves (40 per page, in the collection's order; sold or removed listings drop out as on the site) and related collections. Pass next_page back as page; null on the last page.

Every response includes credits_used: the credits this call cost.

Part of the Grailed API: 12 endpoints with prices, use cases and example responses.

Parameters

nametypedescription
slugrequired string Collection slug or a grailed.com/collections/<slug> link. Example: good-vintage-under-100
page integer Page number (default 1).

Every endpoint also takes fresh, raw, fields (see lean responses and caching).

Example

curl "https://api.api.sh/grailed/v1/collection?slug=good-vintage-under-100" \
  -H "x-api-key: $APISH_KEY"

Response

A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).

Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)

{"id": 1977,"name": "Good Vintage Under $100","slug": "good-vintage-under-100","url": "https://www.grailed.com/collections/good-vintage-under-100","description": "Shop our favorite vintage pieces under $100 including '70s-'90s tees, sweatshirts, work jackets and more. ","image": "https://media-assets.grailed.com/prd/misc/7a3cecc8cd0b4a3b85f9460f004775ac","followers": 378,"shows_sold_listings": false,"published_at": "2026-10-06T20:16:35.834Z","created_at": "2026-10-06T16:47:09.171Z","total_listing_ids": 607,"page": 1,"next_page": 2,"count": 38,"listings": [{"id": 107929376,"title": "VINTAGE Abercrombie & Fitch Sweatshirt XL Red 1/4 Zip Preppy Y2K Mens","url": "https://www.grailed.com/listings/107929376","designers": [{"id": 856,"name": "Abercrombie & Fitch","slug": null}],"designer_names": "Abercrombie & Fitch","price": 87,"currency": "USD","sold": false,"sold_price": null,"sold_at": null,"sold_shipping_price": null,"size": "xl","pretty_size": null,"condition": "is_used","condition_label": "Used","department": "menswear","category": "tops","category_path": "tops.sweatshirts_hoodies","color": "red","styles": [],"strata": "basic","location": "Europe","buy_now": true,"make_offer": true,"dropped": true,"price_drops": [125,87],"followers": 15,"badges": [],"image": "https://media-assets.grailed.com/prd/listing/temp/e313751ab6e64fe3a9337f97f46e1fa2","created_at": "2026-10-06T10:53:54.504Z","bumped_at": "2026-11-05T08:19:35.728Z","price_updated_at": "2026-11-05T08:19:12.147Z","seller": {"id": 14155131,"username": "preLovedEXPO","url": "https://www.grailed.com/preLovedEXPO","avatar": "https://media-assets.grailed.com/prd/avatar/14155131/a2c6095b474d4dc996c3834734427f30","location": null,"country_code": null,"joined_at": null,"total_transactions": 179,"rating_average": 4.821428571428571,"rating_count": 28,"sold_count": null,"purchase_count": null,"review_tags": null,"listings_for_sale": null,"followers": null,"following": null,"trusted_seller": false,"verified": null,"quick_responder": null,"speedy_shipper": null,"power_seller_group": null,"on_vacation": null}},{"id": 103870218,"title": "Vintage Warhammer 40000 Space Marine Video Game Tee","url": "https://www.grailed.com/listings/103870218","designers": [{"id": 160,"name": "Vintage","slug": null}],"designer_names": "Vintage","price": 45,"currency": "USD","sold": false,"sold_price": null,"sold_at": null,"sold_shipping_price": null,"size": "xl","pretty_size": null,"condition": "is_gently_used","condition_label": "Gently used","department": "menswear","category": "tops","category_path": "tops.short_sleeve_shirts","color": "blue","styles": ["vintage"],"strata": "basic","location": "Europe","buy_now": true,"make_offer": true,"dropped": true,"price_drops": [50,45],"followers": 150,"badges": [],"image": "https://media-assets.grailed.com/prd/listing/temp/ce97424c694747bd9c2bbe357b0eb94f","created_at": "2026-08-22T20:25:04.103Z","bumped_at": "2026-09-19T20:25:05.619Z","price_updated_at": "2026-11-05T03:56:01.764Z","seller": {"id": 6155829,"username": "GreatDaniDay","url": "https://www.grailed.com/GreatDaniDay","avatar": "https://media-assets.grailed.com/prd/avatar/6155829/57e4877edf94492580dc208999ccd25b","location": null,"country_code": null,"joined_at": null,"total_transactions": 1256,"rating_average": 4.711981566820277,"rating_count": 434,"sold_count": null,"purchase_count": null,"review_tags": null,"listings_for_sale": null,"followers": null,"following": null,"trusted_seller": false,"verified": null,"quick_responder": null,"speedy_shipper": null,"power_seller_group": null,"on_vacation": null}},"… 36 more"],"related_collections": [{"id": 1976,"name": "The Techwear Edit","slug": "the-techwear-edit","url": "https://www.grailed.com/collections/the-techwear-edit","description": "Shop our favorite techwear pieces from Acronym, Junya Watanabe collaborations, Nike ACG and more.","image": "https://media-assets.grailed.com/prd/misc/056fe4a9149f4207a279c111412e0e0d","followers": 138,"shows_sold_listings": false,"published_at": "2026-09-25T20:27:51.434Z","created_at": "2026-09-25T18:00:01.687Z"},{"id": 1942,"name": "Sandals & Slides","slug": "sandals-and-slides","url": "https://www.grailed.com/collections/sandals-and-slides","description": "Shop trending sandals and slides from Birkenstock, Gucci, Lemaire and more.","image": "https://media-assets.grailed.com/prd/misc/946a67b1b6f548388dff3ce786574cde","followers": 104,"shows_sold_listings": false,"published_at": "2026-08-03T03:40:20.751Z","created_at": "2026-08-03T03:27:52.806Z"},"… 7 more"],"cached": false,"credits_used": 1}
The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.