# Octopart — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/octopart/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/octopart/get-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/octopart/get-manufacturers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/octopart/get-part-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/octopart/search-parts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","currency":"<string>","in_stock_only":"<boolean>","limit":"<integer>","offset":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.