Endpoint Playground
Test Crawlora's Grailed Listing Search API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.
curl "https://api.crawlora.net/api/v1/grailed/search?department=menswear&condition=is_new&sort=heat" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | No | Free-text search query | |
| designer | string | No | Designer/brand name filter, from grailed-designers' own designers[].name field | |
| department | string | No | menswear | Department filter |
| category | string | No | Category facet filter, from grailed-categories' own categories[].value field | |
| size | string | No | Size facet filter, from grailed-categories' own sizes[].value field | |
| color | string | No | Color facet filter, from grailed-categories' own colors[].value field | |
| condition | string | No | is_new | Condition filter |
| min_price | number | No | Minimum price (inclusive), in USD | |
| max_price | number | No | Maximum price (inclusive), in USD | |
| sort | string | No | heat | Sort order, defaults to heat |
| page | integer | No | One-based page number, defaults to 1 | |
| limit | integer | No | Results per page, defaults to 24, maximum 100 |
{
"code": 200,
"msg": "OK",
"data": {
"query": "gucci",
"sort": "heat",
"page": 1,
"limit": 24,
"count": 1,
"total_results": 250601,
"total_pages": 10442,
"listings": [
{
"id": 105379689,
"title": "Chateau Marmont Gucci Tshirt Red Japan Exclusive",
"url": "https://www.grailed.com/listings/105379689",
"designers": [
"Gucci"
],
"price": 400,
"currency": "USD",
"sold": false,
"condition": "is_gently_used",
"size": "m",
"department": "menswear",
"category": "tops",
"category_path": "tops.short_sleeve_shirts",
"color": "black",
"location": "United States",
"cover_photo_url": "https://media-assets.grailed.com/prd/listing/temp/dc6e1242b28a48bba80b5a353bb8c869",
"photo_count": 7,
"follower_count": 712,
"buy_now": true,
"make_offer": true,
"seller": {
"id": 10332947,
"username": "woodlandstepps",
"total_bought_and_sold": 52,
"trusted_seller": false,
"rating_average": 4.78,
"rating_count": 9
}
}
]
}
}Public Playground
Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.
Searches or browses Grailed's (grailed.com) peer-to-peer resale marketplace for currently-active listings. q, designer, department, category, size, color, condition, min_price, and max_price are all optional and combine as an AND -- a free-text q can be combined with any of the facet filters in the same request, or every field can be omitted to browse the full active catalog by Grailed's own "heat" relevance ranking. designer accepts one of the values grailed-designers' own designers[].name field returns; department, category, size, and color accept values from grailed-categories' own departments[].value/categories[].value/sizes[].value/colors[].value fields. condition and sort are fixed, closed enums (listed below). Keyword search is Algolia's own typo-tolerant relevance ranking, not a guaranteed exact match. A query with genuinely zero matches returns a well-formed empty result rather than an error.
{
"code": 200,
"msg": "OK",
"data": {
"query": "gucci",
"sort": "heat",
"page": 1,
"limit": 24,
"count": 1,
"total_results": 250601,
"total_pages": 10442,
"listings": [
{
"id": 105379689,
"title": "Chateau Marmont Gucci Tshirt Red Japan Exclusive",
"url": "https://www.grailed.com/listings/105379689",
"designers": [
"Gucci"
],
"price": 400,
"currency": "USD",
"sold": false,
"condition": "is_gently_used",
"size": "m",
"department": "menswear",
"category": "tops",
"category_path": "tops.short_sleeve_shirts",
"color": "black",
"location": "United States",
"cover_photo_url": "https://media-assets.grailed.com/prd/listing/temp/dc6e1242b28a48bba80b5a353bb8c869",
"photo_count": 7,
"follower_count": 712,
"buy_now": true,
"make_offer": true,
"seller": {
"id": 10332947,
"username": "woodlandstepps",
"total_bought_and_sold": 52,
"trusted_seller": false,
"rating_average": 4.78,
"rating_count": 9
}
}
]
}
}curl "https://api.crawlora.net/api/v1/grailed/search" \
-H "x-api-key: $CRAWLORA_API_KEY"