Ege Carpets APIegecarpets.com ↗
Access Ege Carpets product listings and full specifications — materials, weight, structure, backing, colors — via two structured endpoints.
What is the Ege Carpets API?
The Ege Carpets API provides structured access to egecarpets.com's full product catalog across 2 endpoints. list_products returns paginated product summaries including collection, concept, designer, and available color variants, while get_product_details delivers per-product specifications such as material, weight, structure, backing, tile dimensions, and design freedom availability. Together the endpoints cover Rugs, Wall-to-wall, and Tiles and Planks product types.
curl -X GET 'https://api.parse.bot/scraper/6384230e-f5f9-4bec-a2ce-274792ef5c24/list_products?skip=0&take=5&concept=HIGHLINE&sort_by=relevance&collection=Abstract&search_term=Carved&product_type=Wall-to-wall' \ -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 egecarpets-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.
"""Ege Carpets: browse the product catalog, filter by concept, and inspect specifications."""
from parse_apis.ege_carpets_product_api import EgeCarpets, Concept, ProductType, Sort, ProductNotFound
client = EgeCarpets()
# List HIGHLINE concept products sorted A-Z, capped at 5 items.
for product in client.products.search(concept=Concept.HIGHLINE, sort_by=Sort.A_Z, limit=5):
print(product.name, product.product_type, product.color)
# Drill into the first product's detail page for full specifications.
product = client.products.search(concept=Concept.REFORM, product_type=ProductType.TILES_AND_PLANKS, limit=1).first()
if product:
detail = product.details.get()
print(detail.name, detail.design_id, detail.product_image)
for quality in detail.specifications.qualities:
print(quality.material, quality.weight, quality.structure)
for color in detail.available_colors[:3]:
print(color.name, color.design_id, color.selected)
# Typed error handling: attempt to fetch details for a known-bad path.
try:
bad = client.products.search(search_term="nonexistent_xyz_404", limit=1).first()
if bad:
bad.details.get()
except ProductNotFound as exc:
print(f"Product not found: {exc.product_path}")
print("exercised: products.search / product.details.get / ProductNotFound")
List carpet products from Ege Carpets with pagination and optional filtering. Returns product summaries including name, design ID, product type, color, concept, collection, designer, and available color variants. Supports filtering by collection, concept, and product type. Results are paginated via skip/take parameters. The total catalog is ~900 products; content results (non-product items) are excluded from the returned array.
| Param | Type | Description |
|---|---|---|
| skip | integer | Number of products to skip for pagination. |
| take | integer | Number of products to return per page (max 60). |
| concept | string | Filter by concept name. |
| sort_by | string | Sort order for results. |
| collection | string | Filter by collection name (e.g. 'A New Wave', 'Abstract', 'Industrial Landscape', 'Memory', 'Spectrum'). |
| search_term | string | Free-text search term to filter products by name or design. |
| product_type | string | Filter by product type. |
{
"type": "object",
"fields": {
"has_more": "boolean indicating more pages available",
"products": "array of product summary objects with name, product_id, product_type, color, concept, collection, designer, path, etc.",
"next_skip": "integer skip value for retrieving next page",
"total_results": "integer total results including content items",
"total_products": "integer total product-only count"
},
"sample": {
"data": {
"has_more": true,
"products": [
{
"name": "Carved Flow II Green",
"path": "/en-gb/product/wall-to-wall/HIGHLINE-Abstract-Carved--Flow--II-Green-RF55001221",
"slug": "abstract",
"color": "Green",
"image": "https://datacatalog-api.egecarpets.com/cdn-cgi/image/<OPTIONS>/media/sas/ege_valid_designs/example.png",
"concept": "HIGHLINE",
"designer": "Ege Design Studio",
"collection": "Abstract",
"product_id": "RF55001221",
"product_type": "Wall-to-wall",
"other_designs": [
{
"link": "/en-gb/product/wall-to-wall/HIGHLINE-Abstract-Carved--Flow--II-Green-RF55751220",
"color": "Beige",
"image": "https://example.com/img.png",
"designId": "RF55751220",
"displayName": "Carved Flow II Beige"
}
],
"design_freedom": true,
"product_number": "14197",
"available_colors": [
"Green:Dark"
],
"design_code_name": "Carved Flow II"
}
],
"next_skip": 3,
"total_results": 994,
"total_products": 893
},
"status": "success"
}
}About the Ege Carpets API
Product Listing
The list_products endpoint returns paginated arrays of carpet product summaries. Each object includes name, product_id, product_type, color, concept, collection, designer, and a path field used to fetch full details. Pagination is controlled with skip and take (max 60 per page); the response includes has_more, next_skip, total_products, and total_results to support full catalog traversal. You can filter results by collection (e.g. A New Wave, Abstract, Industrial Landscape), by concept, by product_type, or run a free-text search_term across name and design fields.
Product Details
The get_product_details endpoint accepts a product_path from list_products results and returns a full specification object. Returned fields include name, color, concept, designer, design_id, collection, product_type, tile (dimensions or null), product_image URL, and a design_freedom boolean indicating whether custom configuration is available for that product. This endpoint is a per-product fetch, so iterating a full catalog requires one call per product — plan accordingly for latency and call volume.
Coverage and Filters
The catalog spans three product types: Rugs, Wall-to-wall, and Tiles and Planks. Collections like Memory, Spectrum, and Abstract are filterable directly in list_products. The sort_by parameter is accepted for ordering results. Design IDs are exposed in both the listing summary and the detail response, making it straightforward to cross-reference color variants across a concept or collection.
The Ege Carpets API is a managed, monitored endpoint for egecarpets.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when egecarpets.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 egecarpets.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?+
- Build a carpet comparison tool using material, weight, and structure fields from
get_product_details - Index the full Ege Carpets catalog by collection and concept using
list_productsfilters - Identify which products support design freedom customization via the
design_freedomboolean - Generate a tile and plank specification sheet by filtering
product_typeto Tiles and Planks - Track available color variants per design by iterating
list_productsresults and matchingdesign_id - Populate an interior design sourcing database with designer attribution and collection metadata
- Synchronize a product catalog mirror by paginating with
skip,take,has_more, andnext_skip
| 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 Ege Carpets offer an official developer API?+
What does `get_product_details` return that `list_products` does not?+
list_products returns a summary per product: name, color, concept, collection, designer, product_type, and path. get_product_details adds full specifications — material, weight, structure, backing, tile dimensions, product image URL, and the design_freedom boolean — none of which appear in the listing response.How does pagination work across the full catalog?+
skip and take (up to 60) to list_products. The response includes has_more (boolean), next_skip (integer), total_products, and total_results. Iterate by advancing skip to next_skip until has_more is false. Note that total_results may be slightly higher than total_products because it includes non-product content items.