Grailed · Search listings

Search listings on Grailed by name, designer or category

Cost

1 credit/req

≈ 500 requests / month on the Free plan

See pricing

Latency · 24h

Success rate · 24h

Endpoint

GEThttps://api.pckt.sh/v1/grailed/search
gRPCgrpc.pckt.sh:443 pckt.api.v1.GrailedService/Search

Parameters

Query parameters

NameTypeExample
query*stringRick Owens
pageinteger0
per_pageinteger20

Responses

200A successful response.
defaultAn unexpected error response.
401Missing or invalid API key.
403Your plan doesn't include gRPC access — try this endpoint over HTTP instead.
404The requested resource could not be found.
422One or more parameters are missing or invalid.
426Rate limit exceeded, or your organization is out of credits.

Example request

terminal
terminal (gRPC)

Example response

16 keys
"response": {
"hits": [
0: {
"badges": [1 item],
"bumped_at": "2026-11-11T20:51:05.752Z",
"buynow": true,
"category_path_size": "footwear.lowtop_sneakers.12",
"category_path": "footwear.lowtop_sneakers",
"category_size": "footwear.12",
"category": "footwear",
"color": "black",
"condition": "is_used",
"cover_photo": {10 keys},
"created_at_i": 1794430273,
"created_at": "2026-11-11T20:51:13.193Z",
"deleted": false,
"department": "menswear",
"designer_names": "Rick Owens",
"designers": [1 item],
"dropped": false,
"followerno": 14,
"heat_f": 4720.74971603317,
"id": 112042280,
"location": "United States",
"makeoffer": true,
"marketplace": "grailed",
"price_drops": [1 item],
"price_i": 475,
"price_updated_at_i": 1794430273,
"price_updated_at": "2026-11-11T20:51:13.193Z",
"price": 475,
"repost_id": null,
"size": "12",
"sold_at": null,
"sold": false,
"strata": "grailed",
"styles": [1 item],
"title": "Rick Owens Porterville DRKSHDW vintage low ‘Black Milk’",
"traits": [1 item],
"user": {6 keys},
"sold_price": 0,
"sold_price_includes_shipping": null,
"sold_shipping_price": null,
"sold_at_i": 0,
"shipping": {7 keys},
"heat_recency": 9437.69207714428,
"photo_count": 7,
"measurement_count": 0,
"DZ_AH_enriched": true,
"DZ_AH_enriched_at_i": 1794430567,
"DZ_AH_tier": 200,
"DZ_cl_ntiles_0_A": 1,
"DZ_cl_ntiles_1_A": 3,
"DZ_cl_ntiles_2_A": 7,
"DZ_cl_ntiles_3_A": 15,
"DZ_cl_ntiles_4_A": 31,
"DZ_enriched_A": true,
"DZ_enriched_at_i_A": 1794430601,
"DZ_score_ntiles_0_A": 1,
"DZ_score_ntiles_1_A": 3,
"DZ_score_ntiles_2_A": 7,
"DZ_score_ntiles_3_A": 15,
"DZ_score_ntiles_4_A": 30,
"objectID": "112042280",
"_highlightResult": {8 keys}
}
],
"nbHits": 82297,
"nbSortedHits": 2000,
"page": 0,
"nbPages": 500,
"hitsPerPage": 2,
"exhaustiveNbHits": false,
"exhaustiveTypo": true,
"exhaustive": {
"nbHits": false,
"typo": true
},
"query": " ",
"params": "query=rick%20owens&hitsPerPage=2&page=0&filters=designers.id%3A32+OR+designers.id%3A583&query=+",
"appliedRelevancyStrictness": 0,
"renderingContent": {
},
"processingTimeMS": 5,
"processingTimingsMS": {
"_request": {
"roundTrip": 179
},
"fetch": {
"scanning": 3,
"total": 4
},
"total": 5
},
"serverTimeMS": 6
}

Search API reference

Search endpoints by name, description, or parameter