# Shop Boeing — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Browse and search Boeing's online parts catalog. Retrieve product details, technical specifications, shipping attributes (hazmat, ITAR, ECCN), categories, brands, and suppliers for parts available on shop.boeing.com.

**Category:** E-commerce | **Website:** [shop.boeing.com/](https://shop.boeing.com/) | **Docs:** [parse.bot/marketplace/e363f8b5-4d3d-4f72-93bb-6eb6e11af02e/shop-boeing-com-api](https://parse.bot/marketplace/e363f8b5-4d3d-4f72-93bb-6eb6e11af02e/shop-boeing-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-shop-boeing-com-api-e363f8b5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category

Get category details including subcategories and total product count. Returns the category name, slug, subcategory list, and total number of products within the category hierarchy.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Category slug identifying the top-level category |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shop-boeing-com-api-e363f8b5/get_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>"}'
```

### get_homepage

Retrieve the Shop Boeing homepage content including top-level navigation categories. Returns the same data as list_product_categories.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shop-boeing-com-api-e363f8b5/get_homepage \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_overstock_parts

Return parts tagged as overstock (excess inventory) including products, pagination info, and facets for filtering. Overstock parts are available at reduced lead times.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-indexed) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shop-boeing-com-api-e363f8b5/get_overstock_parts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_part_details

Retrieve full product details for a part identifier. Returns comprehensive metadata including classifications, breadcrumbs, stock information, certifications, and shipping flags. The part_id format is SUPPLIER_PARTNUMBER where supplier prefix is one of BDI, BDSIS4, or BPP. Discoverable via search_parts results code field.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `part_id` | string | Yes | Part identifier in format SUPPLIER_PARTNUMBER (e.g. 'BDSIS4_3039524-1', 'BDI_AN6237-1=20'). Discoverable via search_parts results code field. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shop-boeing-com-api-e363f8b5/get_part_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"part_id":"<string>"}'
```

### get_part_shipping_details

Extract shipping and export control details for a part including hazmat classification, ITAR control status, ECCN (Export Control Classification Number), and dry ice shipping requirements. A focused subset of the full product details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `part_id` | string | Yes | Part identifier in format SUPPLIER_PARTNUMBER (e.g. 'BDSIS4_3039524-1'). Discoverable via search_parts results code field. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shop-boeing-com-api-e363f8b5/get_part_shipping_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"part_id":"<string>"}'
```

### get_part_technical_info

Extract technical information for a part including lead time in days, ATA chapter and number, manufacturer certification status, and aircraft compatibility (makes and models). A focused subset of the full product details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `part_id` | string | Yes | Part identifier in format SUPPLIER_PARTNUMBER (e.g. 'BDSIS4_3039524-1'). Discoverable via search_parts results code field. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shop-boeing-com-api-e363f8b5/get_part_technical_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"part_id":"<string>"}'
```

### get_search_autocomplete

Retrieve search autocomplete suggestions for a partial term. Returns up to 6 suggestion objects, each with a value field containing the suggested search term.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `term` | string | Yes | Partial search term to autocomplete (e.g. 'bolt', 'hydraulic', 'seal') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shop-boeing-com-api-e363f8b5/get_search_autocomplete \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"term":"<string>"}'
```

### get_subcategory

Get subcategory details given parent category and subcategory slugs. Returns the subcategory name, parent reference, total product count, and any sub-subcategories available for further drill-down.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Parent category slug (e.g. 'airframe-parts') |
| `subcategory_id` | string | Yes | Subcategory slug within the parent category (e.g. 'filters', 'aircraft-doors', 'aviation-fuel-systems') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shop-boeing-com-api-e363f8b5/get_subcategory \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","subcategory_id":"<string>"}'
```

### list_brands

List all available brands in the Boeing parts catalog. Each brand includes a display name, product count, and query string for filtering search results by that brand.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shop-boeing-com-api-e363f8b5/list_brands \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_product_categories

Return all top-level product categories available in the Boeing parts catalog. Each category includes a display name, product count, and query string usable for filtering.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shop-boeing-com-api-e363f8b5/list_product_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_suppliers

List all available suppliers in the Boeing parts catalog. Returns supplier names with product counts and query strings for filtering. The three main suppliers are Boeing Distribution (formerly Aviall), Commercial Spares, and Boeing Distribution Services.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shop-boeing-com-api-e363f8b5/list_suppliers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_parts

Search the Boeing parts catalog by keyword. Returns matching products with full metadata, pagination info, and facets for filtering. Some broad queries may time out upstream; use specific terms when possible. Each product includes code (the part identifier), name, description, stock info, and category assignments.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-indexed) |
| `page_size` | integer | No | Results per page |
| `query` | string | Yes | Search keyword (e.g. 'filter', 'hydraulic', 'seal') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shop-boeing-com-api-e363f8b5/search_parts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","query":"<string>"}'
```