API i dokumentacja dla integratorów

⌨ API v1

Dane serwisu w formacie JSON

Te same dane, które napędzają listing i benchmarki, udostępniamy przez REST API. Endpointy publiczne działają bez klucza i mają limit 60 zapytań na minutę na adres IP.

Adres bazowy

https://dobrybiznes.store/api/v1

Uwierzytelnianie: Authorization: Bearer <klucz-organizacji>. Format błędów zgodny z RFC 7807. Wersjonowanie w ścieżce.

Endpointy

Metoda	Ścieżka	Opis	Dostęp
GET	/api/v1/offers	Wyszukiwanie ofert z pełnym zestawem filtrów i fasetek	publiczne
GET	/api/v1/offers/{publicId}	Szczegóły oferty bez treści chronionych przez NDA	publiczne
GET	/api/v1/industries	Katalog branż z licznikami i podbranżami	publiczne
GET	/api/v1/locations	Województwa i miasta z licznikami ofert	publiczne
GET	/api/v1/benchmarks	Mediany i kwartyle cen, zysków i mnożników per branża	publiczne
GET	/api/v1/companies/{nip}	Dane rejestrowe podmiotu: KRS, status VAT, finanse	klucz API
POST	/api/v1/offers	Publikacja oferty (plan Broker i wyżej)	klucz API
POST	/api/v1/webhooks	Rejestracja subskrypcji zdarzeń	klucz API

Parametry wyszukiwania

Parametr	Typ	Opis
q	fraza	Wyszukiwanie pełnotekstowe w tytule i opisie
branza	slug	Filtr po branży, np. gastronomia
wojewodztwo	slug	Filtr po województwie
cena_od / cena_do	liczba	Zakres ceny w złotych
zysk_od / zysk_do	liczba	Zakres rocznego zysku
mnoznik_od / mnoznik_do	liczba	Zakres mnożnika wyceny — filtr niedostępny nigdzie indziej
zweryfikowane	1	Tylko oferty z trust score ≥ 70
sort	kod	relevance, newest, price_asc, price_desc, multiple_asc, trust_desc
strona / na_stronie	liczba	Paginacja; na_stronie ∈ {12, 24, 48}

Przykład

curl "https://dobrybiznes.store/api/v1/offers?branza=gastronomia&mnoznik_do=3&na_stronie=12"

{
  "data": [
    {
      "publicId": "DB-10428",
      "title": "Restauracja w centrum Krakowa",
      "url": "https://dobrybiznes.store/oferta/restauracja-w-centrum-krakowa-DB-10428",
      "price": 420000,
      "currency": "PLN",
      "revenueAnnual": 1240000,
      "profitAnnual": 148000,
      "valuationMultiple": 2.84,
      "trustScore": 82,
      "industry": { "slug": "gastronomia", "name": "Gastronomia" },
      "location": { "city": "Kraków", "voivodeship": "małopolskie" },
      "publishedAt": "2026-08-14T09:12:00.000Z"
    }
  ],
  "facets": { "industries": [...], "priceBrackets": [...] },
  "meta": { "total": 19, "page": 1, "perPage": 12, "medianMultiple": 3.18 }
}

Zdarzenia webhooków

offer.published
offer.updated
offer.sold
lead.created
lead.status_changed
nda.signed
dataroom.file_downloaded
search.new_match

Zasady korzystania

Cytowanie danych benchmarkowych z podaniem źródła jest bezpłatne.
Zabronione jest masowe pobieranie danych kontaktowych oraz budowanie z nich baz marketingowych.
Dane rejestrowe udostępniamy w zakresie zgodnym z §13.3 regulaminu — profile publiczne wyłącznie dla osób prawnych.
Przekroczenie limitu zwraca kod 429 wraz z nagłówkiem Retry-After.