cea APIcea.com.br ↗
Access C&A Brazil's product catalog via API. Search products, browse categories, get SKU details, prices, and customer reviews from cea.com.br.
What is the cea API?
The cea.com.br API gives developers access to C&A Brazil's fashion catalog through 6 endpoints covering product search, category browsing, SKU-level detail, and customer reviews. The search_products endpoint accepts keyword queries like 'camiseta' or 'vestido' and returns paginated hits with prices, images, availability, and category facets. Product IDs returned by search feed directly into get_product_details and get_product_reviews for deeper data retrieval.
curl -X GET 'https://api.parse.bot/scraper/910c4e62-0257-4468-a7c6-e63d2ef02a82/search_products?page=0&limit=3&query=camiseta' \ -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 cea-com-br-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: C&A Brazil SDK — search products, browse categories, read reviews."""
from parse_apis.c_a_brazil_api import CEA, ProductNotFound
client = CEA()
# Search for products by keyword — limit= caps total items fetched.
for product in client.products.search(query="camiseta", limit=3):
print(product.name, product.price, product.available)
# Browse by category — get women's fashion products.
for product in client.products.by_category(category_slug="moda-feminina", limit=3):
print(product.name, product.category2, product.price)
# Drill down: get full details for one product.
hit = client.products.search(query="vestido", limit=1).first()
if hit:
try:
detail = client.products.get(product_id=hit.product_id)
print(detail.product_name, detail.brand, detail.link)
except ProductNotFound as exc:
print(f"Product gone: {exc}")
# Read reviews for that product (sub-resource navigation).
if hit:
for review in hit.reviews.list(limit=3):
print(review.opinion[:60], review.rate, review.created_at)
# List top-level categories.
for cat in client.categories.list(limit=3):
print(cat.name, cat.url, cat.has_children)
print("exercised: products.search / products.by_category / products.get / reviews.list / categories.list")
Full-text search over C&A Brazil's product catalog via Algolia. Returns paginated results including product name, price, availability, images, and category hierarchy. Each hit carries a productId usable with get_product_details and get_product_reviews. Pagination is 0-indexed; nbPages in the response indicates total pages available.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed) |
| limit | integer | Number of results per page (max 48) |
| queryrequired | string | Search keyword (e.g. 'camiseta', 'calca', 'vestido') |
{
"type": "object",
"fields": {
"hits": "array of product hit objects with Name, Price, Available, Images, productId, Category1-3, Link",
"nbHits": "integer, total number of matching products",
"nbPages": "integer, total number of pages available"
},
"sample": {
"data": {
"hits": [
{
"Link": "camiseta-basica-feminina-de-algodao-peruano-manga-curta-vinho-1090429-vinho_escu",
"Name": "camiseta básica feminina de algodão peruano manga curta vinho",
"Price": 39.99,
"Images": [
"https://cea.vtexassets.com/arquivos/ids/59322075/Foto-0.jpg"
],
"OldPrice": 39.99,
"objectID": "6529502",
"Available": true,
"Category1": "Moda Feminina",
"Category2": "Roupas",
"Category3": "Blusas",
"Reference": "1090429-vinho_escu",
"SpotPrice": 39.99,
"productId": "4544838",
"item_brand": "C&A"
}
],
"nbHits": 4039,
"nbPages": 50
},
"status": "success"
}
}About the cea API
Search and Category Browsing
The search_products endpoint accepts a required query string and optional page (0-indexed) and limit parameters. It returns an algoliaProducts object containing a hits array, total result count (nbHits), page count (nbPages), and facets for filtering. The same result shape is shared by get_category_products and get_subcategory_products, which filter by category_slug (e.g. moda-feminina, moda-masculina, infantil) and optionally a subcategory_slug (e.g. roupas, calcados, moda-intima).
Product Details and SKU Data
get_product_details accepts a numeric product_id — available from search or category results — and returns a detailed product object. Key fields include productName, brand, description, categories (array of category path strings), and items, which is an array of SKU objects each containing size options, image URLs, prices, and availability status. This makes it suitable for building size-aware product displays or price monitoring tools.
Reviews and Category Hierarchy
get_product_reviews returns up to 50 recent positive customer reviews per product. Each review in the opinions.items array includes id, opinion text, rate, created_at timestamp, user name, and any attached review photos. get_categories requires no input and returns the full category tree up to 3 levels deep, with each node exposing id, name, url, hasChildren, and a children array — useful for building navigation menus or systematically walking the catalog.
The cea API is a managed, monitored endpoint for cea.com.br — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when cea.com.br 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 cea.com.br 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 C&A Brazil clothing prices across categories for competitive retail analysis using
get_category_productswith paginated results. - Build a size-aware product feed by extracting the
itemsSKU array fromget_product_detailswith per-size availability flags. - Aggregate customer sentiment for Brazilian fashion products using
rateandopinionfields fromget_product_reviews. - Generate a full site navigation map using the 3-level category tree returned by
get_categories. - Monitor new arrivals by querying
search_productsorget_subcategory_productsand comparingnbHitsover time. - Populate a product comparison tool with brand, description, images, and price data from
get_product_details. - Index C&A Brazil's catalog by subcategory using
get_subcategory_productswith slugs likeacessoriosorcalcados.
| 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 C&A Brazil offer an official developer API?+
What exactly does `get_product_details` return beyond the basic product name?+
brand, description, categories (an array of category path strings), productId, productName, and an items array of SKU objects. Each SKU object includes size options, image URLs, pricing, and availability — giving you the per-size inventory breakdown rather than just a single product-level price.Are reviews for all products available, and are negative reviews included?+
get_product_reviews returns up to 50 reviews per product sorted by most recent, and the endpoint currently returns positive reviews. Negative or filtered reviews are not currently exposed. You can fork this API on Parse and revise it to add an endpoint targeting other review categories if that data becomes accessible.Does the API cover product availability across physical C&A store locations?+
items array in get_product_details, but store-level stock by physical location is not exposed. You can fork this API on Parse and revise it to add a store-inventory endpoint if that data surface exists.How does pagination work across the search and category endpoints?+
search_products, get_category_products, and get_subcategory_products — use a 0-indexed page parameter alongside a limit parameter. The response includes nbHits (total matching products) and nbPages (total pages at the requested limit), so you can calculate traversal without extra requests.