# Jumia (Kenya) — 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 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/jumia-kenya/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/jumia-kenya/get-category-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/jumia-kenya/get-flash-sales \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/jumia-kenya/get-homepage-deals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/jumia-kenya/get-product-by-sku \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/jumia-kenya/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/jumia-kenya/get-product-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/jumia-kenya/list-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/jumia-kenya/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","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.