API căutare firme după nume sau CUI
GET/api/v1/cauta?q=&judet=&limit=1 cerere
Pentru câmpurile în care utilizatorul începe să scrie numele firmei: trimiți primele litere ale denumirii (minim 3, fără diacritice sau majuscule) sau un CUI și primești lista firmelor potrivite, cu CUI, județ, localitate și stare. Firmele cu cifra de afaceri cea mai mare apar primele.
- 100 de cereri gratuite la prima cheie
- cererile nu expiră
- de la 3,98 lei / 1.000 cereri
La ce folosești endpoint-ul
Autocomplete „caută firma”
Utilizatorul scrie „dedem” și alege DEDEMAN SRL din listă; apoi iei datele complete cu /firma/{cui}.
Găsirea CUI-ului după nume
Ai doar denumirea clientului dintr-un import vechi și vrei CUI-ul, opțional filtrat pe județ.
Deduplicare
Verifici dacă o firmă introdusă de mână există deja în registru sub altă formă a numelui.
Cerere
Pentru câmpuri de tip „caută firma”: după începutul denumirii (fără diacritice sau majuscule) sau după CUI. Firmele mari apar primele.
- q
- Începutul denumirii (minim 3 litere) sau un CUI.
- judet
- Opțional: județul, ca slug (arges, bucuresti, cluj, satu-mare …).
- limit
- Opțional: câte rezultate, 1–20 (implicit 10).
Cheia se trimite în antetul Authorization: Bearer <cheie> sau x-api-key. Limita: 10 cereri pe secundă pe cheie. Apelează API-ul de pe server, nu din browser.
curl https://bazadate.ro/api/v1/cauta?q=dedeman&judet=bacau \
-H "Authorization: Bearer $BAZADATE_API_KEY"Răspuns 200 (JSON)
{
"rezultate": [
{ "cui": 2816464, "denumire": "DEDEMAN SRL", "judet": "Bacău", "localitate": "Bacău", "stare": "funcțiune" }
]
}| Câmp | Ce conține |
|---|---|
| rezultate[].cui | CUI-ul firmei, folosit apoi la /firma/{cui} sau /firma/{cui}/bilant. |
| rezultate[].denumire | Denumirea din registrul comerțului. |
| rezultate[].judet, localitate | Sediul firmei. |
| rezultate[].stare | Starea din registru. |
Erorile au formatul { "eroare": "mesaj", "cod": "cod_eroare" } și nu se taxează (CUI invalid, negăsit, fără rezultate, depășirea ritmului, eroare de server). Lista completă: coduri de răspuns.
Întrebări frecvente
Câte rezultate primesc?
Implicit 10, cel mult 20 (parametrul limit). O căutare costă o cerere, indiferent de numărul de rezultate.
Se taxează căutările fără rezultat?
Nu. O căutare fără rezultate primește 404 și nu consumă din sold.
Contează diacriticele?
Nu. „brasov” și „Brașov” dau aceleași rezultate; căutarea se face după începutul denumirii.
Celelalte endpoint-uri
Testează gratuit, cu 100 de cereri
Creezi cheia din cont, fără card. Apoi pachete preplătite care nu expiră, cu factură automată.
Surse: Oficiul Național al Registrului Comerțului (data.gov.ro, licență CC BY 4.0), ANAF (serviciul public PlatitorTvaRest), Ministerul Finanțelor (situații financiare anuale).