# Grailed User API Documentation

Grailed User API Documentation Get a Grailed seller by username. The profile has the id, username, avatar, location, member since date, rating average and count, rating tags, items sold, items bought and sold, active listing count, followers, following and trust flags. The response also holds one page of the seller's listings: active items or sold items with sold prices, 40 per page, at most 25 pages. The username must match exactly, without regard to case. Pages beyond the last page give a 422. A seller with more than 1000 listings shows the first 1000. Set include to ratings to add the latest 25 seller ratings with rating, note, tags and the sold item. meta.partial is true when Grailed did not return the extra profile details (member since, followers); the rest of the profile is still returned. An unknown, banned or deleted user is a 404. Cost: 1 credit per request, only for successful requests. - **Documentation:** [https://scrappa.co/docs/grailed-api/grailed_user](https://scrappa.co/docs/grailed-api/grailed_user) - **API group:** Grailed API - **Endpoint:** `GET https://scrappa.co/api/grailed/user` ## 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 | | --- | --- | --- | --- | | `username` | string | Yes | Grailed username, e.g. lefargerd. Matched exactly, without regard to case. | | `status` | string | No | for_sale (default) for active listings or sold for sold items. | | `page` | integer | No | Page of listings, starting at 1. 40 per page, at most 25. | | `include` | string | No | Send ratings to add the latest 25 seller ratings. | ## Example response ```json { "meta": { "partial": false, "billable": true, "endpoint_family": "user", "ratings_available": true }, "items": [ { "id": 102874878, "url": "https://www.grailed.com/listings/102874878", "size": "xl", "sold": false, "color": "white", "likes": 36, "price": { "amount": 66, "currency": "USD" }, "title": "Aime Leon Dore Vacation Button-Up shirt", "badges": [], "market": "hype", "seller": { "id": 200894, "rating": { "count": 142, "average": 4.94 }, "username": "lefargerd", "avatar_url": null, "trusted_seller": true, "items_bought_and_sold": 680 }, "styles": [], "traits": [ { "name": "color", "value": "white" } ], "buy_now": true, "pricing": { "price_history": [ { "amount": 150, "currency": "USD" }, { "amount": 135, "currency": "USD" }, { "amount": 121, "currency": "USD" }, { "amount": 108, "currency": "USD" }, { "amount": 97, "currency": "USD" }, { "amount": 87, "currency": "USD" }, { "amount": 78, "currency": "USD" }, { "amount": 70, "currency": "USD" }, { "amount": 66, "currency": "USD" } ], "last_drop_from": { "amount": 70, "currency": "USD" }, "original_price": { "amount": 150, "currency": "USD" }, "discount_percent": 56, "price_drop_count": 8 }, "sold_at": null, "category": "tops", "location": "United States", "shipping": { "au": { "amount": 50, "enabled": true }, "ca": { "amount": 20, "enabled": true }, "eu": { "amount": 40, "enabled": true }, "uk": { "amount": 40, "enabled": true }, "us": { "amount": 10.99, "enabled": true }, "asia": { "amount": 40, "enabled": true }, "other": { "amount": 50, "enabled": true } }, "bumped_at": "2026-08-10T22:26:58.242Z", "condition": { "key": "is_gently_used", "label": "Gently Used" }, "designers": [ { "id": 1303, "name": "Aime Leon Dore" } ], "created_at": "2026-08-10T22:27:06.314Z", "department": "menswear", "make_offer": true, "sold_price": null, "cover_photo": { "url": "https://media-assets.grailed.com/prd/listing/temp/ccca0791a78748b7be6e99507d416c2b", "width": 3500, "height": 4667 }, "photo_count": 4, "category_path": "tops.button_ups", "price_updated_at": "2026-09-28T20:39:52.315Z", "measurement_count": 3, "sold_shipping_price": null } ], "status": "for_sale", "profile": { "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 }, "ratings": [ { "id": 7336275, "note": null, "tags": [ "item-as-described", "fast-shipper" ], "rating": 5, "listing": { "id": 102874803, "url": "https://www.grailed.com/listings/102874803", "size": "11", "title": "\u201cProject 0\u201d Maison Margiela x Reeboks", "designers": [ { "id": 252, "name": "Reebok" }, { "id": 2308, "name": "Maison Margiela" } ], "sold_price": { "amount": 222.99, "currency": "USD" }, "cover_photo": { "url": "https://media-assets.grailed.com/prd/listing/temp/be1696ec46e947c58c32681df936248f", "width": null, "height": null }, "category_path": "footwear.lowtop_sneakers" }, "created_at": "2026-08-25T23:36:01.321Z" } ], "success": true, "pagination": { "page": 1, "has_more": false, "per_page": 40, "total_pages": 1, "total_results": 8 } } ``` ## Errors | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. | | 422 | Page Out of Range | The page is beyond the last page of the seller. This response is not billable. | | 404 | Not Found | Grailed has no user 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)