Prada API endpoint
Browses one Prada category by ID, returning every product/color variant in it. category_id is required and must be one of prada-categories' own categories[].id values. gender optionally narrows to one of prada-categories' own genders[].value values. sort selects Prada's own relevance ranking or one of its price/newest orderings. A category with no products returns a well-formed empty result rather than an error.
/prada/categorycategory_id is required, from prada-categories' own categories[].id field.
gender is optional, a gender filter. Allowed values: Woman, Man.
sort is optional, a sort order. Allowed values: suggested, price_asc, price_desc, newest. Defaults to suggested (Prada's own relevance/popularity ranking).
page is optional, a one-based page number, defaults to 1 (1 to 500).
limit is optional, results per page, defaults to 24, maximum 100.
Notable response behavior:
category_id with no products (a genuinely empty category) returns a well-formed empty result (count: 0, products: []) rather than an error.category_id also returns a well-formed empty result -- validate it against prada-categories' own categories[].id values first.pv is the value prada-product's own pv parameter expects for full product-detail data.country (top-level) and each product's currency are always US/USD -- this endpoint only ever queries Prada's US storefront.price_asc/price_desc/newest are genuinely different orderings (Prada's own sort-order indices), not a client-side re-sort of the default relevance order.| Field | Filled in, of 24 checked | Values in the sample |
|---|---|---|
| pv | 24 | “1BA038_2CX9_F0018_V_8OM” and 23 other values |
| model | 24 | 1BA274 (9), 1BA038 (7), 1BA217 (5) and 1 more |
| name | 24 | Prada Galleria large Saffiano l… (6), Prada Panier mini Saffiano leat… (5), Prada Jardinière cotton canvas… (4) and 4 more |
| product_type | 24 | Galleria (9), Jardinière (7), Panier (5) and 1 more |
| gender | 24 | median 1 entry |
| color | 24 | “Natural” and 13 other values |
| color_hex | 24 | “#F0E5D6” and 13 other values |
| material | 24 | Leather (17), Fabric (7) |
| price | 24 | 2,500 to 6,100, median 3,900 |
| currency | 24 | USD in all 24 |
| in_stock | 24 | true in 24 of 24 |
| image_url | 24 | prada.com |
| url | 24 | prada.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| category_id | string | Yes | Category ID, from prada-categories' own categories[].id field | 10062US | |
| gender | string | No | Gender filter. Allowed values: Woman, Man Allowed values: Woman, Man. | Woman | |
| sort | string | No | suggested (Prada's own relevance ranking | Sort order. Allowed values: suggested, price_asc, price_desc, newest. Defaults to suggested (Prada's own relevance ranking) Allowed values: suggested, price_asc, price_desc, newest. | price_asc |
| page | integer | No | 1 | One-based page number, defaults to 1 | 1 |
| limit | integer | No | 24 | Results per page, defaults to 24, maximum 100 | 24 |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/prada/category?category_id=10062US&gender=Woman&sort=suggested&page=1&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"category_id": "10062US",
"sort": "suggested",
"country": "US",
"page": 1,
"limit": 24,
"count": 1,
"total_results": 822,
"total_pages": 35,
"products": [
{
"pv": "1BA274_2CYS_F0002_V_YO0",
"model": "1BA274",
"name": "Prada Galleria large leather bag",
"product_type": "Galleria",
"gender": [
"Woman"
],
"color": "Black",
"color_hex": "#000000",
"material": "Leather",
"price": 6100,
"currency": "USD",
"in_stock": true,
"image_url": "https://www.prada.com/content/dam/pradabkg_products/1/1BA/1BA274/2CYSF0002/1BA274_2CYS_F0002_V_YO0_SLF.jpg",
"url": "https://www.prada.com/us/en/p/prada-galleria-large-leather-bag/1BA274_2CYS_F0002_V_YO0"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/prada.categoryResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | prada.CategoryResponse | No | ||||
| data.category_id | string | No | ||||
| data.count | integer | No | ||||
| data.country | string | No | ||||
| data.fetched_at | string | No | ||||
| data.gender | string | No | ||||
| data.limit | integer | No | ||||
| data.page | integer | No | ||||
| data.products | array | No | Product record, 13 fields: color, color_hex, currency, gender, image_url, in_stock, material, model, name, price, product_type, pv and 1 more. Described under Search Prada products API. | |||
| data.sort | string | No | ||||
| data.total_pages | integer | No | ||||
| data.total_results | integer | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/prada/category?category_id=10062US&gender=Woman&sort=suggested&page=1&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"