Dokhoon Bahrain APIdokhoonbahrain.com ↗
Access Dokhoon Bahrain's perfume and incense catalog via API. Retrieve product names, prices, sold quantities, and categories with pagination support.
What is the Dokhoon Bahrain API?
The Dokhoon Bahrain API exposes 2 endpoints covering the full product catalog from dokhoonbahrain.com, a Bahraini perfume and incense retailer. The list_products endpoint returns up to 15 products per page with fields including name, category, price, sale price, currency, and sold quantity. The list_categories endpoint returns the complete category tree including sub-categories, with IDs that slot directly into product filtering.
curl -X GET 'https://api.parse.bot/scraper/4b8eddce-bf76-46ef-9dd9-f4fd90b689bc/list_products?page=1&category_id=917890342' \ -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 dokhoonbahrain-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: Dokhoon Bahrain SDK — browse categories then list products."""
from parse_apis.dokhoonbahrain_com_api import DokhoonBahrain, ParseError
client = DokhoonBahrain()
# List all categories and show their sub-categories.
for cat in client.categories.list(limit=5):
subs = ", ".join(sc.name for sc in cat.sub_categories) or "(none)"
print(f"{cat.name}: {subs}")
# Pick the first category and list its products filtered by category ID.
first_cat = client.categories.list(limit=1).first()
if first_cat is not None:
for product in client.products.list(category_id=str(first_cat.id), limit=5):
print(f"{product.name} — {product.price} {product.currency} (was {product.regular_price})")
# Browse all products without a filter, with error handling.
try:
for product in client.products.list(limit=3):
sold = product.sold_quantity if product.sold_quantity is not None else 0
print(f"{product.name}: sold {sold}, {product.url}")
except ParseError as e:
print(f"Request failed: {e}")
print("exercised: categories.list / products.list (filtered + unfiltered)")
List products from the store with name, category, price, and sold quantity. Returns 15 products per page with cursor-based pagination. Optionally filter by category ID (obtainable from list_categories). When category_id is omitted, returns all products across all categories.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| category_id | string | Numeric category ID to filter products. Obtain from list_categories endpoint's id field. |
{
"type": "object",
"fields": {
"page": "current page number",
"has_next": "boolean indicating if more pages are available",
"products": "array of product objects with id, name, category, price, regular_price, sale_price, currency, sold_quantity, url"
},
"sample": {
"data": {
"page": 1,
"has_next": true,
"products": [
{
"id": "1234695112",
"url": "https://dokhoonbahrain.com/en/royal-bahraini-incense-bouquet/p1234695112",
"name": "Royal Bahraini Dukhoon Collection, each fragrance 100ml",
"price": 499,
"category": "Golden packages",
"currency": "SAR",
"sale_price": 499,
"regular_price": 2786,
"sold_quantity": 1516
},
{
"id": "1710009252",
"url": "https://dokhoonbahrain.com/en/%D8%A8%D8%AE%D9%88%D8%B1-%D8%B1%D8%B0%D8%A7%D8%B0-%D8%A7%D9%84%D8%B9%D9%88%D8%AF-%D8%A7%D9%84%D9%85%D9%84%D9%83%D9%8A/p1710009252",
"name": "بخور رذاذ العود الملكي",
"price": 70,
"category": "incense",
"currency": "SAR",
"sale_price": 70,
"regular_price": 140,
"sold_quantity": 10
}
]
},
"status": "success"
}
}About the Dokhoon Bahrain API
Endpoints and What They Return
The list_products endpoint returns paginated product listings, 15 per page, using cursor-based pagination controlled by the page integer parameter. Each product object includes id, name, category, price, regular_price, sale_price, currency, sold_quantity, and url. The has_next boolean in the response tells you whether additional pages exist, making it straightforward to walk the full catalog programmatically.
Filtering by Category
To filter products by category, first call list_categories, which returns a flat-and-nested structure: each category object carries an id, name, and a sub_categories array. Pass any id from that response as the category_id string parameter on list_products. When category_id is omitted, the endpoint returns products across all categories. Sub-category IDs work the same way as top-level ones.
Pricing and Sales Data
Each product exposes three price fields: price (the current effective price), regular_price (the standard undiscounted price), and sale_price (the promotional price when active). The currency field identifies the denomination. The sold_quantity field reflects sales volume per product, which can serve as a proxy for popularity ranking within any given category.
The Dokhoon Bahrain API is a managed, monitored endpoint for dokhoonbahrain.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when dokhoonbahrain.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 dokhoonbahrain.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 price changes on perfume products by comparing
regular_priceandsale_priceover time. - Build a popularity ranking of incense products using the
sold_quantityfield. - Sync Dokhoon Bahrain's current catalog into an internal product database using paginated
list_productscalls. - Map the full category hierarchy, including sub-categories, using
list_categoriesfor navigation or filtering UIs. - Identify discounted products by checking where
sale_pricediffers fromregular_price. - Filter products by specific category ID to power a category-scoped browsing or comparison tool.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Dokhoon Bahrain have an official developer API?+
What does the `list_categories` endpoint return, and how does it relate to product filtering?+
id, name, and a sub_categories array. The id from any category or sub-category can be passed as category_id in list_products to filter results to that segment of the catalog.Does the API return product images or detailed descriptions?+
What is the page size for `list_products` and is it configurable?+
page input to advance through results and the has_next boolean to detect when you have reached the last page.