catalogodigital.somosbelcorp.com APIcatalogodigital.somosbelcorp.com ↗
Access Belcorp product data, pricing, and catalogs across 13 countries and 3 brands (Ésika, L'Bel, Cyzone) via 6 structured endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/33d6321a-2b61-4fee-afdf-3bd79f234151/select_country' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the list of available countries for the Belcorp catalog platform, including country codes and flag image URLs.
No input parameters required.
{
"type": "object",
"fields": {
"data": "array of country objects with id, code, name, and flag URL",
"status": "string indicating success"
},
"sample": {
"data": [
{
"id": "2",
"code": "BO",
"flag": "https://belc-catalogodigital-data-prd.s3.amazonaws.com/services/countries/images/flags/FlagBO.png",
"name": "Bolivia"
},
{
"id": "9",
"code": "MX",
"flag": "https://belc-catalogodigital-data-prd.s3.amazonaws.com/services/countries/images/flags/FlagMX.png",
"name": "México"
}
],
"status": "success"
}
}About the catalogodigital.somosbelcorp.com API
The Belcorp Digital Catalog API gives developers structured access to product data, pricing, and catalog pages across 13 countries and 3 brands through 6 endpoints. Starting with select_country to retrieve available markets, you can fetch active campaigns via get_catalogs, drill into individual catalog pages with get_catalog_detail, and retrieve full product details — including offer prices, variants, and linked strategies — through get_product_detail.
What the API Covers
The Belcorp Digital Catalog API exposes product and catalog data from Belcorp's three direct-sales brands: Ésika (E), L'Bel (L), and Cyzone (C). Coverage spans 13 markets including MX, CO, PE, BO, CL, CR, EC, SV, GT, PA, PR, DO, and US. Each country runs campaign-based catalogs (e.g. campaign code 202608), and the get_catalogs endpoint returns the active campaign id, code, and name alongside a catalogs array with brand details and category listings. The campaign code from this response is a required input for all product-level endpoints.
Product and Catalog Endpoints
get_catalog_detail accepts a catalog_id and country_code and returns a pages array where each entry includes page images, display order, status, and mapped products and materials. get_products_by_catalog takes a brand_code, country_code, and campaign_code and returns a carts array of product mappings — each containing cuv, sku, pageNumber, and productId. The cuv values from this response feed directly into get_product_detail.
Product Detail Fields
get_product_detail returns the most granular data in the API: cuv, sku, name, description, a pricing object with currencyCode, normalPrice, offerPrice, and tierPrices, an images object with main and variant URLs, category with id and name, variants as an array of related product objects, and a strategy object linking cross-sell offers. Products are campaign-scoped — passing an outdated campaign_code will not return current pricing.
Search
search_products accepts a free-text query (e.g. "perfume", "labial"), a country_code, and a campaign_code. It returns a results array with the same core fields as get_product_detail: cuv, sku, name, description, images, pricing, brand, and category. This makes it suitable for building keyword-driven product lookup without needing to enumerate catalogs first.
- Build a price-comparison tool across Belcorp's three brands for a given country using
pricing.normalPriceandpricing.offerPricefields. - Generate a product feed for an affiliate or reseller site by iterating
get_products_by_catalogand enriching each entry withget_product_detail. - Track catalog structure changes between campaigns by comparing
pagesarrays fromget_catalog_detailacross successivecampaign_codevalues. - Power a keyword search interface for Belcorp consultants using
search_productswith country and campaign scoping. - Map products to catalog page positions using
pageNumberfromget_products_by_catalogfor digital catalog viewer applications. - Monitor tier pricing changes per campaign by storing
tierPricesfromget_product_detailover time. - Enumerate all active categories per brand and country from the
catalogsarray returned byget_catalogs.
| 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 Belcorp provide an official public developer API for catalogodigital.somosbelcorp.com?+
What does `get_product_detail` return beyond basic name and price?+
get_product_detail returns a pricing object with currencyCode, normalPrice, offerPrice, and tierPrices; an images object with main and variant URLs; a variants array of related product objects; a strategy object with linked cross-sell offers; and a category object with id and name. All fields are campaign-specific, so you must pass the current campaign_code from get_catalogs to get accurate results.Are historical campaigns or archived catalog data available?+
get_catalogs. Passing an older campaign_code to product endpoints may not return valid data, as products and pricing are campaign-scoped. Historical campaign archival is not a current feature. You can fork this API on Parse and revise it to add an endpoint that accepts a date range or past campaign code if the underlying source exposes that data.Does the API return consultant-level or order data?+
Can I retrieve products for all countries in a single call?+
country_code parameter, so requests are per-country. To aggregate data across all 13 markets, you would call select_country to list codes and then iterate per country. Bulk multi-country responses are not currently supported in a single call. You can fork this API on Parse and revise it to add a multi-country aggregation endpoint.