product · Bulgaria · schema version 1

Retail prices — Bulgaria (KZP consumer basket)

Daily shelf prices of ~50 000 products in ~80 Bulgarian retail chains (supermarkets, discounters, drugstores, pharmacies): regular and promo price in EUR, unit price per kg/l, pack size, KZP basket category, localities served and the price in every store (store_id links to retail_stores_bg). Built from the open data every chain with turnover above 10 M BGN must file daily with the Consumer Protection Commission (kolkostruva.bg).

50930entities
35Attributes
2026-09-05last update

Free: 50 previews per day with public fields. Full records with provenance need a key or x402. Source: КЗП open data (kolkostruva.bg/opendata, public-sector information reusable under the Bulgarian Access to Public Information Act) · RobotsDataset normalisation and provenance — RobotsDataset Commercial

Sample records

JSON · MD

Fictional records that show every field with its provenance stamp. Free, also for agents.

retail_prices_bg · b4f15631 · Sample record

ПРЯСНО МЛЯКО ПРИМЕР 3.6% 1 Л

Regular price (€): 1.89Promo price (€): 1.59

Product code
kolkostruva.bg2026-09-02
Source
https://kolkostruva.bg/opendata_files/sample.zip
Observed
2026-09-02 06:48
Confidence
0.95
Age
3d / SLA 2d
product_code · https://kolkostruva.bg/opendata_files/sample.zip
history →
PM-10231
Lowest price (€)
kolkostruva.bg2026-09-02
Source
https://kolkostruva.bg/opendata_files/sample.zip
Observed
2026-09-02 06:48
Confidence
0.95
Age
3d / SLA 2d
lowest_price_eur · https://kolkostruva.bg/opendata_files/sample.zip
history →
1.59
On promotion
kolkostruva.bg2026-09-02
Source
https://kolkostruva.bg/opendata_files/sample.zip
Observed
2026-09-02 06:48
Confidence
0.95
Age
3d / SLA 2d
on_promo · https://kolkostruva.bg/opendata_files/sample.zip
history →
yes

retail_prices_bg · 5c89f14f · Sample record

ОЛИО СЛЪНЧОГЛЕДОВО ПРИМЕР 1 Л

Regular price (€): 2.49

Product code
kolkostruva.bg2026-09-02
Source
https://kolkostruva.bg/opendata_files/sample.zip
Observed
2026-09-02 06:48
Confidence
0.95
Age
3d / SLA 2d
product_code · https://kolkostruva.bg/opendata_files/sample.zip
history →
PM-20077
Lowest price (€)
kolkostruva.bg2026-09-02
Source
https://kolkostruva.bg/opendata_files/sample.zip
Observed
2026-09-02 06:48
Confidence
0.95
Age
3d / SLA 2d
lowest_price_eur · https://kolkostruva.bg/opendata_files/sample.zip
history →
2.39
On promotion
kolkostruva.bg2026-09-02
Source
https://kolkostruva.bg/opendata_files/sample.zip
Observed
2026-09-02 06:48
Confidence
0.95
Age
3d / SLA 2d
on_promo · https://kolkostruva.bg/opendata_files/sample.zip
history →
no

retail_prices_bg · 03c095e7

КОЛБАС МИНЧО КОРТЕН КГ ТЕЛЕШКИ,ХАМБУРГСКИ, КАМЧИЯ

Regular price (€): 8.41

On promotion
kolkostruva.bg2026-09-04
Source
https://kolkostruva.bg/opendata_files/2026-09-04.zip
Observed
2026-09-04 00:00
Confidence
0.95
Age
31h / SLA 2d
СИБИЕС МАРКЕТ (СИБИЕС ООД)_123587860.csv · 15 stores
history →
no
Price date
kolkostruva.bg2026-09-04
Source
https://kolkostruva.bg/opendata_files/2026-09-04.zip
Observed
2026-09-04 00:00
Confidence
1.00
Age
31h / SLA 2d
СИБИЕС МАРКЕТ (СИБИЕС ООД)_123587860.csv · 15 stores
history →
2026-09-04
Chain
kolkostruva.bg2026-09-04
Source
https://kolkostruva.bg/opendata_files/2026-09-04.zip
Observed
2026-09-04 00:00
Confidence
0.95
Age
31h / SLA 2d
СИБИЕС МАРКЕТ (СИБИЕС ООД)_123587860.csv · 15 stores
history →
СИБИЕС МАРКЕТ

+ 26 locked fields ·

Schema

