# Ibox — 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 Apple products available at iBox Indonesia with detailed information on variants, pricing, stock availability, and current promotions. Check installment payment options and explore the complete product catalog organized by categories.

**Category:** E-commerce | **Website:** [ibox.co.id/](https://ibox.co.id/) | **Docs:** [parse.bot/marketplace/4649890c-1d03-47b3-afbe-fb8914b27480/ibox-co-id-api](https://parse.bot/marketplace/4649890c-1d03-47b3-afbe-fb8914b27480/ibox-co-id-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-ibox-co-id-api-4649890c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_catalog

Browse products within a specific category by numeric category ID. Returns paginated product listings and category metadata (name, url_key). Category IDs are obtained from list_categories. Pagination advances via page counter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Numeric category ID (e.g., '810' for iPhone, '757' for Mac, '770' for iPad). Obtain IDs from the list_categories endpoint. |
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibox-co-id-api-4649890c/get_category_catalog \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","limit":"<integer>","page":"<integer>"}'
```

### get_installment_options

Get available installment and financing categories offered by iBox. Returns credit card installment, non-credit installment, and paylater options with their descriptions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibox-co-id-api-4649890c/get_installment_options \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_product_detail

Fetch comprehensive detail for a single product by its URL slug (url_key from search or category results). Returns full specs, media galleries, filterable attributes, variant information, and HTML description. A separate internal call fetches the description body and merges it into the response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id_or_slug` | string | Yes | Product URL slug (url_key from search_products or get_category_catalog results, e.g., 'apple-iphone-16-128gb-ultramarine'). Numeric IDs are not supported. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibox-co-id-api-4649890c/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id_or_slug":"<string>"}'
```

### get_promotions

Get current promotional banners displayed on the iBox homepage slider. Returns active promotions with titles, image URLs, link targets, and validity periods. Only the 'main' section is supported.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `section` | string | No | Banner section. Only 'main' is supported. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibox-co-id-api-4649890c/get_promotions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"section":"<string>"}'
```

### list_categories

List all top-level product categories and their subcategory hierarchies. Returns a tree where each category has children_data containing subcategories (or null for leaf nodes). Use category IDs from this response to call get_category_catalog.

**Estimated cost:** Metered

_No parameters required._

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

### search_products

Full-text search over iBox product catalog by keyword. Returns paginated results with product summaries including pricing, stock, thumbnails, and URL slugs for detail lookups. Sorting controls result ordering; pagination advances via the page counter. Each item carries a url_key suitable for get_product_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword (e.g., 'iphone 16', 'macbook air', 'airpods'). |
| `sort` | string | No | Sort order for results. |

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