# Macy's Product Details API Documentation

<p><strong>Macy's Product Details API Documentation</strong> Get one product by its numeric id or a public product url. The answer has the title, brand, description, full-size images, original and sale price with discount and currency, availability, rating and the published variants. Ids come unchanged from search or the categories endpoint. Availability is null when the site does not publish stock. Cost: 1 credit per successful request. Errors cost nothing.</p>

- **Documentation:** [https://scrappa.co/docs/macys-api/macys_product](https://scrappa.co/docs/macys-api/macys_product)
- **API group:** Macy's API
- **Endpoint:** `GET https://scrappa.co/api/macys/product`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | No | Numeric id from search or the categories endpoint. |
| `url` | string | No | Public Macy's product url, alternative to id. |

## Example response

```json
{
    "data": {
        "id": "28353651",
        "brand": "Brand",
        "image": "https://slimages.macysassets.com/is/image/MCY/products/1",
        "price": {
            "sale": 49.99,
            "currency": "USD",
            "original": 79.99,
            "discount_percent": 38
        },
        "title": "Dress",
        "rating": {
            "count": 120,
            "average": 4.5
        },
        "variants": [],
        "availability": {
            "text": "In stock",
            "available": true
        }
    },
    "meta": {
        "credits": 1,
        "billable": true
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | Send an id or a url. |
| 503 | Upstream Unavailable | The source did not answer. Nothing was charged. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
