# PCPartPicker — 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 and retrieve detailed PC component data including motherboards, specifications, and pricing across all part categories from PCPartPicker. Build custom PC configurations by looking up individual parts and comparing their specs and costs.

**Category:** E-commerce | **Website:** [pcpartpicker.com/](https://pcpartpicker.com/) | **Docs:** [parse.bot/marketplace/54bfec03-b9cd-48b7-b4cc-1a818777e48c/pcpartpicker-com-api](https://parse.bot/marketplace/54bfec03-b9cd-48b7-b4cc-1a818777e48c/pcpartpicker-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/pcpartpicker/`
**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 all part categories

Get a list of all available PC part categories with their slugs. Returns a static catalog of component categories supported by PCPartPicker.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pcpartpicker/get-all-part-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get motherboards

Get a paginated list of motherboards with specs and prices. Returns up to ~30 products per page from the full motherboard catalog. Supports text filtering via the search parameter. Paginate by incrementing page; each page returns a slice of the total count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `search` | string | No | Filter results by search term within motherboards (e.g. 'MSI', 'B650'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pcpartpicker/get-motherboards \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","search":"<string>"}'
```

### Get part details

Get full details for a specific PC part by its PCPartPicker product URL, including specifications, prices from multiple merchants, and compatibility links. Requires a full product URL obtainable from search_parts or get_motherboards results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full PCPartPicker product URL (e.g. 'https://pcpartpicker.com/product/abc123/example-part-name'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pcpartpicker/get-part-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Search parts

Search for PC parts by query across all categories. Returns up to 10 matching results with their name, category, and product URL. Results can be passed to get_part_details for full specifications.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query string (e.g. 'rtx 4090', 'ryzen 7', 'intel core i9'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pcpartpicker/search-parts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"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.