# Xcite — 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.

> Access product listings, categories, search, reviews, specifications, brand stores, and physical store locations from Xcite.com, Kuwait's leading electronics retailer.

**Category:** E-commerce | **Website:** [xcite.com/](https://xcite.com/) | **Docs:** [parse.bot/marketplace/a3e7e932-1bc0-447a-ab6c-bf47498804d8/xcite-com-api](https://parse.bot/marketplace/a3e7e932-1bc0-447a-ab6c-bf47498804d8/xcite-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/xcite/`
**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 all categories

Extract the full navigation category tree from Xcite's site layout. Returns top-level departments (Computers & Tablets, Phones & Personal Audio, etc.) each with nested children down to leaf categories. Every node carries a title, href (relative path to category page), and optional children array.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/xcite/get-all-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get brand stores

List all brand stores featured on Xcite. Returns brand name, store page URL, and logo image URL for each brand. Useful for discovering which manufacturers have dedicated storefronts.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/xcite/get-brand-stores \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get homepage featured

Retrieve featured homepage components including hero banners, product carousels, and promotional mosaic tiles. Each component carries its type and nested content (slides, products with pricing, or tile grids). Useful for monitoring promotions and trending products without navigating individual categories.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/xcite/get-homepage-featured \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get product detail

Retrieve comprehensive product details by URL. Returns the full product record including name, brand, SKU, pricing (with original and discounted values), media gallery, specifications, quick overview with delivery options, and description HTML. A single fetch that provides everything about one product.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | Full product URL (e.g. https://www.xcite.com/apple-iphone-17-pro-max-6-9-256gb-blue/p) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/xcite/get-product-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_url":"<string>"}'
```

### Get product qa

Retrieve product Questions & Answers. Returns the SKU and an array of Q&A entries. Many products have no questions, in which case the array is empty.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | Full product URL (e.g. https://www.xcite.com/apple-iphone-17-pro-max-6-9-256gb-blue/p) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/xcite/get-product-qa \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_url":"<string>"}'
```

### Get product reviews

Retrieve product reviews and rating summary. Returns the SKU, average rating, total review count, and the reviews array. Many products have no reviews, in which case rating and review_count are null and reviews is empty.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | Full product URL (e.g. https://www.xcite.com/apple-iphone-17-pro-max-6-9-256gb-blue/p) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/xcite/get-product-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_url":"<string>"}'
```

### Get product specifications

Extract product technical specifications as label/value pairs. Returns the SKU and an array of attribute objects. Useful for comparison shopping or filtering by technical criteria.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | Full product URL (e.g. https://www.xcite.com/apple-iphone-17-pro-max-6-9-256gb-blue/p) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/xcite/get-product-specifications \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_url":"<string>"}'
```

### Get product stock status

Check product availability. Returns the SKU, raw status string from the site, and a boolean indicating whether the product is purchasable. Lightweight alternative to get_product_detail when only stock information is needed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | Full product URL (e.g. https://www.xcite.com/apple-iphone-17-pro-max-6-9-256gb-blue/p) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/xcite/get-product-stock-status \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_url":"<string>"}'
```

### Get products by category

List products in a category via Algolia search, with pagination and sorting. Returns product hits with name, slug, price, brand, stock status, image URL, and detailed attributes. The category_id is resolved internally from the provided URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_url` | string | Yes | Full category URL (e.g. https://www.xcite.com/laptops/c). Obtain valid URLs from get_all_categories endpoint. |
| `limit` | integer | No | Products per page (max 60). |
| `page` | integer | No | Page number (0-based). |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/xcite/get-products-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_url":"<string>","limit":"<integer>","page":"<integer>","sort":"<string>"}'
```

### Get store locations

Get all physical Xcite store locations in Kuwait. Returns store name, address, governorate, operating hours (timings), GPS coordinates (lat/lng), and flags for 24-hour operation, express service, and closure status.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/xcite/get-store-locations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get subcategories

Extract direct subcategories for a given category URL. Returns the category's display name, internal UUID, and its immediate children from the navigation tree. Useful for drilling into the hierarchy one level at a time.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_url` | string | Yes | Full category URL (e.g. https://www.xcite.com/laptops/c). Obtain valid URLs from get_all_categories endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/xcite/get-subcategories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_url":"<string>"}'
```

### Search products

Full-text search for products by keyword via Algolia. Returns matching product hits with name, slug, price, brand, stock status, image URL, and other attributes. Paginates via page parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Products per page (max 60). |
| `page` | integer | No | Page number (0-based). |
| `query` | string | Yes | Search keyword |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/xcite/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.