# Ralph Lauren Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/ralphlauren/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 3 credits per call |
| **Documentation** | https://www.piloterr.com/library/ralphlauren-product |

## Description

Extract complete Ralph Lauren product details by URL or style number: price, sizes, colors, materials, care instructions, and images.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/ralphlauren/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup by style number '948374'

```json
{
  "id": "RL948374",
  "fit": "Classic Fit",
  "brand": "Polo Ralph Lauren",
  "price": "$98.50",
  "sizes": [
    "XS",
    "S",
    "M",
    "L",
    "XL",
    "XXL",
    "XXXL"
  ],
  "title": "Classic Fit Mesh Polo Shirt",
  "colors": [
    {
      "hex": "#FFFFFF",
      "name": "White"
    },
    {
      "hex": "#1B2A5E",
      "name": "Navy"
    },
    {
      "hex": "#1A1A1A",
      "name": "Polo Black"
    },
    {
      "hex": "#2C4A8C",
      "name": "Spring Navy"
    },
    {
      "hex": "#B8CDE4",
      "name": "Pale Blue Heather"
    }
  ],
  "rating": 4.6,
  "is_sale": false,
  "category": "Men",
  "currency": "USD",
  "materials": [
    "100% Cotton"
  ],
  "breadcrumb": [
    "Men",
    "Clothing",
    "Shirts",
    "Polo Shirts"
  ],
  "image_urls": [
    "https://www.ralphlauren.com/on/demandware.static/-/Sites-rl-catalog/default/dw4e8e7f9b/images/424/948374/948374_100_L1.jpg",
    "https://www.ralphlauren.com/on/demandware.static/-/Sites-rl-catalog/default/dw4e8e7f9b/images/424/948374/948374_100_L2.jpg",
    "https://www.ralphlauren.com/on/demandware.static/-/Sites-rl-catalog/default/dw4e8e7f9b/images/424/948374/948374_100_L3.jpg"
  ],
  "sale_price": null,
  "description": "An American icon, our mesh polo shirt is crafted from pure cotton and features the signature embroidered polo player. The classic fit offers a relaxed, comfortable silhouette with ribbed collar and cuffs.",
  "price_float": 98.5,
  "product_url": "https://www.ralphlauren.com/men/clothing/shirts/classic-fit-mesh-polo-shirt/948374.html",
  "availability": "in_stock",
  "is_exclusive": false,
  "style_number": "948374",
  "sub_category": "Shirts",
  "default_color": "White",
  "reviews_count": 3841,
  "thumbnail_url": "https://www.ralphlauren.com/on/demandware.static/-/Sites-rl-catalog/default/dw4e8e7f9b/images/424/948374/948374_100_L1_alt1.jpg",
  "is_new_arrival": false,
  "ships_to_store": true,
  "available_sizes": [
    "XS",
    "S",
    "M",
    "L",
    "XL",
    "XXL"
  ],
  "is_customizable": true,
  "discount_percent": null,
  "sale_price_float": null,
  "care_instructions": [
    "Machine Washable",
    "Tumble Dry Low",
    "Do Not Bleach"
  ],
  "country_of_origin": "Peru",
  "rating_distribution": {
    "1": 77,
    "2": 98,
    "3": 241,
    "4": 684,
    "5": 2741
  },
  "free_shipping_eligible": true
}
```

## Documentation

## Overview
The Ralph Lauren Product API retrieves a complete, structured product data sheet from any Ralph Lauren listing in a single API call. Pass a product URL or style number and instantly receive pricing, sale status, color variants, available sizes, fit type, materials, care instructions, and high-resolution images.

## Quickstart
```
GET https://api.piloterr.com/v2/ralphlauren/product?query=948374
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Ralph Lauren product URL or numeric style number |

## Response fields
| Field | Type | Description |
|---|---|---|
| `title` | string | Full product display name |
| `brand` | string | Ralph Lauren sub-brand |
| `price` | string | Regular shelf price |
| `sale_price` | string | Sale price if active |
| `colors` | array | Color variants with hex codes |
| `available_sizes` | array | Sizes in stock |
| `materials` | array | Fabric composition |
| `is_customizable` | boolean | Whether monogram is available |
| `image_urls` | array | High-resolution images |

## Notes
- Both product URL and style number are accepted
- Not charged for requests that return no product

## Main use cases
- Populate luxury fashion databases with complete Ralph Lauren product data including materials and fit
- Track price and sale events for specific style numbers to detect discount patterns
- Monitor size availability for high-demand styles to trigger restock alerts
- Extract color and material data for luxury fashion comparison platforms or styling apps
- Track new arrivals and exclusive releases for fashion trend dashboards