Bulmag API — Real-Time Bulgaria Grocery Data
Access Bulmag's Bulgarian grocery catalog via the Pepesto API — product data, pricing in BGN, and availability from bulmag.org, returned as structured JSON. Product names and categories provided in Bulgarian.
What Does the Bulmag API Return?
Everything visible in the Bulmag app and website, returned as clean JSON via a single REST call.
Bulmag-specific: Product names, categories, and descriptions are returned in Bulgarian as displayed on bulmag.org. All JSON field names use English keys for consistent cross-chain integration. Bulgarian category taxonomy is preserved in the category_path field.
Why Use an API Instead of Building Your Own Bulmag Integration?
Developers who have tried to build their own Bulmag data pipeline know the obstacles. Unofficial workarounds exist, but they come with real costs.
Bulmag updates their website regularly — changing markup, adding rate limiting, or restructuring categories. Pepesto absorbs all of that. Your integration keeps working.
The same JSON field names work whether you're calling Bulmag, Albert Heijn, Tesco, or any other supported chain. One integration for all of Europe.
Calling a REST API takes hours. Building, maintaining, and scaling your own Bulmag data extraction takes months — and requires ongoing engineering resources.
DIY data extraction is fragile: a single layout change can silently break your pipeline. Pepesto monitors and updates integrations continuously so you don't have to.
Fetch Bulmag Products in One Request
A single authenticated POST to /api/catalog returns
the full structured product catalog from Bulmag.
curl -X POST https://s.pepesto.com/api/catalog \ -H "Authorization: Bearer $PEPESTO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"supermarket_domain": "bulmag.org"}'
{
"supermarket_domain": "bulmag.org",
"products": [
{
"name": "Barilla Penne Rigate 500g",
"brand": "Barilla",
"pack_size": "500g",
"price": 1.89,
"unit_price": 0.38,
"unit_label": "per 100g",
"promo_price": 1.49,
"availability": "in_stock",
"category": "Pasta & Rice / Pasta / Penne",
"nutrition": {
"energy_kcal": 352,
"protein_g": 12.5,
"carbs_g": 70.5,
"fat_g": 1.5
}
}
]
}What Can You Build?
The Bulmag API gives your product a live data layer on top of one of Bulgaria's leading grocery retailers.
Compare Bulmag prices against other Bulgaria retailers in real time. Flag promotions, track price history, and surface the best deal per product.
Let users build a weekly shopping list and see the exact Bulmag cost — including any active promotional prices — before they shop.
Match recipe ingredients to real Bulmag products and show the true cost of cooking from a given menu. Drive grocery orders directly from your meal planner.
Access structured nutritional data — calories, macros, allergens — for the exact products sold at Bulmag. Power food logging and dietary tracking with real supermarket data.
Monitor Bulmag's product range, pricing strategy, and promotional cadence at scale. Track SKU introductions, price changes, and out-of-stock events over time.
Give your AI agent the ability to search Bulmag's catalog, compare products by price or nutrition, and place grocery orders — all programmatically via REST.
Coverage & Data Freshness
Covers bulmag.org — a Bulgarian online grocery platform. Data reflects the Bulgarian-language storefront. This is one of the few programmatic sources for Bulgarian supermarket product data available to developers.
Bulgaria — bulmag.org. Pricing in BGN.
Daily. Promotional prices and weekly deals are included in every update cycle.
All products listed online at bulmag.org — including active promotions and full product details.
All product data and pricing is sourced from publicly listed pages on bulmag.org. Pepesto does not access retailer-gated pricing or any data not visible to a regular visitor. Products shown at a lower price due to a promotion or budget-tier range are included because they appear publicly on the site — not through any special retailer agreement.
How to get started
Three steps. No approval process. Your first call can be running within minutes.
Purchase a credit pack via Stripe. Pay-as-you-go from €0.05 per request. No monthly subscription, no minimum spend. Credits don't expire.
After purchase, call /link with your email — your API
key is returned immediately. No waiting, no approval form, no account
setup.
Make your first call to /api/catalog with
chain: "bulmag". Full endpoint reference and example
responses are in the API docs.
Purchase via Stripe, then call /link with your email — your
key is returned immediately. No approval process, no waiting.
Frequently Asked Questions about the Bulmag API
Bulmag does not offer a public developer API. Pepesto provides a maintained API layer that normalises Bulmag's product catalog from bulmag.org into consistent JSON, refreshed daily.
Yes. Product names, categories, and descriptions are returned in Bulgarian exactly as displayed on bulmag.org. All JSON field names (name, price, ean, etc.) use English keys for consistent programmatic handling across all Pepesto-supported chains.
Pepesto returns a unified JSON schema across all supported chains. Each Bulmag product object includes name (in Bulgarian), price in BGN, availability, category path, brand, pack size, and nutritional data where available.
Data is refreshed daily, reflecting the prices and availability shown on bulmag.org.
The Pepesto Bulmag integration covers bulmag.org, which serves the Bulgarian market. Currency is BGN (Bulgarian Lev).
Purchase Pepesto API credits, retrieve your key via the /link endpoint, then call /catalog with chain set to bulmag. The API documentation has the full endpoint reference and sample responses.
The standard catalog is indexed daily — prices, availability, and product details are refreshed every 24 hours. If your use case requires more frequent updates or push notifications on price changes, get in touch and we can discuss what's possible.
Other Supermarkets Available on Pepesto
One API key gives you access to 25+ European grocery chains with a consistent JSON schema.
