# Ralph Lauren Search

## Overview

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

## Description

Search Ralph Lauren products and retrieve real-time prices, availability, sizes, colors, and categories across all collections.

## 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/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search 'polo shirt men'

```json
{
  "meta": {
    "query": "polo shirt men",
    "category": "men",
    "total_pages": 21,
    "current_page": 1,
    "has_next_page": true,
    "total_results": 487
  },
  "results": [
    {
      "id": "RL948374",
      "brand": "Polo Ralph Lauren",
      "price": "$98.50",
      "title": "Classic Fit Mesh Polo Shirt",
      "colors": [
        "White",
        "Navy",
        "Polo Black",
        "Spring Navy",
        "Pale Blue Heather"
      ],
      "is_sale": false,
      "category": "Men",
      "currency": "USD",
      "image_url": "https://www.ralphlauren.com/on/demandware.static/-/Sites-rl-catalog/default/dw4e8e7f9b/images/424/948374/948374_100_L1_alt1.jpg",
      "sale_price": null,
      "price_float": 98.5,
      "product_url": "https://www.ralphlauren.com/men/clothing/shirts/classic-fit-mesh-polo-shirt/948374.html",
      "availability": "in_stock",
      "style_number": "948374",
      "sub_category": "Shirts",
      "default_color": "White",
      "is_new_arrival": false,
      "is_customizable": true,
      "sale_price_float": null
    },
    {
      "id": "RL892317",
      "brand": "Polo Ralph Lauren",
      "price": "$89.50",
      "title": "Slim Fit Performance Polo Shirt",
      "colors": [
        "Basic Sand",
        "RL Navy",
        "Cruise Navy"
      ],
      "is_sale": true,
      "category": "Men",
      "currency": "USD",
      "image_url": "https://www.ralphlauren.com/on/demandware.static/-/Sites-rl-catalog/default/dw9b2f1c3a/images/424/892317/892317_300_L1.jpg",
      "sale_price": "$62.99",
      "price_float": 89.5,
      "product_url": "https://www.ralphlauren.com/men/clothing/shirts/slim-fit-performance-polo-shirt/892317.html",
      "availability": "in_stock",
      "style_number": "892317",
      "sub_category": "Shirts",
      "default_color": "Basic Sand",
      "is_new_arrival": false,
      "is_customizable": false,
      "sale_price_float": 62.99
    },
    {
      "id": "RL763429",
      "brand": "Polo Ralph Lauren",
      "price": "$108.50",
      "title": "Custom Slim Fit Soft Cotton Polo Shirt",
      "colors": [
        "White",
        "French Blue",
        "Estate Blue",
        "Vineyard Green"
      ],
      "is_sale": false,
      "category": "Men",
      "currency": "USD",
      "image_url": "https://www.ralphlauren.com/on/demandware.static/-/Sites-rl-catalog/default/dw7a3d2e1f/images/424/763429/763429_100_L1.jpg",
      "sale_price": null,
      "price_float": 108.5,
      "product_url": "https://www.ralphlauren.com/men/clothing/shirts/custom-slim-fit-soft-cotton-polo-shirt/763429.html",
      "availability": "in_stock",
      "style_number": "763429",
      "sub_category": "Shirts",
      "default_color": "White",
      "is_new_arrival": true,
      "is_customizable": true,
      "sale_price_float": null
    }
  ]
}
```

## Documentation

## Overview
The Ralph Lauren Search API gives you structured access to the full product catalogue of Ralph Lauren, one of the world's most iconic luxury fashion brands. Query any keyword or style number and retrieve product names, live prices, sale prices, available colors, stock availability, brand sub-collection, and direct product URLs across men's, women's, kids', and home departments.

## Quickstart
```
GET https://api.piloterr.com/v2/ralphlauren/search?query=polo+shirt&category=men
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword, product name, or style number |
| `category` | string | no | Department: `men`, `women`, `boys`, `girls`, `home` |
| `page` | integer | no | Page number (default 1) |
| `max_results` | integer | no | Results per page (max 60, default 24) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `meta.total_results` | number | Total products matching the query |
| `results[].id` | string | Unique Ralph Lauren style number |
| `results[].title` | string | Full product display name |
| `results[].brand` | string | Sub-brand (Polo RL, Purple Label, etc.) |
| `results[].price` | string | Regular shelf price |
| `results[].sale_price` | string | Sale price if active |
| `results[].colors` | array | Available color names |
| `results[].availability` | string | Stock status |
| `results[].is_customizable` | boolean | Whether monogram is available |

## Notes
- Products with `is_sale: true` include both original and discounted prices
- Style numbers can be passed to the Ralph Lauren Product API

## Main use cases
- Monitor Ralph Lauren sale prices in real time to power luxury fashion price-tracking dashboards
- Build competitive intelligence tools comparing Ralph Lauren pricing across product lines
- Enrich fashion retail databases with structured Ralph Lauren catalogue data including sub-brand and fit
- Track new arrivals across men's and women's collections to identify seasonal launches
- Power recommendation engines with live Ralph Lauren inventory filtered by category and availability