Ciele Athletics APIcieleathletics.com ↗
Access Ciele Athletics product inventory, variant stock levels, SKUs, pricing, and availability across the full catalog via 3 structured endpoints.
What is the Ciele Athletics API?
The Ciele Athletics API exposes product catalog and inventory data across 3 endpoints, letting you retrieve per-variant stock counts, pricing, SKUs, and availability for the full Ciele product lineup. The get_inventory_quantity endpoint returns live stock counts per variant, while list_products iterates the entire catalog with optional filtering by collection handle such as 'elite' or 'fstcap'.
curl -X GET 'https://api.parse.bot/scraper/03eea810-de93-469f-8303-88224261e495/list_products?page=1&limit=10&collection=elite' \ -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 cieleathletics-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: Ciele Athletics Inventory SDK — bounded, re-runnable; every call capped."""
from parse_apis.Ciele_Athletics_Inventory_API import CieleAthletics, ProductNotFound
client = CieleAthletics()
# List products scoped to a collection, with variant availability
for product in client.products.list(collection="elite", limit=3):
print(product.title, product.product_type)
for variant in product.variants:
print(f" {variant.title}: available={variant.available}, ${variant.price}")
# Drill down to get full inventory quantities for a specific product
item = client.products.list(limit=1).first()
try:
detail = client.products.get(handle=item.handle)
print(detail.title, detail.vendor, detail.published_at)
# Check inventory quantities
report = detail.inventory()
for v in report.variants:
print(f" {v.title} (SKU {v.sku}): {v.inventory_quantity} units, available={v.available}")
except ProductNotFound as e:
print(f"Product not found: {e.handle}")
print("exercised: products.list, products.get, product.inventory")
Retrieve products with per-variant availability status. Results are auto-iterated across pages. Optionally scope to a collection handle to narrow the catalog.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| limit | integer | Number of products per page (1–250). |
| collection | string | Collection handle to filter products (e.g. 'elite', 'fstcap'). Omit to list all products. |
{
"type": "object",
"fields": {
"page": "current page number",
"limit": "page size used",
"products": "array of product objects with variant availability"
},
"sample": {
"data": {
"page": 1,
"limit": 3,
"products": [
{
"id": 10299964129554,
"tags": [
"2026",
"blue",
"caps",
"GOCap"
],
"title": "GOCap - Field - Iconic Bar",
"handle": "gocapfield-iconic-bar-indigo",
"vendor": "ciele athletics",
"variants": [
{
"id": 51998809882898,
"sku": "056465015998",
"price": "50.00",
"title": "M/L",
"option1": "M/L",
"option2": null,
"option3": null,
"available": true,
"compare_at_price": null
}
],
"product_type": "GOCap",
"published_at": "2026-07-23T17:05:00-04:00"
}
]
},
"status": "success"
}
}About the Ciele Athletics API
Catalog and Collection Access
The list_products endpoint returns paginated product records with per-variant availability across the Ciele Athletics catalog. You can scope results to a specific collection by passing a collection handle — for example, elite or fstcap — or omit it to iterate all products. The response includes a products array, each item carrying variant availability status alongside core product metadata. Pagination is controlled via page and limit parameters, with limit accepting values from 1 to 250.
Per-Product Inventory Detail
The get_product_inventory endpoint accepts a product handle (e.g. fstcap-elite-shadowsphinx) and returns a full variant breakdown including sku, price, weight, barcode, fulfillment_service, and inventory_management status. The response also includes product-level fields: tags, vendor, options (with grouped values such as size or color), an HTML description, images_count, and an updated_at ISO 8601 timestamp. Handles are obtainable from list_products results.
Variant-Level Stock Counts
The get_inventory_quantity endpoint returns the current numeric stock count for each variant of a given product. The variants array includes id, title, sku, price, available (boolean), and inventory_quantity (integer). This is the endpoint to use when you need to distinguish between a variant that is simply unavailable and one that is fully out of stock with a zero count.
Data Scope
All three endpoints are keyed by product handle, which makes it straightforward to build a lookup pipeline: list products, extract handles, then fetch inventory detail or stock quantities as needed. Product options such as size and color are exposed as structured arrays in get_product_inventory, making it possible to map availability against specific size-color combinations.
The Ciele Athletics API is a managed, monitored endpoint for cieleathletics.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when cieleathletics.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 cieleathletics.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 per-variant stock counts for specific Ciele cap or apparel SKUs to trigger restock alerts
- Build a size availability checker that maps the
optionsarray to currentinventory_quantityper variant - Track price changes across the Ciele catalog by diffing
pricefields from repeatedlist_productscalls - Identify which collection handles (e.g. 'elite', 'fstcap') contain sold-out variants using
availableflags - Aggregate SKU and barcode data from
get_product_inventoryfor integration with an internal product database - Filter in-stock products by collection for display in a third-party storefront or comparison tool
- Audit
updated_attimestamps across products to detect recently changed listings
| 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 Ciele Athletics have an official developer API?+
What is the difference between `get_product_inventory` and `get_inventory_quantity`?+
get_product_inventory returns a broad set of variant metadata — SKU, barcode, weight, fulfillment service, inventory management status, and product options — but does not include a numeric stock count. get_inventory_quantity focuses specifically on the integer inventory_quantity per variant, along with availability status and price. Use the former for product catalog detail and the latter when you need a concrete stock number.Can I filter `list_products` results to a specific product type or tag?+
list_products endpoint supports filtering by collection handle (e.g. 'elite' or 'fstcap'). Filtering by tag, product type, or vendor is not currently supported. The API covers catalog listing and collection scoping. You can fork it on Parse and revise to add tag-based or vendor-based filtering as an additional parameter.Are product images or image URLs returned by any endpoint?+
get_product_inventory endpoint returns images_count — the number of images attached to a product — but does not return image URLs or binary data. You can fork the API on Parse and revise get_product_inventory to include the image URL array if that field is needed.How fresh is the inventory data, and is there a delay?+
updated_at field in get_product_inventory reflects the last time the product record was modified on Ciele's end. Inventory quantities in get_inventory_quantity reflect the state at the time of the request. There is no built-in change-notification or webhook mechanism; polling is the expected pattern for tracking stock changes.