Bulmag API — Real-Time Bulgaria Grocery Data
Access Bulmag's Bulgarian grocery catalog via the Pepesto API — product data, pricing in BGN, and details from bulmag.org, returned as structured JSON. Product names and categories provided in Bulgarian.
What Does the Bulmag API Return?
Everything visible and related to food, cooking, and recipes in the Bulmag mobile web application, returned as clean JSON via a single REST call. The indexed product list typically contains 1,000–2,000 SKUs, focused on the most common ingredients used for cooking.
First Bulgarian Grocery API Integration with Bulmag — Pepesto API
Real working code. See what's possible, then adapt it for your use case.
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, Jumbo, 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 all products available in Pepesto for 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"}'
{
"https://bulmag.org/spaghetti/barilla-spaghettoni-nr-7-1kg/p/4934814e0251": {
"entity_name": "Spaghetti",
"kg_verified": true,
"names": {
"bg": "Barilla Spaghettoni No. 7 1kg",
"en": "Barilla Spaghettoni No. 7 1kg"
},
"price": 340,
"currency": "EUR",
"price_per_meausure_unit": "0.34 / 100g",
"quantity_str": "1kg",
"quantity": {
"Unit": {
"HundredGrams": 10
},
"accurate_grams": 1000
}
}
}What Can You Build?
The Bulmag API gives your product a live data layer on top of one of Bulgaria's leading grocery retailers.
Give your AI agent the ability to search Bulmag's products, compare products, and place grocery orders — all programmatically via REST.
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.
Bridge meal planning and shopping: match recipe ingredients to real Bulmag supermarket products and power dietary-aware grocery lists with live pricing.
Monitor Bulmag's product range, pricing strategy, and promotional cadence at scale. Analyse SKU composition, spot price movements, and benchmark against competitors.
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 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.
Start pay-as-you-go — all 27 chains included, no per-chain pricing. Move to a monthly plan when you grow. See pricing →
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 reference.
Purchase via Stripe, then call /link with your email — your
key is returned immediately.
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, and quantity (e.g., kg).
Data is refreshed daily, reflecting the prices and details 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.
Everything visible and related to food, cooking, and recipes in the Bulmag mobile web application, returned as clean JSON via a single REST call. The indexed product list typically contains 1,000–2,000 SKUs, focused on the most common ingredients used for cooking.
The standard catalog is indexed daily — product prices 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.