# Pricechecker — 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 compare products listed on PriceCheck, including internet plans, data contracts, and electronics. Retrieve detailed pricing, specifications, and contract terms, and compare multiple listings side-by-side across providers.

**Category:** E-commerce | **Website:** [pricechecker.com/](https://pricechecker.com/) | **Docs:** [parse.bot/marketplace/5096b97d-0796-4e3b-8408-842f898863da/pricechecker-com-api](https://parse.bot/marketplace/5096b97d-0796-4e3b-8408-842f898863da/pricechecker-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-pricechecker-com-api-5096b97d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### compare_plans

Compare multiple product listings side-by-side by providing their URLs. Fetches details for each URL and returns them in a single comparison array. URLs should come from search_plans or get_data_contracts results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `urls` | string | Yes | JSON-encoded array of product offer page URLs to compare (e.g. '["https://www.pricecheck.co.za/offers/123/Product-A","https://www.pricecheck.co.za/offers/456/Product-B"]') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricechecker-com-api-5096b97d/compare_plans \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":"<string>"}'
```

### get_data_contracts

Fetch products from the 'Data Contracts' category on PriceCheck, which includes mobile devices, SIM-only deals, and smartphones. Returns a page of product listing summaries from this category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricechecker-com-api-5096b97d/get_data_contracts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_isp_plans

Unified endpoint combining keyword search results for 'fiber internet' with the Data Contracts category to produce a deduplicated list of connectivity-related products. Each page adds new category results while the search portion remains stable.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for the Data Contracts category portion of results (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricechecker-com-api-5096b97d/get_isp_plans \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_plan_details

Get detailed information for a specific product listing on PriceCheck. Requires the full offer URL (obtained from search_plans or get_data_contracts results). Returns name, price, URL, and extracted specifications when available. A single round-trip per product.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the product offer page on pricecheck.co.za (e.g. from search_plans or get_data_contracts results) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricechecker-com-api-5096b97d/get_plan_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### search_plans

Full-text product search on PriceCheck South Africa. Returns a list of product listing summaries matching the keyword, each with name, price, speed (if applicable), contract terms, description, URL, and image. Omitting the query defaults to 'fiber internet'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Search keyword (e.g. 'fiber', 'broadband', 'laptop', 'smartphone') |

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