---
title: "Statisticile unei selecții, cu etalonul național (gratuit, cere cont)"
method: GET
path: "/api/v1/statistici"
tags: ["Prospectare"]
---

# Statisticile unei selecții, cu etalonul național (gratuit, cere cont)

`GET /api/v1/statistici`

## Request

- Base URL: `https://firmoscop.ro`
- URL: `https://firmoscop.ro/api/v1/statistici`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `fs_session`

Aceleași filtre ca `/api/v1/companies`, dar răspunsul e agregat: categorii și numere, niciun rând de firmă. Fiecare categorie poartă și ponderea ei la nivel național (`nationalSharePct`), ca felia să se poată citi în context. Nu costă credite — creditul plătește lista de firme, nu un procent. Obligatoriu cel puțin `caen` sau `county`, ca la listare.

## Query parameters

- `breakdown` 'judet' | 'activitate' | 'an_infiintare' | 'grupa_angajati' | 'grupa_cifra_afaceri' | 'tip_localitate' | 'forma_juridica'
- `caen` string
- `county` string
- `state` 'active' | 'insolvent'
- `legalForm` string

## Response `200`

Categoriile selecției, cu ponderea proprie și cea națională.

- object
  - `filters` object
  - `breakdown` string
  - `breakdownLabel` string
  - `total` StatBucket: O categorie din statistica unei selecții. Valorile financiare sunt `null` când nicio firmă din categorie n-are bilanț cunoscut — „nu știm" nu se raportează ca zero.
    - `key` string: Cheia stabilă a categoriei.
    - `label` string: Eticheta în română.
    - `companies` integer
    - `turnover` integer, nullable: Suma cifrelor de afaceri cunoscute (lei).
    - `medianTurnover` integer, nullable
    - `employees` integer, nullable
    - `netResult` integer, nullable
    - `sharePct` number, nullable: Ponderea în selecție.
    - `nationalSharePct` number, nullable: Ponderea aceleiași categorii în toată baza. `null` = nemăsurată, NU zero.
  - `buckets` StatBucket[]
    - `key` string: Cheia stabilă a categoriei.
    - `label` string: Eticheta în română.
    - `companies` integer
    - `turnover` integer, nullable: Suma cifrelor de afaceri cunoscute (lei).
    - `medianTurnover` integer, nullable
    - `employees` integer, nullable
    - `netResult` integer, nullable
    - `sharePct` number, nullable: Ponderea în selecție.
    - `nationalSharePct` number, nullable: Ponderea aceleiași categorii în toată baza. `null` = nemăsurată, NU zero.
  - `truncated` integer: Categorii rămase în afara plafonului de 14. Zero = nu s-a tăiat nimic.

## Other responses

- `400`: Eroare — corp JSON { error, message } în limbaj natural.
- `401`: Eroare — corp JSON { error, message } în limbaj natural.
- `429`: Eroare — corp JSON { error, message } în limbaj natural.
- `503`: Eroare — corp JSON { error, message } în limbaj natural.

---

[API](https://skmtc.dev/firmoscop/apis/firmoscop-api.md) · [All operations](https://skmtc.dev/firmoscop/apis/firmoscop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/firmoscop/apis/firmoscop-api/revisions/58c82b29bbfc?raw)