store · Bulgaria · schema version 1

Retail stores — Bulgaria (KZP price filings)

Name: Retail stores — Bulgaria (KZP price filings)
Creator: RobotsDataset

Every store (търговски обект) of the ~80 Bulgarian retail chains that file daily shelf prices with the Consumer Protection Commission: chain, name, address, town and province, how many basket products and promotions it filed, and whether it prices below or above its chain. Companion of retail_prices_bg — product prices per store are there (stores[].store_id, filter store_ids=).

1736entities

21Attributes

2026-09-05last update

Search this dataset → llms.txt Full public catalog (llms-full.txt) Free examples (real records) Changelog JSON Schema

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_stores_bg · d1ae934a · Sample record

МЛАДОСТ

Products filed: 1240

As filed 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 store_key · https://kolkostruva.bg/opendata_files/sample.zip history →: МЛАДОСТ - бул. Ал. Малинов 1
Store id 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 store_id · https://kolkostruva.bg/opendata_files/sample.zip history →: primer-market-mladost-bul-al-malinov-1-a1b2c
Address kolkostruva.bg2026-09-04 Source https://kolkostruva.bg/opendata_files/sample.zip Observed 2026-09-04 06:48 Confidence 0.90 Age 24h / SLA 2d МЛАДОСТ - бул. Ал. Малинов 1 history →: бул. Ал. Малинов 1

retail_stores_bg · 3332e963

Ф50

Store id 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 ФАНТАСТИКО (ФАНТАСТИКО ГРУП ООД)_206255903.csv · 2191 products history →: fantastiko-903-f50-palata-10-ul-tsar-boris-ii-2f62e
Data 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 ФАНТАСТИКО (ФАНТАСТИКО ГРУП ООД)_206255903.csv · 2191 products 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 ФАНТАСТИКО (ФАНТАСТИКО ГРУП ООД)_206255903.csv · 2191 products history →: ФАНТАСТИКО

+ 13 locked fields ·

retail_stores_bg · 5029584f

ул. Акад. Стефан Младенов 46

Store id 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 БЕРЬОЗКА (БЕРЬОЗКА - БЪЛГАРИЯ ЕООД)_201029124.csv · 24 products history →: beryozka-ul-akad-stefan-mladenov-46-a5e84
Data 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 БЕРЬОЗКА (БЕРЬОЗКА - БЪЛГАРИЯ ЕООД)_201029124.csv · 24 products 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 БЕРЬОЗКА (БЕРЬОЗКА - БЪЛГАРИЯ ЕООД)_201029124.csv · 24 products history →: БЕРЬОЗКА

+ 13 locked fields ·

Schema

JSON

Attribute	Type	SLA	Weight	Sources
name Store	string	2d	5	registry	public
store_key As filed	string	2d	1	registry
store_id Store id	string	2d	5	registry	public
address Address	string\|null	2d	4	registry
external_ids.kzp_store Kzp store	string	30d	1
chain.name Chain	string	2d	5	registry	public
chain.legal_name Legal name	string\|null	2d	5	registry	required
chain.eik Eik	string\|null	2d	5	registry	required
chain.slug Slug	string	2d	5	registry	public
locality.code Code	string\|null	2d	5	registry	required
locality.name Locality	string	2d	5	registry	public
locality.kind Kind	string\|null	2d	5	registry	required
locality.municipality Municipality	string\|null	2d	5	registry	required
locality.province Province	string\|null	2d	5	registry	public
product_count Products filed	integer	2d	3	registry
category_count Categories	integer	2d	2	registry
promo_count Products on promotion	integer	2d	3	registry
promo_share Promo share	number	2d	2	registry
price_position.below_chain Below chain	integer	2d	3	registry
price_position.above_chain Above chain	integer	2d	3	registry
observed_date Data date	string	2d	2	registry	public

Generated filters

GET /v1/retail_stores_bg/entities?…

q=stringnear=stringsort=stringlimit=integercursor=stringfields=stringtotal=booleanids=stringupdated_since=stringmin_quality=numbername=stringlike_name=stringnot_name=stringhas_name=booleanstore_key=stringlike_store_key=stringnot_store_key=stringhas_store_key=booleanstore_id=stringlike_store_id=stringnot_store_id=stringhas_store_id=booleanaddress=stringlike_address=stringnot_address=stringhas_address=booleanexternal_ids.kzp_store=stringlike_external_ids.kzp_store=stringnot_external_ids.kzp_store=stringhas_external_ids.kzp_store=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=booleanlocality.code=stringlike_locality.code=stringnot_locality.code=stringhas_locality.code=booleanlocality.name=stringlike_locality.name=stringnot_locality.name=stringhas_locality.name=booleanlocality.kind=stringlike_locality.kind=stringnot_locality.kind=stringhas_locality.kind=booleanlocality.municipality=stringlike_locality.municipality=stringnot_locality.municipality=stringhas_locality.municipality=booleanlocality.province=stringlike_locality.province=stringnot_locality.province=stringhas_locality.province=booleanmin_product_count=numbermax_product_count=numberhas_product_count=booleanmin_category_count=numbermax_category_count=numberhas_category_count=booleanmin_promo_count=numbermax_promo_count=numberhas_promo_count=booleanmin_promo_share=numbermax_promo_share=numberhas_promo_share=booleanmin_price_position.below_chain=numbermax_price_position.below_chain=numberhas_price_position.below_chain=booleanmin_price_position.above_chain=numbermax_price_position.above_chain=numberhas_price_position.above_chain=booleanobserved_date=stringlike_observed_date=stringnot_observed_date=stringhas_observed_date=boolean

Tools & prices

MCP · Pricing

Tool	Parameters	USD	EUR
store.search Find stores of Bulgarian retail chains by chain, town or province: address, how many basket products and promotions they filed, whether they price below/above the chain. Use the store_id with product.search(store=…) in retail_prices_bg to get that store's prices.	q, chain, locality, province, min_products, sort, limit	$0.01	€0.009
store.get One store: chain, address, locality, counts, price position, provenance.	id	$0.02	€0.018
market.stats Median / quartiles of a numeric store attribute (product_count, promo_share, price_position.below_chain…) filtered like store.search and grouped (default per chain).	attribute, chain, province, group_by	$0.05	€0.046