Com APIcarrefour.com.ar ↗
Access Carrefour Argentina product data: prices, availability, brands, and specs across all categories. Search products, list cellphones, and get top sellers.
What is the Com API?
The Carrefour Argentina API gives developers access to product data across all categories on carrefour.com.ar through 3 endpoints. The search_products endpoint accepts a keyword query and returns matching products with prices, availability, and brand details. You can also retrieve best-selling products via get_offers_of_the_day or paginate through the full cellphone catalog with list_cellphones.
curl -X GET 'https://api.parse.bot/scraper/9effaa3c-7d7c-435f-8750-4cc72bd7cb3d/get_offers_of_the_day?limit=5' \ -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 carrefour-com-ar-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.
from parse_apis.carrefour_argentina_api import CarrefourAr
client = CarrefourAr()
# Browse top-selling products across all categories
for product in client.offers.list(limit=5):
print(product.product_name, product.brand, product.price, product.available)
# List available cellphones with pagination
for phone in client.cellphones.list(limit=3):
print(phone.product_name, phone.price, phone.list_price)
for installment in phone.installments:
print(installment.number_of_installments, installment.payment_system_name, installment.value)
# Search for products by keyword
for result in client.searches.find(query="samsung", limit=5):
print(result.product_id, result.product_name, result.spot_price, result.link)
Get current top-selling products from Carrefour Argentina. Returns products from the best-sellers cluster ordered by sales volume. Results span all categories (groceries, electronics, produce, etc.).
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of products to return. |
{
"type": "object",
"fields": {
"total": "integer total number of products in the best-sellers cluster",
"products": "array of product objects with productId, productName, brand, link, description, price, listPrice, spotPrice, available, images, specifications, promotions, and installments"
},
"sample": {
"data": {
"total": 118,
"products": [
{
"link": "https://www.carrefour.com.ar/lomito-de-atun-al-natural-carrefour-classic-170-grs-122140/p",
"brand": "Carrefour",
"price": 2898,
"images": [
"https://carrefourar.vtexassets.com/arquivos/ids/386717/7798033333907_E01.jpg"
],
"available": true,
"listPrice": 3150,
"productId": "122140",
"spotPrice": 2898,
"promotions": [],
"description": "",
"productName": "Lomito de atún al natural Carrefour Classic 170 grs",
"installments": [
{
"Name": "American Express à vista",
"Value": 2898,
"InterestRate": 0,
"PaymentSystemName": "American Express",
"NumberOfInstallments": 1,
"TotalValuePlusInterestRate": 2898
}
],
"specifications": {
"EAN": "7798033333907",
"Tipo de producto": "Atún al natural"
}
}
]
},
"status": "success"
}
}About the Com API
What the API Returns
All three endpoints return a consistent product object structure including productId, productName, brand, link, description, price, listPrice, spotPrice, available, and images. The price vs listPrice vs spotPrice distinction lets you detect discounts and promotional pricing — useful for price tracking and alerting applications. The available flag indicates current stock status.
Endpoint Details
get_offers_of_the_day returns products from the best-sellers cluster ordered by sales volume, with a total count of the full cluster size and a limit parameter to cap how many products are returned. Coverage spans all categories: groceries, electronics, produce, and more. list_cellphones is scoped to the celulares-libres category and supports pagination via page and limit parameters, returning the current page, limit, and total cellphone count alongside the product array. search_products requires a query string — examples like 'arroz', 'yerba', or 'samsung' — and returns results ordered by relevance. When a search term maps to a well-known category on Carrefour's site, the redirect is followed and category results are returned instead.
Pagination and Coverage
Pagination is supported on list_cellphones through explicit page and limit inputs. The other two endpoints use only a limit parameter to cap result size without page-level navigation. All data reflects the Carrefour Argentina storefront at carrefour.com.ar, covering the Argentine market in ARS pricing.
The Com API is a managed, monitored endpoint for carrefour.com.ar — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when carrefour.com.ar 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 carrefour.com.ar 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 price changes on grocery staples using
price,listPrice, andspotPricefields fromsearch_products - Monitor stock availability for specific products using the
availablefield across search results - Build a cellphone comparison tool from
list_cellphoneswith brand, specs, and promotional pricing - Identify trending products by pulling the best-sellers cluster via
get_offers_of_the_day - Alert users when a product's
spotPricedrops below itslistPricefor discount detection - Aggregate brand presence across categories by parsing
brandfromsearch_productsresults
| 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 Carrefour Argentina have an official developer API?+
What does the `search_products` endpoint return when a query maps to a known category?+
total field reflects the count of products in that category, not a keyword match count.Is product review or rating data available from any of these endpoints?+
Does `get_offers_of_the_day` support page-level pagination like `list_cellphones` does?+
get_offers_of_the_day only accepts a limit parameter to cap the number of returned products — it does not support a page parameter. list_cellphones is the only endpoint with full page and limit pagination. You can fork this API on Parse and revise get_offers_of_the_day to add page-based navigation if the full cluster needs to be traversed.Are prices returned in ARS (Argentine Peso)?+
price, listPrice, and spotPrice — reflect the pricing shown on carrefour.com.ar, which is denominated in Argentine Pesos. The API does not perform currency conversion.