# FirmeB2B API

REST API pentru căutarea companiilor din România (2M+ firme din surse publice: Registrul Comerțului, Ministerul Finanțelor).

## Autentificare
Toate requesturile necesită cheia ta API în header:
```
Authorization: Bearer TOKEN_API
```
sau ca parametru: `?api_key=TOKEN_API`

## Endpoint
```
GET https://firmeb2b.ro/api/v1/firme.php
```

## Parametri
| Param | Descriere | Exemplu |
|-------|-----------|---------|
| `q` | Căutare după nume/CUI | `q=dental` |
| `cui` | CUI exact | `cui=199095` |
| `caen` | Cod CAEN (mai multe cu virgulă) | `caen=6201,6202` |
| `judet` | Județ | `judet=Cluj` |
| `localitate` | Localitate | `localitate=Cluj-Napoca` |
| `ca_min` / `ca_max` | Cifră de afaceri (RON) | `ca_min=500000` |
| `cu_telefon` | Doar cu telefon | `cu_telefon=1` |
| `cu_email` | Doar cu email | `cu_email=1` |
| `cu_website` | Doar cu website | `cu_website=1` |
| `page` | Pagina | `page=2` |
| `per_page` | Rezultate/pagină (max după plan) | `per_page=100` |

## Exemplu
```bash
curl "https://firmeb2b.ro/api/v1/firme.php?judet=Cluj&caen=6201&cu_telefon=1&per_page=50" \
  -H "Authorization: Bearer TOKEN_API"
```

## Răspuns
```json
{
  "ok": true,
  "plan": "growth",
  "quota": 25000,
  "used": 12,
  "remaining": 24988,
  "page": 1,
  "per_page": 50,
  "total": 2644,
  "count": 50,
  "data": [
    { "cui": "...", "nume": "...", "caen": "6201", "judet": "Cluj",
      "localitate": "...", "adresa": "...", "telefon": "...", "email": "...",
      "website": "...", "website_rank": 82 }
  ]
}
```

## Coduri de status
- `200` OK
- `401` cheie API lipsă/invalidă
- `402` abonament inactiv
- `429` cotă lunară depășită → fă upgrade

## Planuri
| Plan | Preț | Requesturi/lună |
|------|------|-----------------|
| Starter | 19€ | 5.000 |
| Growth | 49€ | 25.000 |
| Pro | 149€ | 150.000 |
| Business | 399€ | 1.000.000 |

Cumpără / gestionează: https://firmeb2b.ro/api