# Jumia (Kenya) — 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 thousands of products on Jumia Kenya, view detailed product information and reviews, and discover flash sales and homepage deals all in one place. Filter by category, check product SKUs, and stay updated on the latest offers to find exactly what you're looking for.

**Category:** E-commerce | **Website:** [jumia.co.ke/](https://jumia.co.ke/) | **Docs:** [parse.bot/marketplace/26247965-4307-4560-aca2-3338b528cb27/jumia-co-ke-api](https://parse.bot/marketplace/26247965-4307-4560-aca2-3338b528cb27/jumia-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-jumia-co-ke-api-26247965/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_products

Lists products within a specific category with pagination. The category slug comes from list_categories. Returns the same product card shape as search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug from list_categories (e.g. 'phones-tablets', 'computing', 'health-beauty') |
| `page` | integer | No | Page number to retrieve |

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

### get_flash_sales

Returns currently active flash sale products from the dedicated flash sales page. Products include discount percentages. The selection rotates frequently.

**Estimated cost:** Metered

_No parameters required._

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

### get_homepage_deals

Scrapes the Jumia Kenya homepage for featured deal sections. Each section has a title and a list of products. Sections rotate based on current promotions.

**Estimated cost:** Metered

_No parameters required._

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

### get_product_by_sku

Retrieves basic product card information by SKU using an internal fragment endpoint. Returns core fields: name, brand, category, price, URL, slug, and image. Useful for quick lookups when only the SKU is known.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sku` | string | Yes | Product SKU (e.g. 'HP246CL59HQP0NAFAMZ') |

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

### get_product_details

Fetches detailed information for a single product by its URL slug. Returns the product name, current price, specification key-value pairs, image URLs, GTM tracking data, and canonical URL. The slug is obtained from search or category listing results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product URL slug from search or category results (e.g. 'samsung-galaxy-s23-8gb-ram-128gb-black-123456789') |

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

### get_product_reviews

Fetches customer reviews for a product identified by SKU. Returns review rating (1-5), title, text body, date, author name, and verified purchase status. The SKU comes from search or category results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sku` | string | Yes | Product SKU from search or category results (e.g. 'HP246CL59HQP0NAFAMZ') |

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

### list_categories

Returns the top-level product categories from Jumia Kenya's navigation menu. Each category has a name, URL, and slug usable with get_category_products.

**Estimated cost:** Metered

_No parameters required._

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

### search_products

Full-text search over Jumia Kenya product listings. Returns paginated results matching the query keyword. Each result includes product name, SKU, brand, category, price, URL slug, and optional rating/discount fields. Pagination is page-based; total_results may be null when the site omits the count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve |
| `query` | string | Yes | Search keyword (e.g. 'laptop', 'smartphone', 'samsung') |

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