# New Balance Product

## Overview

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

## Description

Extract full New Balance product details by URL or product ID: colorways, widths, sizes, technologies, materials, and availability.

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

## Example Response

### Lookup by product ID 'M990GL6'

```json
{
  "id": "M990GL6",
  "drop": "12mm",
  "price": "$184.99",
  "sport": "Lifestyle",
  "title": "Men's 990v6",
  "rating": 4.8,
  "weight": "12.1 oz / 343.0g",
  "widths": [
    "2E",
    "D",
    "4E"
  ],
  "is_sale": false,
  "midsole": "ENCAP",
  "outsole": "Rubber",
  "category": "Men's",
  "currency": "USD",
  "breadcrumb": [
    "Men's",
    "Shoes",
    "Lifestyle Shoes",
    "990"
  ],
  "collection": "990",
  "color_code": "GL6",
  "image_urls": [
    "https://nb.scene7.com/is/image/NB/m990gl6_nb_02_i?$pdpflexf2$&qlt=80&fmt=webp&wid=880&hei=880",
    "https://nb.scene7.com/is/image/NB/m990gl6_nb_04_i?$pdpflexf2$&qlt=80&fmt=webp&wid=880&hei=880",
    "https://nb.scene7.com/is/image/NB/m990gl6_nb_05_i?$pdpflexf2$&qlt=80&fmt=webp&wid=880&hei=880"
  ],
  "sale_price": null,
  "ships_free": true,
  "description": "The 990v6 is the latest evolution of our iconic 990 series. Crafted with premium pigskin suede and mesh upper, the 990v6 offers all-day comfort with its ENCAP midsole and durable rubber outsole. Made in the USA since 1982.",
  "made_in_usa": true,
  "price_float": 184.99,
  "product_url": "https://www.newbalance.com/pd/990v6/M990GL6.html",
  "availability": "in_stock",
  "model_number": "990",
  "sub_category": "Lifestyle Shoes",
  "technologies": [
    "ENCAP midsole",
    "Pigskin suede upper",
    "Mesh breathability panels"
  ],
  "all_colorways": [
    {
      "id": "M990GL6",
      "name": "Grey/White",
      "image_url": "https://nb.scene7.com/is/image/NB/m990gl6_nb_02_i?$pdpflexf2$&qlt=80&fmt=webp&wid=440&hei=440"
    },
    {
      "id": "M990BK6",
      "name": "Black",
      "image_url": "https://nb.scene7.com/is/image/NB/m990bk6_nb_02_i?$pdpflexf2$&qlt=80&fmt=webp&wid=440&hei=440"
    }
  ],
  "reviews_count": 2147,
  "thumbnail_url": "https://nb.scene7.com/is/image/NB/m990gl6_nb_02_i?$pdpflexf2$&qlt=80&fmt=webp&wid=440&hei=440",
  "is_new_arrival": false,
  "sizes_by_width": {
    "D": [
      "7",
      "7.5",
      "8",
      "8.5",
      "9",
      "9.5",
      "10",
      "10.5",
      "11",
      "11.5",
      "12",
      "13"
    ],
    "2E": [
      "8",
      "9",
      "10",
      "11",
      "12",
      "13"
    ],
    "4E": [
      "9",
      "10",
      "11",
      "12"
    ]
  },
  "upper_material": "Pigskin Suede/Mesh",
  "default_colorway": "Grey/White",
  "sale_price_float": null,
  "rating_distribution": {
    "1": 16,
    "2": 23,
    "3": 74,
    "4": 291,
    "5": 1743
  }
}
```

## Documentation

## Overview
The New Balance Product API retrieves a complete, structured data sheet from any New Balance product listing in a single API call. Pass a product URL or product ID and receive pricing, all colorways, widths, sizes per width, technology details, materials, and high-resolution images.

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

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | New Balance product URL or product ID |

## Response fields
| Field | Type | Description |
|---|---|---|
| `id` | string | Full product ID (model + color code) |
| `all_colorways` | array | All colorways with ID and image URL |
| `widths` | array | Available width options |
| `sizes_by_width` | object | Sizes per width |
| `technologies` | array | Proprietary technologies |
| `midsole` | string | Midsole technology |
| `made_in_usa` | boolean | Made in USA flag |
| `availability` | string | Stock status |

## Notes
- Both product URL and product ID are accepted
- Not charged for requests that return no product
- `all_colorways` includes the product ID for each variant

## Main use cases
- Build sneaker availability dashboards tracking size-by-width restock events for high-demand models
- Extract midsole and material specs at scale to compare New Balance models across versions
- Power sneaker resale market tools with real-time colorway, size, and pricing data
- Track Made in USA listings for premium heritage styles
- Monitor new colorway releases on collector-grade models like the 990