# Pccomponentes — 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 and browse PC components across categories and retrieve detailed product information including technical specifications, pricing, availability, and customer reviews. Ideal for comparing hardware options across processors, graphics cards, laptops, and more.

**Category:** E-commerce | **Website:** [pccomponentes.com/](https://pccomponentes.com/) | **Docs:** [parse.bot/marketplace/add3af42-826e-41dc-94e4-2e71c00a7b92/pccomponentes-com-api](https://parse.bot/marketplace/add3af42-826e-41dc-94e4-2e71c00a7b92/pccomponentes-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-pccomponentes-com-api-add3af42/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_products

List products from a PcComponentes category page by its URL slug. Returns structured product data extracted from category page microdata including pricing, brand, availability status, and aggregate ratings. Paginated by page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category URL slug (e.g., 'procesadores', 'tarjetas-graficas', 'portatiles') |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pccomponentes-com-api-add3af42/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>","page":"<integer>"}'
```

### get_product_details

Retrieve full product details including technical specifications parsed from the product page. Returns the product name, URL, slug, and a key-value map of hardware specifications. The specs map keys and values vary by product category (e.g., Socket/TDP for CPUs, Memory/Cores for GPUs).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_slug` | string | Yes | Product URL slug from search results or category listings (e.g., 'procesador-amd-ryzen-7-9800x3d-47-52ghz') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pccomponentes-com-api-add3af42/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_slug":"<string>"}'
```

### get_product_reviews

Retrieve user reviews and an AI-generated opinion summary for a product. Returns individual reviews with ratings (general and price-quality), recommendation status, and free-text pros/cons. The summary object contains machine-generated advantages, disadvantages, and an overall summary paragraph. Products without reviews return an empty reviews array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_slug` | string | Yes | Product URL slug (e.g., 'tarjeta-grafica-msi-geforce-rtx-5060-ti-ventus-2x-oc-plus-8gb-gddr7-reflex-2-rtx-ai-dlss4') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pccomponentes-com-api-add3af42/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_slug":"<string>"}'
```

### search_products

Full-text search across PcComponentes product catalog. Returns paginated product summaries with pricing, ratings, delivery estimates, and category info. Sorting options: relevance (default), price ascending, price descending. Each result includes a slug for drilling into full specs via get_product_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `page_size` | integer | No | Number of results per page. |
| `query` | string | Yes | Search keyword (e.g., 'nvidia rtx', 'portatil gaming', 'procesador amd') |
| `sort` | string | No | Sort order for results. |

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