Locations v1 / Statistici INS

Seria unui indicator INS

Toate valorile din timp ale unui indicator pentru un județ, cronologic — pentru grafice de
evoluție. Cheile de indicator sunt la /statistici/ins/indicatori.

GET

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

Parametri de cale

NumeTipDescriereExemplu

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

indicatorobligatoriu string Indicatorul statistic cerut. Lista completă e în nomenclatorul rutei.

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Seria completă, în ordine cronologică — de la prima perioadă publicată de INS până la ultima.
Lungimea diferă de la indicator la indicator (populația începe din 1992, ocuparea mult mai târziu).
Cheile valide sunt la /statistici/ins/indicatori.

La ce folosește

Grafic de evoluție: populația unui județ pe 30+ ani.
Calcul de trend (creștere/scădere) între două perioade, fără să ceri fiecare an separat.
Alimentarea unui model cu seria completă a unui indicator regional.

Structura răspunsului

CâmpTipDescriere

data.judet string Numele județului.

data.indicator string Cheia indicatorului cerut.

data.nume string Denumirea indicatorului.

data.tema string Tema din care face parte.

data.um string | null Unitatea de măsură, valabilă pentru toată seria.

data.sursa string Sursa datelor (INS TEMPO).

data.matrice string Matricea TEMPO sursă.

data.serie[].data string Perioada de referință (data de început).

data.serie[].valoare number Valoarea în acea perioadă.

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/populatie_domiciliu

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

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

{
    "data": {
        "judet": "Timiș",
        "indicator": "salariati",
        "nume": "Numărul mediu al salariaților",
        "tema": "ocupare",
        "um": "Numar persoane",
        "sursa": "INS TEMPO",
        "matrice": "FOM104B",
        "serie": [
            {
                "data": "1990-01-01",
                "valoare": 282360
            }
        ]
    },
    "meta": {
        "actualizat": {
            "ins_tempo": "2026-09-07"
        }
    }
}

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

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

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

{
    "data": {
        "judet": "București",
        "indicator": "populatie_domiciliu",
        "nume": "Populația după domiciliu (1 ianuarie)",
        "tema": "demografie",
        "um": "Numar persoane",
        "sursa": "INS TEMPO",
        "matrice": "POP107A",
        "serie": [
            {
                "data": "1992-01-01",
                "valoare": 2188461
            }
        ]
    },
    "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 sau indicatorul nu există; ori indicatorul n-are date pentru județ.
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 sau indicatorul nu există; ori indicatorul n-are date pentru județ."
    }
}