carrefour.com.ar APIcarrefour.com.ar ↗
Access Carrefour Argentina product data via 3 endpoints: search products, list cellphones with specs, and fetch daily promotional offers with prices.
curl -X GET 'https://api.parse.bot/scraper/9effaa3c-7d7c-435f-8750-4cc72bd7cb3d/get_offers_of_the_day?limit=2' \ -H 'X-API-Key: $PARSE_API_KEY'
Get current featured offers and promotions from Carrefour Argentina. Returns products from the active promotional cluster, ordered by top sales.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of products to return. |
{
"type": "object",
"fields": {
"total": "integer total number of matching products in the promotional cluster",
"products": "array of product objects with productId, productName, brand, link, description, price, listPrice, spotPrice, available, images, specifications, promotions, and installments"
},
"sample": {
"data": {
"total": 20,
"products": [
{
"link": "https://www.carrefour.com.ar/celular-libre-xiaomi-redmi-note-13-6gb-128-gb-azul-/p",
"brand": "Xiaomi",
"price": 399000,
"images": [
"https://carrefourar.vtexassets.com/arquivos/ids/589927/6941812763902_01.jpg"
],
"available": true,
"listPrice": 429000,
"productId": "746173",
"spotPrice": 399000,
"promotions": [
"6 CSI MI CARREFOUR CRÉDITO",
"6 CUOTAS SIN INTERÉS"
],
"description": "...",
"productName": "Celular libre Xiaomi redmi note 13 6gb 128 gb azul",
"installments": [
{
"Name": "American Express 6 vezes sem juros",
"Value": 66500,
"InterestRate": 0,
"PaymentSystemName": "American Express",
"NumberOfInstallments": 6,
"TotalValuePlusInterestRate": 399000
}
],
"specifications": {
"Memoria RAM": "6 GB",
"Memoria interna": "128 GB",
"Sistema operativo": "Android 13, MIUI 14"
}
}
]
},
"status": "success"
}
}About the carrefour.com.ar API
The Carrefour Argentina API exposes 3 endpoints to retrieve product listings, pricing, and promotional offers from carrefour.com.ar. The search_products endpoint accepts a keyword query and returns matching products across all categories with relevance-ordered results. Each response includes fields like price, listPrice, spotPrice, brand, available, and images, giving you the data needed to track pricing and availability across the store.
Endpoints and What They Return
The API provides three endpoints. get_offers_of_the_day returns products currently featured in Carrefour Argentina's active promotional cluster, sorted by top sales volume. It accepts an optional limit parameter and returns a total count alongside an array of product objects. list_cellphones targets the celulares-libres category specifically, supporting pagination via page and limit parameters and returning the current page, limit, total, and a products array. search_products accepts a required query string (e.g. arroz, celular, laptop) and an optional limit, returning results ranked by relevance score across all categories.
Product Object Fields
Every endpoint returns the same product object shape: productId, productName, brand, link, description, price, listPrice, spotPrice, available, images, and sp. The three price fields let you compare the regular list price against the current selling price and any spot promotional price in a single response. The available field indicates current stock status, and images provides product image references.
Coverage and Scope
All data reflects the Argentine storefront at carrefour.com.ar. The list_cellphones endpoint is category-specific and paginated, making it suitable for building a complete index of the cellphone catalog. The search_products endpoint covers the full catalog breadth, while get_offers_of_the_day is scoped to whatever promotional cluster is active at request time.
- Monitor
price,listPrice, andspotPricechanges across Carrefour Argentina's catalog for price tracking dashboards. - Pull all cellphones via
list_cellphoneswith pagination to build a comparison tool for the Argentine market. - Use
get_offers_of_the_dayto surface current deals in a deal-alert app or newsletter. - Feed
search_productsresults into a price comparison engine alongside other Argentine retailers. - Check the
availablefield on specific products to alert users when out-of-stock items return. - Aggregate
branddata across the cellphone category to analyze brand distribution in Carrefour's inventory. - Use product
linkfields from search results to direct users to the exact product page for purchase.
| 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.
Does Carrefour Argentina have an official public developer API?+
What is the difference between `price`, `listPrice`, and `spotPrice` in the product response?+
listPrice is the regular retail price before any discount. price is the current selling price. spotPrice reflects a promotional or spot-deal price when one is active. All three are returned in every product object, so you can calculate discount depth directly.Does `list_cellphones` return all phone categories, or just unlocked (libre) phones?+
celulares-libres category specifically, so it returns unlocked handsets. Contract or carrier-locked devices listed elsewhere are not included in this endpoint. You can use search_products with a query like celular to broaden the search across all phone-related listings.Does the API cover customer reviews or ratings for products?+
price, listPrice, spotPrice), availability, brand, and images. Review counts and star ratings are not included in any endpoint's response. You can fork this API on Parse and revise it to add an endpoint that retrieves review data for individual products.Can I retrieve products from a specific category other than cellphones?+
list_cellphones. For other categories, search_products with a relevant query is the available alternative. A category-browse endpoint covering the full department tree is not currently supported. You can fork this API on Parse and revise it to add a category-listing endpoint.