compraonline.alcampo.es APIcompraonline.alcampo.es ↗
Access Alcampo product catalog, categories, promotions, and store locations via API. Search products, browse categories, and retrieve nutritional data from Spain's Alcampo supermarket.
curl -X GET 'https://api.parse.bot/scraper/0907c7f1-cf66-4da7-b388-5331f776597c/search_products?query=leche&page_size=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on Alcampo's online supermarket. Returns product groups with decorated product details including pricing, availability, images, and promotions.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g. 'leche', 'pan', 'agua'). |
| page_size | integer | Maximum number of products to return. |
{
"type": "object",
"fields": {
"productGroups": "array of product group objects, each containing type, decoratedProducts array, and otherProductIds"
},
"sample": {
"data": {
"productGroups": [
{
"type": "featured",
"otherProductIds": [],
"decoratedProducts": [
{
"name": "PASCUAL Leche entera 6x 1l.",
"brand": "PASCUAL",
"price": {
"amount": "7.50",
"currency": "EUR"
},
"available": true,
"productId": "47d644cf-07ee-49f1-8f38-b8da5a169f65",
"retailerProductId": "54497",
"packSizeDescription": "6000ml"
}
]
}
]
},
"status": "success"
}
}About the compraonline.alcampo.es API
This API exposes 6 endpoints covering the full Alcampo online supermarket catalog at compraonline.alcampo.es, including product search, category browsing, and store locations across Spain. The get_product_details endpoint returns structured nutritional data, ingredient fields, HTML descriptions, and category breadcrumbs for any individual product. Use search_products to query by keyword or get_category_tree to navigate the full four-level category hierarchy.
Product Search and Catalog
The search_products endpoint accepts a query string (e.g. 'leche', 'pan') and an optional page_size integer, returning productGroups arrays where each group contains a decoratedProducts array with pricing, availability, images, and promotion details alongside otherProductIds. To browse by category instead, get_products_by_category takes a category_id sourced from get_category_tree (e.g. 'OCLAC', 'OC16') and returns paginated results with a nextPageToken in the metadata object plus subcategory filters, breadcrumbs, and sort options in additionalPageInfo.
Product Details and Nutritional Data
get_product_details accepts a product_id string (obtainable from search or category results) and returns two top-level objects: bopData with detailedDescription HTML, ingredient fields, and breadcrumbs; and product with the full record including name, brand, price, images, availability, categoryPath, and a ratingSummary. This makes it the primary endpoint for building product pages or nutrition-tracking tools.
Promotions and Category Tree
get_promotions returns current on-offer product groups with promotion details embedded in each decorated product, paginated via nextPageToken. get_category_tree requires no inputs and returns the full hierarchy up to four levels deep — each node carries name, categoryId, retailerCategoryId, productCount, and a childCategories array. The retailerCategoryId values from this tree are the IDs expected by get_products_by_category.
Store Locations
get_store_locations accepts lat and lng coordinates (defaulting to central Madrid: 40.4168, -3.7038) and returns a GeoJSON FeatureCollection. Each Feature in the features array carries store name, address, contact, opening hours, and distance from the search point, making it straightforward to build a store-finder or coverage map for Spanish retail locations.
- Building a price-tracking dashboard for Alcampo grocery products using
search_productsand thepricefield in decorated product responses - Populating a nutrition database with ingredient and nutritional fields returned by
get_product_detailsfor individual SKUs - Rendering a store-finder map for Spain by querying
get_store_locationswith user-supplied coordinates and plotting the GeoJSON FeatureCollection - Monitoring active promotions and discount descriptions via
get_promotionsto surface deals in a comparison shopping tool - Navigating the full four-level category hierarchy with
get_category_treeto build a structured product taxonomy or sitemap - Syncing in-stock availability status from category pages using
get_products_by_categorywith pagination vianextPageToken - Extracting brand and
ratingSummarydata fromget_product_detailsto support product review aggregation
| 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 Alcampo provide an official developer API?+
How does pagination work across endpoints?+
get_products_by_category and get_promotions both return a metadata object containing a nextPageToken string. Pass this token in subsequent requests to retrieve the next page of results. search_products uses a page_size parameter to limit results but does not currently expose a pagination token.Does the API return user reviews or detailed ratings?+
get_product_details returns a ratingSummary object per product, but individual user review text and reviewer details are not currently exposed. The API covers product metadata, pricing, nutritional data, and aggregate rating summaries. You can fork the API on Parse and revise it to add an endpoint targeting per-review data.Is historical pricing or price-change history available?+
price, availability, and promotion details per product. You can fork the API on Parse and revise it to build a price-history endpoint by storing snapshots over time.What product ID format does `get_product_details` expect, and where do I get IDs?+
product_id parameter is a numeric string (e.g. '54497'). These IDs appear in the decoratedProducts arrays returned by both search_products and get_products_by_category, so the typical flow is to run a search or category query first, collect IDs from the results, then call get_product_details for each product you need full data on.