edgars.co.za APIwww.edgars.co.za ↗
Search and browse Edgars South Africa products via API. Access product details, variants, pricing, and collections from edgars.co.za.
curl -X GET 'https://api.parse.bot/scraper/d16f02a7-1995-40b4-81e5-3d8c8c14bfd2/search_products?limit=5&query=sneakers&product_type=product' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed Python client. Install the CLI, sign in, then pull this API’s generated client:
pip install parse-sdk parse login parse add --marketplace edgars-co-za-api
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: Edgars South Africa SDK — search, browse collections, get product details."""
from parse_apis.Edgars_South_Africa_API import Edgars, ProductType, ProductNotFound
client = Edgars()
# Search for products by keyword with explicit product_type enum.
for product in client.product_summaries.search(query="sneakers", product_type=ProductType.PRODUCT, limit=3):
print(product.title, product.vendor, product.price)
# Browse a collection by constructing it from its handle.
collection = client.collection(handle="women-sneakers")
first_item = collection.products(limit=1).first()
if first_item:
print(first_item.title, first_item.vendor, first_item.price)
# Drill into full product details from a collection item.
if first_item:
try:
full = first_item.details()
print(full.title, full.product_type, len(full.variants), "variants")
for variant in full.variants[:3]:
print(f" {variant.title} — R{variant.price}")
except ProductNotFound as exc:
print(f"Product gone: {exc}")
# Fetch a product directly by handle.
detail = client.products.get(handle="mens-chuck-taylor-high-sneaker-black-c2471729001")
print(detail.title, detail.vendor, len(detail.images), "images")
print("exercised: product_summaries.search / collection.products / details / products.get")
Search for products by keyword. Returns up to 10 matching products with basic info (title, price, vendor, image). Uses the store's predictive search, so partial matches and typo-tolerance may apply. Collections matching the query are also returned.
| Param | Type | Description |
|---|---|---|
| limit | integer | Max number of products to return (1-10). |
| queryrequired | string | Search keyword (e.g. 'sneakers', 'dresses', 'perfume'). |
| product_type | string | Resource type to search. Accepted values: product, collection, article, page. |
{
"type": "object",
"fields": {
"query": "string",
"products": "array of product summaries",
"collections": "array of matching collections"
},
"sample": {
"query": "sneakers",
"products": [
{
"id": 14718248780146,
"url": "/products/pre-boys-court-sneaker-white-black-39347101",
"tags": [
"Fashion",
"Kids",
"Pre-Boys",
"Shoes"
],
"image": "https://cdn.shopify.com/s/files/1/0854/9947/8299/files/39347101_3.jpg?v=1746782613",
"price": "179.99",
"title": "Pre-Boys Court Sneaker - White/Black",
"handle": "pre-boys-court-sneaker-white-black-39347101",
"vendor": "KDS",
"available": true,
"price_max": "179.99",
"price_min": "179.99",
"product_type": "Sneakers",
"compare_at_price_max": "0.00",
"compare_at_price_min": "0.00"
}
],
"collections": []
}
}About the edgars.co.za API
The Edgars South Africa API provides 3 endpoints to search, retrieve, and browse products from edgars.co.za, one of South Africa's major fashion and lifestyle retailers. Use search_products to find items by keyword with partial-match tolerance, get_product to fetch full variant and pricing details by URL handle, or list_collection_products to paginate through category groupings like 'women-sneakers', 'dresses', or 'sale'.
Endpoints and What They Return
The search_products endpoint accepts a query string and returns up to 10 product summaries alongside matching collections. Each product summary includes title, price, vendor, and image. The product_type parameter lets you narrow results to products, collections, articles, or pages. The search applies predictive matching, so partial keywords and minor typos may still return relevant results.
Full Product Detail
The get_product endpoint takes a handle — the URL slug found in search_products results — and returns the complete product record. Response fields include id, title, vendor, tags, body_html, created_at, all images, options (such as size and color), and a full variants array. Each variant carries its own pricing and availability data, making this endpoint the right choice when you need to enumerate every size-color combination for a given item.
Browsing Collections
The list_collection_products endpoint accepts a collection handle (e.g. men-sneakers, sale, dresses) and returns a paginated list of product summaries. The page parameter is 1-based and limit accepts values between 1 and 250. Collection handles are surfaced through search_products results or from Edgars site navigation, making it straightforward to systematically walk an entire category.
Coverage Notes
The API covers Edgars South Africa's online product catalog including clothing, footwear, accessories, and lifestyle goods. Prices are returned in South African Rand (ZAR). Product availability and inventory counts are not directly exposed as a dedicated field; availability is inferred from variant data returned by get_product.
The edgars.co.za API is a managed, monitored endpoint for www.edgars.co.za — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when www.edgars.co.za 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 www.edgars.co.za 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?+
- Build a ZAR-denominated price tracker for Edgars fashion categories using list_collection_products with the 'sale' collection handle.
- Aggregate product variant data (sizes, colors) across footwear collections by combining list_collection_products and get_product.
- Power a fashion comparison tool by pulling vendor, price, and title fields from search_products results.
- Monitor new arrivals in specific categories by paginating through collection handles and checking created_at timestamps.
- Enrich a product catalog with full description HTML and images using the body_html and images fields from get_product.
- Index Edgars collections for a South African shopping aggregator by walking collection handles discovered via search_products.
- Extract structured tag and option data from get_product to train a fashion attribute classifier.
| 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 | 250 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.