Xcite APIxcite.com ↗
Access product listings, prices, stock status, specs, reviews, categories, brand stores, and physical store locations from Xcite.com via 12 endpoints.
What is the Xcite API?
The Xcite.com API provides structured data from Kuwait's leading electronics retailer across 12 endpoints, covering everything from homepage carousels to individual product specifications. The get_product_detail endpoint alone returns price with currency and formatted values, stock status, media, and grouped content sections including specifications and description. Other endpoints handle category navigation, keyword search, Q&A, reviews, brand stores, and physical store locations with coordinates.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/ac23da3b-e20c-4403-a5e7-9d3a215579b9/get_homepage_featured' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace xcite-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Xcite Kuwait SDK — bounded, re-runnable; every call capped."""
from parse_apis.xcite_kuwait_api import Xcite, Sort, ProductNotFound
xcite = Xcite()
# Search for products by keyword
for product in xcite.products.search(query="laptop", limit=5):
print(product.name, product.price, product.currency, product.brand)
# Browse products in a category sorted by price (low to high)
for product in xcite.products.by_category(
category_url="https://www.xcite.com/laptops/c",
sort=Sort.PRICE_LOW_HIGH,
limit=3,
):
print(product.name, product.slug, product.in_stock)
# Get full product details by URL
try:
detail = xcite.productdetails.get(
product_url="https://www.xcite.com/apple-iphone-17-pro-max-6-9-256gb-blue/p"
)
print(detail.name, detail.sku, detail.brand, detail.status)
except ProductNotFound as exc:
print(f"product not found: {exc}")
# List subcategories of a top-level category
for sub in xcite.categories.subcategories(
category_url="https://www.xcite.com/laptops/c", limit=3
):
print(sub.title, sub.href)
# List physical store locations
for store in xcite.stores.list(limit=3):
print(store.name, store.address, store.governorate, store.lat, store.lng)
print("exercised: products.search / products.by_category / productdetails.get / categories.subcategories / stores.list")
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.
No input parameters required.
{
"type": "object",
"fields": {
"featured": "array of homepage component objects with type and content"
},
"sample": {
"data": {
"featured": [
{
"type": "herobanner",
"heroBanner": {
"slides": [
{
"cta": {
"url": "https://www.xcite.com/top-picks"
},
"image": {
"src": "https://cdn.media.amplience.net/i/xcite/example"
}
}
]
}
},
{
"type": "ProductCarousel",
"productCarousel": {
"heading": "Hot Deals",
"products": [
{
"sku": "666821",
"name": "Apple iPhone 17 Pro Max",
"price": {
"value": 399.9,
"currency": "KWD"
}
}
]
}
}
]
},
"status": "success"
}
}About the Xcite API
Product Data
The get_product_detail endpoint accepts a full product URL and returns a sku, name, brand, price object (with currency, value, formattedPrice, and valueUnmodified), a status string such as InStock, and a media array containing typed source URLs. Product content is grouped into a sections object with quickOverview, specifications, and description fields. For focused lookups, get_product_stock_status returns just the sku, raw status string, and a boolean in_stock field, while get_product_specifications returns the sku and an array of label/value pairs.
Search and Category Navigation
search_products accepts a query string plus optional page and limit parameters and returns matching products with name, slug, price, brand, status, and image URL. get_products_by_category works similarly but scopes results to a specific category_url; it also accepts a sort parameter with accepted values relevancy, newArrivals, priceLowHigh, and priceHighLow. Both return a products array alongside the internal category_id UUID used for the query. get_all_categories returns the full navigation hierarchy including nested children, and get_subcategories resolves a single category URL into its category_id, category_name, and direct children.
Reviews, Q&A, and Brand Data
get_product_reviews returns rating (number or null), review_count (integer or null), and a reviews array — many products carry no reviews, so null values should be handled explicitly. get_product_qa similarly returns a questions array that may be empty. get_brand_stores lists all brand stores on the platform with each brand's name, href, and logo image URL.
Store Locations
get_store_locations returns an array of physical Xcite store objects, each with id, name, timings, address, email, governorate, lat, lng, and boolean flags isOpen24, isExpress, and isClosed. This makes it possible to build store-finder features or combine geo coordinates with product availability data.
The Xcite API is a managed, monitored endpoint for xcite.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when xcite.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official xcite.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track Xcite price changes on specific SKUs using the
price.valueandprice.valueUnmodifiedfields fromget_product_detail. - Build a Kuwait electronics catalog aggregator using
get_products_by_categorywithpriceLowHighsort across multiple category URLs. - Monitor stock availability for high-demand products with
get_product_stock_statusreturning thein_stockboolean. - Generate a brand directory with store links and logos using
get_brand_stores. - Power a store-finder map by consuming
lat,lng,governorate, andtimingsfromget_store_locations. - Aggregate product specifications into a comparison tool using the
label/valuepairs fromget_product_specifications. - Feed a search ranking or relevance analysis tool using
search_productsresults with brand, price, and status fields.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Xcite have an official developer API?+
What does `get_product_detail` return beyond price and name?+
get_product_detail returns the sku, brand, a media array with typed source URLs, a price object with currency, value, formattedPrice, and valueUnmodified, a status string indicating stock state, and a sections object containing quickOverview, specifications, and description content blocks.Does the API return seller or third-party offer data alongside the Xcite listing price?+
price object in get_product_detail. It does not expose multiple seller offers or marketplace comparisons. You can fork the API on Parse and revise it to add an endpoint targeting any offer-comparison data exposed on the product page.Are review and Q&A data always available for a product?+
get_product_reviews explicitly notes that many products carry no reviews; the rating and review_count fields return null and the reviews array is empty in those cases. get_product_qa behaves the same — the questions array will be empty if no Q&A exists for the product. Code that consumes these endpoints should handle null and empty-array responses explicitly.