JSON
AttributeTypeSLAWeightSources
name
Product
string2d5registrypublic
product_code
Product code
string|null2d2registry
external_ids.kzp
Kzp
string30d1
chain.name
Chain
string2d5registrypublic
chain.legal_name
Company
string|null2d5registryrequired
chain.eik
EIK
string|null2d5registryrequired
chain.slug
Slug
string2d5registrypublic
category.id
Id
integer2d5registryrequired
category.key
Key
string2d5registrypublic
category.name
Category
string2d5registrypublic
category.name_en
Name en
string|null2d5registryrequired
category.group_key
Group key
string2d5registryrequired
category.group
Group
string|null2d5registryrequired
price_eur
Regular price (€)
number2d5registrypublic
promo_price_eur
Promo price (€)
number|null2d4registry
lowest_price_eur
Lowest price (€)
number2d4registry
on_promo
On promotion
boolean2d3registrypublic
promo_store_share
Share of stores on promo
number2d1registry
price_range.min
Min
number2d2registry
price_range.max
Max
number2d2registry
pack.qty
Qty
number|null2d2derived
pack.unit
Unit
string|null2d2derived
pack.count
Count
integer2d2derived
pack.text
Text
string|null2d2derived
unit_price.value
Price per kg/l/pc (€)
number2d4derived
unit_price.per
Per
string2d4derived
store_count
Stores
integer2d2registry
localities
Localities
array2d3registry
locality_codes
EKATTE codes
array2d1registry
provinces
Provinces
array2d3registry
stores_uniform
Same price in every store
boolean2d1registry
stores
Price per store
array2d3registry
observed_date
Price date
string2d2registrypublic
deviating_stores
Stores with a different price
integer2d1registry
store_ids
Store ids
array2d2registry

Generated filters

GET /v1/retail_prices_bg/entities?…
q=stringnear=stringsort=stringlimit=integercursor=stringfields=stringtotal=booleanids=stringupdated_since=stringmin_quality=numbername=stringlike_name=stringnot_name=stringhas_name=booleanproduct_code=stringlike_product_code=stringnot_product_code=stringhas_product_code=booleanexternal_ids.kzp=stringlike_external_ids.kzp=stringnot_external_ids.kzp=stringhas_external_ids.kzp=booleanchain.name=stringlike_chain.name=stringnot_chain.name=stringhas_chain.name=booleanchain.legal_name=stringlike_chain.legal_name=stringnot_chain.legal_name=stringhas_chain.legal_name=booleanchain.eik=stringlike_chain.eik=stringnot_chain.eik=stringhas_chain.eik=booleanchain.slug=stringlike_chain.slug=stringnot_chain.slug=stringhas_chain.slug=booleanmin_category.id=numbermax_category.id=numberhas_category.id=booleancategory.key=stringlike_category.key=stringnot_category.key=stringhas_category.key=booleancategory.name=stringlike_category.name=stringnot_category.name=stringhas_category.name=booleancategory.name_en=stringlike_category.name_en=stringnot_category.name_en=stringhas_category.name_en=booleancategory.group_key=bread_cereals|dairy_eggs|oils_fats|me...not_category.group_key=stringhas_category.group_key=booleancategory.group=stringlike_category.group=stringnot_category.group=stringhas_category.group=booleanmin_price_eur=numbermax_price_eur=numberhas_price_eur=booleanmin_promo_price_eur=numbermax_promo_price_eur=numberhas_promo_price_eur=booleanmin_lowest_price_eur=numbermax_lowest_price_eur=numberhas_lowest_price_eur=booleanon_promo=booleanhas_on_promo=booleanmin_promo_store_share=numbermax_promo_store_share=numberhas_promo_store_share=booleanmin_price_range.min=numbermax_price_range.min=numberhas_price_range.min=booleanmin_price_range.max=numbermax_price_range.max=numberhas_price_range.max=booleanmin_pack.qty=numbermax_pack.qty=numberhas_pack.qty=booleanpack.unit=g|kg|ml|l|pc|Nonenot_pack.unit=stringhas_pack.unit=booleanmin_pack.count=numbermax_pack.count=numberhas_pack.count=booleanpack.text=stringlike_pack.text=stringnot_pack.text=stringhas_pack.text=booleanmin_unit_price.value=numbermax_unit_price.value=numberhas_unit_price.value=booleanunit_price.per=kg|l|pcnot_unit_price.per=stringhas_unit_price.per=booleanmin_store_count=numbermax_store_count=numberhas_store_count=booleanlocalities=stringhas_localities=booleanlocality_codes=stringhas_locality_codes=booleanprovinces=stringhas_provinces=booleanstores_uniform=booleanhas_stores_uniform=booleanhas_stores=booleanobserved_date=stringlike_observed_date=stringnot_observed_date=stringhas_observed_date=booleanmin_deviating_stores=numbermax_deviating_stores=numberhas_deviating_stores=booleanstore_ids=stringhas_store_ids=boolean

Tools & prices

MCP · Pricing
ToolParametersUSDEUR
product.search
Find products and their current shelf prices in Bulgarian retail chains. Filter by KZP basket category (e.g. fresh_milk, white_bread, sunflower_oil), chain, locality/province, a specific store (store_id), max price, promotions. Sort by price_eur or unit_price.value for the cheapest. Results carry chain-wide prices; per-store prices are in product.get.
q, category, group, chain, locality, province, store, max_price_eur, max_unit_price, on_promo, sort, limit$0.01€0.009
product.get
Full record of one product listing: regular/promo/lowest price, unit price, pack size, the price in every store (stores[] with store_id), localities, provenance.
id$0.02€0.018
product.compare
Side-by-side prices of up to 5 product listings (e.g. the same milk in five chains).
ids$0.05€0.046
market.stats
Median / quartiles / min / max of a price attribute across listings, filtered like product.search and grouped (default: per chain). Example: attribute=unit_price.value, category=fresh_milk, group_by=chain.slug.
attribute, category, group, chain, locality, province, on_promo, group_by$0.05€0.046

Subscriptions

live_table

€149 / month

Includes: export, changes

Ask about this plan