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

> Search electronic parts and get instant access to pricing, stock levels, and specs from multiple distributors in one place. Browse manufacturers and categories to compare availability and find the best deals on components you need.

**Category:** E-commerce | **Website:** [octopart.com/](https://octopart.com/) | **Docs:** [parse.bot/marketplace/24934af7-c7c2-44c3-a1e6-b21c6bcfeb21/octopart-com-api](https://parse.bot/marketplace/24934af7-c7c2-44c3-a1e6-b21c6bcfeb21/octopart-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-octopart-com-api-24934af7/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_categories

Retrieve the full electronic parts category tree with parent-child hierarchy.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-octopart-com-api-24934af7/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_manufacturers

Retrieve a list of electronic part manufacturers with their aliases. Only includes manufacturers with at least 5 active parts.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-octopart-com-api-24934af7/get_manufacturers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_part_detail

Retrieve detailed information for a specific part by its Octopart part ID or manufacturer part number (MPN). Returns specs, descriptions, images, datasheets, and seller offers with pricing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code for pricing and availability. |
| `currency` | string | No | Currency code for pricing. |
| `manufacturer` | string | No | Manufacturer name to narrow MPN search results. |
| `mpn` | string | No | Manufacturer Part Number (e.g. 'RC0805FR-071K1L'). Either part_id or mpn must be provided. |
| `part_id` | string | No | Octopart part ID (e.g. '41506087'). Either part_id or mpn must be provided. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-octopart-com-api-24934af7/get_part_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","currency":"<string>","manufacturer":"<string>","mpn":"<string>","part_id":"<string>"}'
```

### search_parts

Search for electronic parts by keyword. Returns paginated results with pricing and availability from multiple distributors.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code for pricing and availability. |
| `currency` | string | No | Currency code for pricing. |
| `in_stock_only` | boolean | No | Filter to only show in-stock parts. |
| `limit` | integer | No | Maximum number of results to return. |
| `offset` | integer | No | Number of results to skip for pagination. |
| `query` | string | Yes | Search keyword (e.g. 'resistor', 'capacitor', 'Arduino'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-octopart-com-api-24934af7/search_parts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","currency":"<string>","in_stock_only":"<boolean>","limit":"<integer>","offset":"<integer>","query":"<string>"}'
```