Locations v1 / Statistici INS

Statistici INS pentru un județ

⭐ Ultima valoare a fiecărui indicator INS TEMPO pentru județ (cod auto, ex. CJ), grupată
pe teme: demografie, ocupare, economie, turism, locuire, cultură, agricultură. Complementar
cu /judete/{cod}/statistici, care dă agregatele de recensământ.

GET

https://oneapi.ro/api/locations/v1/judete/{cod}/statistici/ins

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul judeţului, două litere (ex. CJ). Bucureştiul e B.

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

⭐ Ultima valoare disponibilă pentru fiecare indicator INS TEMPO, cu tema pe fiecare rând.
Complementar cu /judete/{cod}/statistici: acolo sunt agregatele de recensământ (RPL2021, o singură fotografie), aici sunt serii oficiale actualizate, fiecare cu perioada proprie.
Perioadele diferă între indicatori (populația e la zi, ocuparea rămâne în urmă cu un an) — de aceea perioada vine pe fiecare rând, nu global.
Valorile sunt totalul județului: pe toate axele non-geografice ale matricei se ia „Total” (ambele sexe, urban+rural etc.).
Suma pe cele 42 de județe reproduce exact totalul național publicat de INS, cu o excepție așteptată: la exporturi/importuri, INS ține o categorie Nespecificat (~3%) neatribuită vreunui județ, deci suma județelor rămâne sub total.

La ce folosește

Fișa statistică a unui județ: populație, salariați, întreprinderi, turism, locuințe — într-un singur call.
Comparație între județe pe indicatori oficiali, cu perioada de referință explicită.
Completarea unui profil de piață peste datele de firme din /judete/{cod}/firme/sumar.

Structura răspunsului

CâmpTipDescriere

data.judet string Numele județului.

data.sursa string Sursa datelor (INS TEMPO).

data.indicatori[].indicator string Cheia indicatorului (pentru ruta de serie).

data.indicatori[].tema string Tema din care face parte indicatorul.

data.indicatori[].nume string Denumirea indicatorului.

data.indicatori[].valoare number Ultima valoare publicată.

data.indicatori[].um string | null Unitatea de măsură (ex. Numar persoane, Procente).

data.indicatori[].perioada string Perioada de referință a valorii (data de început).

data.indicatori[].matrice string Matricea TEMPO sursă.

meta.actualizat object Prospețimea datelor pe domenii (dată ISO 8601).

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/judete/CJ/statistici/ins

{
    "data": {
        "judet": "Cluj",
        "sursa": "INS TEMPO",
        "indicatori": [
            {
                "indicator": "populatie_domiciliu",
                "tema": "demografie",
                "nume": "Populația după domiciliu (1 ianuarie)",
                "valoare": 747392,
                "um": "Numar persoane",
                "perioada": "2026-01-01",
                "matrice": "POP107A"
            }
        ]
    },
    "meta": {
        "actualizat": {
            "ins_tempo": "2026-09-07"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/judete/B/statistici/ins

{
    "data": {
        "judet": "București",
        "sursa": "INS TEMPO",
        "indicatori": [
            {
                "indicator": "populatie_domiciliu",
                "tema": "demografie",
                "nume": "Populația după domiciliu (1 ianuarie)",
                "valoare": 2108049,
                "um": "Numar persoane",
                "perioada": "2026-01-01",
                "matrice": "POP107A"
            }
        ]
    },
    "meta": {
        "actualizat": {
            "ins_tempo": "2026-09-07"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/judete/AB/statistici/ins

{
    "data": {
        "judet": "Alba",
        "sursa": "INS TEMPO",
        "indicatori": [
            {
                "indicator": "populatie_domiciliu",
                "tema": "demografie",
                "nume": "Populația după domiciliu (1 ianuarie)",
                "valoare": 360199,
                "um": "Numar persoane",
                "perioada": "2026-01-01",
                "matrice": "POP107A"
            }
        ]
    },
    "meta": {
        "actualizat": {
            "ins_tempo": "2026-09-07"
        }
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
404	negasit	Județul nu există.
429	cota_depasita	Cota lunară a planului a fost depăşită (vezi `Retry-After`).

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "negasit",
        "mesaj": "Județul nu există."
    }
}