Alghrbiastore APIalghrbiastore.com ↗
Access product listings, categories, and detailed product data from Al Gharbia Store (alghrbiastore.com), a Saudi electronics and accessories e-commerce store.
What is the Alghrbiastore API?
The Al Gharbia Store API provides 3 endpoints for retrieving product listings, category hierarchies, and per-product details from alghrbiastore.com, a Saudi-based electronics and accessories retailer on the Salla platform. The list_products endpoint returns paginated results with pricing, availability, and sale status, while get_product_details exposes MPN, GTIN, SKU, and HTML descriptions for individual items priced in SAR.
curl -X GET 'https://api.parse.bot/scraper/72372509-f4f7-40f9-9f56-118b2fc20de2/list_products?category_id=654731116' \ -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 alghrbiastore-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: Al Gharbia Store SDK — browse categories, list products, fetch details."""
from parse_apis.alghrbiastore_com_api import AlGharbiaStore, ProductNotFound
client = AlGharbiaStore()
# Browse categories to pick one for filtering.
category = client.categories.list(limit=5).first()
if category is None:
raise SystemExit("No categories found")
print(f"Category: {category.name} (id={category.id})")
# List products in that category; limit= caps total items fetched.
for product in client.products.list(category_id=category.id, limit=3):
print(f" {product.name} — {product.price} {product.currency} (on sale: {product.is_on_sale})")
# Drill into the first product's full details using its id.
summary = client.products.list(category_id=category.id, limit=1).first()
if summary is not None:
try:
detail = client.products.get(product_id=summary.id)
except ProductNotFound:
print(f"Product {summary.id} was removed")
else:
print(f"Detail: {detail.name}, in stock: {not detail.is_out_of_stock}")
print(f" SKU: {detail.sku}, description length: {len(detail.description)} chars")
print("exercised: categories.list / products.list / products.get")
List products with optional category filtering and pagination. Returns product names, prices, categories, availability, and rating counts. Products are ordered by the store's default sort (pinned/latest). When category_id is omitted, returns all latest products.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| limit | integer | Number of products per page, between 1 and 50. |
| category_id | string | Numeric category ID to filter products. Obtain from get_categories endpoint (the id field). When omitted, returns all latest products. |
{
"type": "object",
"fields": {
"page": "current page number",
"limit": "products per page",
"has_next": "whether more pages exist",
"products": "array of product objects with id, name, price, regular_price, sale_price, currency, is_on_sale, is_available, category, sku, image_url, url, rating_count, rating_stars"
},
"sample": {
"data": {
"page": 1,
"limit": 20,
"has_next": true,
"products": [
{
"id": "639008345",
"sku": "3010",
"url": "https://alghrbiastore.com/ar/لوحة-led-مضيئة-بعدة-الوان-قابلة-للكتابة-الضوائية-والمسح-تشاركك-مناسبتكم-واعياد-ميلادكم/p639008345",
"name": "لوحة LED مضيئة بعدة الوان قابلة للكتابة الضوائية والمسح تشاركك مناسبتكم واعياد ميلادكم",
"price": 13,
"category": "العاب اطفال",
"currency": "SAR",
"image_url": "https://cdn.salla.sa/DZEGY/78eb6c33-402e-4023-a22a-8b69dd6f3d77-472.5x500-O1cBpM2eteVuBitLJTIiZqWpE2OzGAc7YRh4u5Aq.jpg",
"is_on_sale": true,
"sale_price": 13,
"is_available": true,
"rating_count": 7,
"rating_stars": 5,
"regular_price": 49
}
]
},
"status": "success"
}
}About the Alghrbiastore API
Endpoints and Data Coverage
The API covers three operations. get_categories returns the full category tree — each category object includes an id, slug, name, url, and a sub_categories array for nested groupings. list_products accepts the category_id from that response to filter results, along with page and limit (1–50) parameters for pagination. Each product in the response carries id, name, price, regular_price, sale_price, currency (SAR), is_on_sale, is_available, category, sku, and image.
Product Detail Fields
get_product_details takes a product_id from the listing response and returns a richer record: mpn (Manufacturer Part Number), gtin (Global Trade Item Number), sku, url, name, price, currency, image_url, and is_on_sale. The description field returns HTML content as stored by the merchant. mpn and gtin are present when the merchant has supplied them and may be null otherwise.
Pagination and Sorting
Product listings default to the store's native sort order, which surfaces pinned and latest products first. When category_id is omitted, the endpoint returns all latest products across the store. The has_next boolean in the list_products response indicates whether additional pages exist, allowing straightforward sequential traversal of the full catalog.
The Alghrbiastore API is a managed, monitored endpoint for alghrbiastore.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when alghrbiastore.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 alghrbiastore.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?+
- Monitor SAR price changes and sale status across the electronics catalog using
is_on_sale,price, andregular_pricefields. - Build a product comparison tool using MPN and GTIN fields from
get_product_detailsto match items across sources. - Sync Al Gharbia Store inventory availability into an internal procurement dashboard via the
is_availablefield. - Map the full category hierarchy from
get_categoriesto power a filtered product browsing interface. - Track SKU-level catalog changes over time by paginating through
list_productsand storing snapshots. - Feed product data (name, image, price) into a price alert or deals aggregation service focused on Saudi electronics.
| 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 Al Gharbia Store have an official developer API?+
How does category filtering work in list_products?+
get_categories first to retrieve category objects, then pass the numeric id field from any category (top-level or sub-category) as the category_id parameter to list_products. Omitting category_id returns the full catalog sorted by the store's default order.Are product reviews or ratings returned by any endpoint?+
list_products response includes a rating count field, but individual review text and per-reviewer scores are not currently exposed. The API covers pricing, availability, category, SKU, and product identifiers. You can fork this API on Parse and revise it to add a review-detail endpoint.Is stock quantity exposed, or only availability status?+
is_available as a boolean and a stock status indicator in get_product_details, but numeric stock quantity is not currently returned. You can fork the API on Parse and revise it to add quantity data if the merchant's product pages surface that field.Can I retrieve products across multiple category IDs in a single request?+
list_products accepts a single category_id per call. Filtering by multiple categories simultaneously is not currently supported. You can fork this API on Parse and revise it to add multi-category filtering or a batch endpoint.