# New Balance Search

## Overview

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

## Description

Search New Balance products and retrieve real-time prices, availability, colorways, widths, and sizes across footwear and apparel.

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

## Example Response

### Search 'running shoes' in mens

```json
{
  "meta": {
    "query": "running shoes",
    "category": "mens",
    "total_pages": 9,
    "current_page": 1,
    "product_type": "shoes",
    "has_next_page": true,
    "total_results": 214
  },
  "results": [
    {
      "id": "M1080V14",
      "price": "$164.99",
      "sport": "Running",
      "title": "Men's Fresh Foam X 1080v14",
      "is_sale": false,
      "category": "Men's",
      "colorway": "White/Blue Oasis",
      "currency": "USD",
      "image_url": "https://nb.scene7.com/is/image/NB/m1080wb14_nb_02_i?$pdpflexf2$&qlt=80&fmt=webp&wid=440&hei=440",
      "collection": "Fresh Foam X",
      "color_code": "WB14",
      "sale_price": null,
      "made_in_usa": false,
      "price_float": 164.99,
      "product_url": "https://www.newbalance.com/pd/mens-fresh-foam-x-1080v14/M1080V14.html",
      "availability": "in_stock",
      "model_number": "1080",
      "sub_category": "Running Shoes",
      "is_new_arrival": true,
      "available_widths": [
        "2E",
        "D",
        "4E"
      ]
    },
    {
      "id": "M990GL6",
      "price": "$184.99",
      "sport": "Lifestyle",
      "title": "Men's 990v6",
      "is_sale": false,
      "category": "Men's",
      "colorway": "Grey/White",
      "currency": "USD",
      "image_url": "https://nb.scene7.com/is/image/NB/m990gl6_nb_02_i?$pdpflexf2$&qlt=80&fmt=webp&wid=440&hei=440",
      "collection": "990",
      "color_code": "GL6",
      "sale_price": null,
      "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",
      "is_new_arrival": false,
      "available_widths": [
        "2E",
        "D",
        "4E"
      ]
    },
    {
      "id": "MFCXBK3",
      "price": "$139.99",
      "sport": "Running",
      "title": "Men's FuelCell Rebel v4",
      "is_sale": true,
      "category": "Men's",
      "colorway": "Black/White",
      "currency": "USD",
      "image_url": "https://nb.scene7.com/is/image/NB/mfcxbk3_nb_02_i?$pdpflexf2$&qlt=80&fmt=webp&wid=440&hei=440",
      "collection": "FuelCell",
      "color_code": "BK3",
      "sale_price": "$97.99",
      "made_in_usa": false,
      "price_float": 139.99,
      "product_url": "https://www.newbalance.com/pd/fuelcell-rebel-v4/MFCXBK3.html",
      "availability": "in_stock",
      "model_number": "FuelCell Rebel",
      "sub_category": "Running Shoes",
      "is_new_arrival": false,
      "available_widths": [
        "D"
      ]
    }
  ]
}
```

## Documentation

## Overview
The New Balance Search API gives you structured access to the full product catalogue of New Balance, a leading global athletic footwear and apparel brand. Query any keyword, model number, or collection name and retrieve prices, colorways, width options, stock availability, and product URLs across men's, women's, and kids' departments.

## Quickstart
```
GET https://api.piloterr.com/v2/newbalance/search?query=990v6&category=mens
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword, model number, or collection name |
| `category` | string | no | Gender filter: `mens`, `womens`, `kids`, `unisex` |
| `product_type` | string | no | Type: `shoes`, `apparel`, `accessories` |
| `page` | integer | no | Page number (default 1) |
| `max_results` | integer | no | Results per page (max 72, default 24) |

## Notes
- Product IDs can be passed to the New Balance Product API
- `made_in_usa` flag identifies premium domestically produced styles

## Main use cases
- Monitor New Balance sale prices and restocks for sneaker price-tracking platforms
- Build competitive analysis tools for running, lifestyle, and training categories
- Enrich sneaker databases with structured data including model numbers and width options
- Track new colorway releases for collector-grade models like the 990 or 574
- Power e-commerce recommendation engines with live New Balance inventory