API Firme Noi

Integrează datele despre firme noi direct în aplicația ta. API REST modern, simplu de utilizat și complet documentat.

De ce să folosești API-ul nostru?

Rapid și Performant

Răspunsuri rapide cu limită de 100 cereri/secundă per endpoint

Securitate Maximă

Autentificare cu API Key prin header X-API-Key sau Bearer token

Date Complete

Acces la toate companiile din România actualizate zilnic

Paginare Eficientă

Suport pentru paginare cu până la 100 rezultate per pagină

// Exemplu de request

const response = await fetch('https://api.firmenoi.ro/api/v1/companies/new?date=2025-01-01', {
    method: 'GET',
    headers: {
        'X-API-Key': 'YOUR_API_KEY',
        // sau
        'Authorization': 'Bearer YOUR_API_KEY'
    }
});

const data = await response.json();
console.log(data.companies);

Endpoint-uri Disponibile

GET

/api/v1/companies/new

Abonament Special

Returnează companiile noi înregistrate începând cu data specificată.

Parametri:

date - Data de început (YYYY-MM-DD) [opțional]

Răspuns:

{
  "companies": [{...}],
  "total": 100,
  "page": 1,
  "per_page": 50
}

GET

/api/v1/companies/all

Abonament Special

Returnează toate companiile înregistrate până la data specificată. Suportă paginare.

Parametri:

date - Data limită (YYYY-MM-DD) [opțional]
page - Numărul paginii (implicit: 1)
per_page - Rezultate per pagină (1-100, implicit: 50)

Pentru a obține toate rezultatele, iterați prin pagini folosind parametrii de paginare.

Exemplu paginare:

// Pagina 1
GET /api/v1/companies/all?page=1&per_page=50

// Pagina 2
GET /api/v1/companies/all?page=2&per_page=50

GET

/api/v1/companies/search

Toate Abonamentele

Returnează detaliile unei companii pe baza CUI-ului.

Parametri:

cui - CUI-ul companiei (obligatoriu)

Limitat la 1000 cereri/lună pentru abonamentele fără acces la API Toate Companiile.

Răspuns:

{
  "firma": {
    "cui": "12345678",
    "nregcom": "J12/345/2023",
    "denumire": "Exemplu SRL",
    "adresa": "Str. Exemplu, Nr. 1",
    "localitate": "Cluj-Napoca",
    "judet": "Cluj",
    "cod_postal": "400000"
  }
}

Structura Obiect Companie

Câmpuri principale:

cui - Codul Unic de Înregistrare
nregcom - Număr registru comerț
denumire - Denumirea companiei
data_inregistrare - Data înregistrării
telefon - Număr de telefon

Informații adresă:

adresa - Adresa completă
strada - Numele străzii
strada_nr - Numărul străzii
localitate - Localitatea
judet - Județul
judet_cod - Codul județului
cod_postal - Codul poștal

Autentificare și Securitate

Autentificare API

Pentru a utiliza API-ul, trebuie să includeți API Key-ul în header-ul HTTP. Puteți folosi oricare dintre cele două metode:

Opțiunea 1: X-API-Key header

X-API-Key: YOUR_API_KEY

Opțiunea 2: Bearer token

Authorization: Bearer YOUR_API_KEY

Ambele metode sunt acceptate și au aceeași funcționalitate.

Limite și Restricții

Rate Limiting: 100 cereri pe secundă per endpoint
API Căutare: 1000 cereri/lună pentru abonamentele de bază
Companii Noi: Disponibile doar de la data activării abonamentului

Exemple de Integrare

JavaScript / Node.js

Integrare simplă cu fetch API

Vezi exemplu →

Python

Utilizare cu requests library

Vezi exemplu →

cURL

Testare rapidă din terminal

Vezi exemplu →

Exemple de Cod

Python - Căutare companii noi

import requests
from datetime import datetime

# Configurare
API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://api.firmenoi.ro/api/v1'

headers = {
    'X-API-Key': API_KEY  # sau 'Authorization': f'Bearer {API_KEY}'
}

# 1. Obține companii noi
response = requests.get(
    f'{BASE_URL}/companies/new',
    headers=headers,
    params={'date': '2025-01-01'}
)
companii_noi = response.json()

for companie in companii_noi['companies']:
    print(f"{companie['denumire']} - CUI: {companie['cui']}")

# 2. Caută o companie specifică
cui = '12345678'
response = requests.get(
    f'{BASE_URL}/companies/search',
    headers=headers,
    params={'cui': cui}
)
detalii_firma = response.json()
print(detalii_firma['firma'])

JavaScript/Node.js - Toate companiile cu paginare

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://api.firmenoi.ro/api/v1';

// Funcție pentru a obține toate companiile cu paginare
async function getAllCompanies(date = null) {
    let page = 1;
    let allCompanies = [];
    let hasMore = true;
    
    while (hasMore) {
        const params = new URLSearchParams({
            page: page,
            per_page: 100
        });
        
        if (date) params.append('date', date);
        
        const response = await fetch(
            `${BASE_URL}/companies/all?${params}`,
            {
                headers: {
                    'X-API-Key': API_KEY
                }
            }
        );
        
        const data = await response.json();
        allCompanies = allCompanies.concat(data.companies);
        
        // Verifică dacă mai sunt pagini
        hasMore = (page * data.per_page) < data.total;
        page++;
    }
    
    return allCompanies;
}

// Utilizare
getAllCompanies('2025-02-01').then(companies => {
    console.log(`Total companii: ${companies.length}`);
    companies.forEach(c => {
        console.log(`${c.denumire} - ${c.localitate}, ${c.judet}`);
    });
});

cURL - Exemple de apeluri

# 1. Companii noi (cu X-API-Key)
curl -X GET "https://api.firmenoi.ro/api/v1/companies/new?date=2025-01-01" \
     -H "X-API-Key: YOUR_API_KEY"

# 2. Toate companiile cu paginare (cu Bearer token)
curl -X GET "https://api.firmenoi.ro/api/v1/companies/all?page=1&per_page=50" \
     -H "Authorization: Bearer YOUR_API_KEY"

# 3. Căutare companie după CUI
curl -X GET "https://api.firmenoi.ro/api/v1/companies/search?cui=12345678" \
     -H "X-API-Key: YOUR_API_KEY"

Începe să folosești API-ul acum

Primești 1000 de request-uri gratuite pentru a testa

Obține Token API Documentație Completă