# Hondapartsnow — 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.

> Find and purchase genuine Honda parts and accessories by browsing your vehicle's year, model, and trim, or by searching parts directly and looking up components by VIN number. Manage your shopping experience with real-time cart updates and access to detailed part information across all available Honda categories.

**Category:** Automotive | **Website:** [hondapartsnow.com/](https://hondapartsnow.com/) | **Docs:** [parse.bot/marketplace/0df9f919-830e-42fd-83e4-fafa3f61392b/hondapartsnow-com-api](https://parse.bot/marketplace/0df9f919-830e-42fd-83e4-fafa3f61392b/hondapartsnow-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-hondapartsnow-com-api-0df9f919/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_available_years

Returns every model year Honda Parts Now carries, from newest to oldest. The list spans decades and is the entry point for drilling into models, trims, transmissions, and ultimately parts catalogs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hondapartsnow-com-api-0df9f919/get_available_years \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_models_by_year

Returns all Honda model names available for a given model year. Each model name can be passed to get_trims_by_year_model to continue drilling into vehicle configuration.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | integer | Yes | Model year (e.g. 2024) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hondapartsnow-com-api-0df9f919/get_models_by_year \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<integer>"}'
```

### get_part_detail

Returns full part details by OEM part number, including name, price, specifications, and vehicle fitment compatibility. Returns stale_input with kind input_not_found if the part number is not in the catalog.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `part_number` | string | Yes | OEM part number (e.g. '04715-T0A-A90') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hondapartsnow-com-api-0df9f919/get_part_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"part_number":"<string>"}'
```

### get_parts_by_category

Returns the parts list with diagram URL for a given vehicle and subcategory path. The subcategory_path value comes from the url_path field in get_vehicle_parts_categories results. Each part includes name, traffic popularity, and a relative URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `model` | string | Yes | Honda model name |
| `subcategory_path` | string | Yes | Subcategory URL path from get_vehicle_parts_categories results (e.g. 'chassis/front_brake') |
| `transmission` | string | Yes | Transmission type |
| `trim` | string | Yes | Trim configuration |
| `year` | integer | Yes | Model year (e.g. 2024) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hondapartsnow-com-api-0df9f919/get_parts_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<string>","subcategory_path":"<string>","transmission":"<string>","trim":"<string>","year":"<integer>"}'
```

### get_transmissions

Returns available transmission types for a fully specified year, model, and trim. Each transmission string can be passed along with the other vehicle fields to get_vehicle_parts_categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `model` | string | Yes | Honda model name from get_models_by_year results |
| `trim` | string | Yes | Trim configuration from get_trims_by_year_model results (e.g. '4 Door Si') |
| `year` | integer | Yes | Model year (e.g. 2024) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hondapartsnow-com-api-0df9f919/get_transmissions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<string>","trim":"<string>","year":"<integer>"}'
```

### get_trims_by_year_model

Returns body and trim configurations for a given year and model. Each trim string can be passed to get_transmissions to continue specifying the vehicle.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `model` | string | Yes | Honda model name from get_models_by_year results (e.g. 'Civic') |
| `year` | integer | Yes | Model year (e.g. 2024) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hondapartsnow-com-api-0df9f919/get_trims_by_year_model \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<string>","year":"<integer>"}'
```

### get_vehicle_parts_categories

Returns top-level parts categories and their subcategories for a fully specified vehicle configuration. Each subcategory includes a url_path that can be passed to get_parts_by_category to retrieve the parts list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `model` | string | Yes | Honda model name from get_models_by_year results |
| `transmission` | string | Yes | Transmission type from get_transmissions results (e.g. 'KA CVT', '6MT') |
| `trim` | string | Yes | Trim configuration from get_trims_by_year_model results |
| `year` | integer | Yes | Model year (e.g. 2024) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hondapartsnow-com-api-0df9f919/get_vehicle_parts_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<string>","transmission":"<string>","trim":"<string>","year":"<integer>"}'
```

### lookup_by_vin

Identifies the exact Honda vehicle configuration from a 17-character VIN. Returns vehicle year, make, model, and trim information decoded from the VIN.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `vin` | string | Yes | 17-character Vehicle Identification Number |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hondapartsnow-com-api-0df9f919/lookup_by_vin \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vin":"<string>"}'
```

### search_parts

Searches the site for parts by part number or keyword. Part number searches return direct matches with price details. Keyword searches require vehicle selection on the site and return an informational message with empty results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Part number or keyword to search (e.g. '04715-T0A-A90') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hondapartsnow-com-api-0df9f919/search_parts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```