# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-xcite-com-api-a3e7e932/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-xcite-com-api-a3e7e932/get_all_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-xcite-com-api-a3e7e932/get_brand_stores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-xcite-com-api-a3e7e932/get_homepage_featured \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-xcite-com-api-a3e7e932/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-xcite-com-api-a3e7e932/get_product_qa \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-xcite-com-api-a3e7e932/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-xcite-com-api-a3e7e932/get_product_specifications \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-xcite-com-api-a3e7e932/get_product_stock_status \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-xcite-com-api-a3e7e932/get_products_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-xcite-com-api-a3e7e932/get_store_locations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-xcite-com-api-a3e7e932/get_subcategories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-xcite-com-api-a3e7e932/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```