AlhamadBags APIalhamadbags.com ↗
Access product listings, prices, discount data, and categories from AlhamadBags.com, a Saudi Arabian luggage and bags store, via a simple REST API.
What is the AlhamadBags API?
The AlhamadBags API provides structured access to product and category data from alhamadbags.com across 3 endpoints. Use list_products to retrieve paginated product listings with current prices, sale flags, and discount percentages in SAR, or call get_product to pull full details on a single item including SKU, brand, weight, savings amount, and promotion end date. A third endpoint, list_categories, exposes the store's full category tree for targeted filtering.
curl -X GET 'https://api.parse.bot/scraper/3a3f70dc-2662-4c29-a19e-2f73a3514857/list_products?page=1&category_id=380651155' \ -H 'X-API-Key: $PARSE_API_KEY'
List products from the store with their names, prices, categories, and sale information. Products can be filtered by category using a category_id from the list_categories endpoint. Returns paginated results with sale details including discount percentages and promotion titles.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| limit | integer | Number of products per page, between 1 and 50. |
| category_id | string | Category ID to filter products. Obtain from list_categories endpoint. When omitted, returns products from the default travel bags category. |
{
"type": "object",
"fields": {
"page": "current page number",
"count": "number of products returned in this page",
"limit": "items per page",
"products": "array of product objects with id, name, url, price, regular_price, sale_price, is_on_sale, discount_percentage, currency, category, brand, image_url, is_available, sku, and promotion_title",
"has_next_page": "whether more pages are available"
},
"sample": {
"data": {
"page": 1,
"count": 5,
"limit": 5,
"products": [
{
"id": "2022833414",
"sku": "LS-S-Deep Red",
"url": "https://alhamadbags.com/ar/حقيبة-كمبيوتر-محمول-أنيق-وعصري-مقاس-صغير/p2022833414",
"name": "حقيبة كمبيوتر محمول أنيق وعصري - مقاس صغير",
"brand": "BANDE A PART",
"price": 20,
"category": "إكسسوارات ومنظمات السفر BANDE",
"currency": "SAR",
"image_url": "https://cdn.salla.sa/zQeo/e76da2e1-253d-45f3-b81f-9a209fd0ae41-500x441.webp",
"is_on_sale": true,
"sale_price": 20,
"is_available": true,
"regular_price": 99,
"promotion_title": "عروض لفترة محدودة",
"discount_percentage": 80
}
],
"has_next_page": true
},
"status": "success"
}
}About the AlhamadBags API
Product Listings and Filtering
The list_products endpoint returns a paginated array of products, each with id, name, url, price, regular_price, sale_price, is_on_sale, discount_percentage, currency, and category. You can control pagination with the page and limit parameters (1–50 items per page). Pass a category_id obtained from list_categories to narrow results to a specific product group. The response includes has_next_page so you can walk the full catalog without guessing total page counts.
Single Product Detail
The get_product endpoint accepts a product_id from list_products results and returns an extended record. Fields beyond what the listing surface provides include sku, brand, rating, status (e.g. sale or active), weight, and savings — the SAR amount a buyer saves if the item is discounted. Sale promotions also expose a discount end date and promotion title at this level, which are not present in the list view.
Categories
The list_categories endpoint requires no inputs and returns the full category list as an array of objects containing id and name. These IDs map directly to the category_id filter on list_products, making it straightforward to enumerate categories first and then pull products segment by segment. All prices and savings figures are denominated in SAR (Saudi Riyal), reflecting the store's primary market.
The AlhamadBags API is a managed, monitored endpoint for alhamadbags.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when alhamadbags.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 alhamadbags.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 drops and discount percentages across AlhamadBags luggage inventory
- Build a price-comparison feed for Saudi Arabian travel bag retailers using SAR pricing
- Monitor which products are currently on sale using the is_on_sale flag and discount_percentage field
- Sync AlhamadBags category structure and product catalog into an internal database
- Alert users when a specific product_id shows a non-null discount end date approaching
- Aggregate brand and SKU data from get_product to build a structured product index
- Enumerate all categories via list_categories to build a site navigation or filtering UI
| 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.