# Jumia (Uganda) — 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 products from Jumia Uganda, view detailed product information including reviews and stock availability, and discover current flash sales across different categories and sellers. Filter products by category or seller to find exactly what you're looking for on Uganda's largest online marketplace.

**Category:** E-commerce | **Website:** [jumia.ug/](https://jumia.ug/) | **Docs:** [parse.bot/marketplace/992eccfa-63ff-4f48-9c92-64755369e0ad/jumia-ug-api](https://parse.bot/marketplace/992eccfa-63ff-4f48-9c92-64755369e0ad/jumia-ug-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-ug-api-992eccfa/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_products

Browse products in a specific Jumia Uganda category. Returns paginated product listings for the given category slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category slug (e.g., 'phones-tablets', 'computing', 'electronics'). |
| `page` | integer | No | Page number for pagination. |

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

### get_flash_sales

Retrieve current flash sale products from Jumia Uganda with stock status. Returns all products currently on flash sale.

**Estimated cost:** Metered

_No parameters required._

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

### get_product_details

Fetch full details of a single product by its URL. Returns structured information from JSON-LD including price, brand, specifications, images, description, and SKU (needed for get_product_reviews).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full product URL (e.g., 'https://www.jumia.ug/apple-iphone-13-pro-max-116118472.html') or product slug ending in .html. |

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

### get_product_reviews

Fetch paginated customer reviews for a product by its SKU (obtainable from get_product_details). Returns individual reviews with ratings, titles, bodies, dates, and a summary with total ratings count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `sku` | string | Yes | Product SKU (obtainable from get_product_details response). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jumia-ug-api-992eccfa/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","sku":"<string>"}'
```

### get_seller_products

Fetch products listed by a specific seller on Jumia Uganda. Returns paginated product listings for the given seller slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `seller_slug` | string | Yes | Seller slug (e.g., 'samsung-official-store'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jumia-ug-api-992eccfa/get_seller_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","seller_slug":"<string>"}'
```

### search_products

Full-text search over Jumia Uganda product listings. Returns paginated results matching the query keyword. Each result includes price, discount, rating, and a product URL suitable for get_product_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword. |

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