# Cheki — 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 vehicles on Cheki Kenya's automotive marketplace, view detailed information about specific cars, and discover dealer profiles and inventory. Filter your vehicle search by available metadata to find exactly what you're looking for.

**Category:** Automotive | **Website:** [cheki.co.ke/](https://cheki.co.ke/) | **Docs:** [parse.bot/marketplace/caa895a8-4a84-49e4-b3a3-75a8fe47e439/cheki-co-ke-api](https://parse.bot/marketplace/caa895a8-4a84-49e4-b3a3-75a8fe47e439/cheki-co-ke-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-cheki-co-ke-api-caa895a8/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_dealer_profile

Get a specific dealer's profile details including name, membership date, description, and rating. The slug is obtained from list_dealers results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Dealer slug from list_dealers results (e.g. 'benjamin-mutua'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cheki-co-ke-api-caa895a8/get_dealer_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_search_filters_metadata

Retrieve available filter options for vehicle search. Returns lists of makes, conditions, body types, and year ranges with their values and labels. Use the returned values as inputs to search_vehicles filters.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cheki-co-ke-api-caa895a8/get_search_filters_metadata \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_vehicle_detail

Get full details for a single vehicle listing by its slug. Returns structured data including specs, description, features, seller info, and images extracted from the listing's JSON-LD metadata. The slug is obtained from search_vehicles results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Vehicle listing slug from search_vehicles results (e.g. 'toyota-passo-2019-petrol'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cheki-co-ke-api-caa895a8/get_vehicle_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### list_dealers

List registered car dealers on cheki.co.ke. Returns dealer names, slugs, membership dates, and description snippets. Paginates by page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cheki-co-ke-api-caa895a8/list_dealers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### search_vehicles

Search for vehicles on cheki.co.ke using various filters. Returns a paginated list of vehicle cards with title, price, slug, specs, and condition. At least one filter or no filters returns all available listings. Paginates by page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `body_type` | string | No | Body type filter slug. Accepted values: 'SUVs', 'Saloons', 'Hatchbacks', 'Pickups', 'Station Wagons', 'Mini-Van', 'Trucks', 'Bus', 'Bike', 'Others'. |
| `condition` | string | No | Vehicle condition filter. Accepted values: 'Fresh Import', 'Locally Used', 'New'. |
| `keyword` | string | No | Free-text search keyword (e.g. 'Prado', 'V8'). |
| `make` | string | No | Vehicle make/brand slug (e.g. 'toyota', 'nissan', 'bmw'). Use values from get_search_filters_metadata. |
| `max_price` | string | No | Maximum price in KES as a numeric string (e.g. '5000000'). |
| `min_price` | string | No | Minimum price in KES as a numeric string (e.g. '500000'). |
| `page` | integer | No | Page number for pagination. |
| `year_from` | string | No | Minimum year of manufacture (e.g. '2010'). |
| `year_to` | string | No | Maximum year of manufacture (e.g. '2025'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cheki-co-ke-api-caa895a8/search_vehicles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body_type":"<string>","condition":"<string>","keyword":"<string>","make":"<string>","max_price":"<string>","min_price":"<string>","page":"<integer>","year_from":"<string>","year_to":"<string>"}'
```