REST API Documentation - adresa.apidata.ro

Base URL

https://adresa.apidata.ro/api/v1

Endpoints

GET /api/v1/search Cautare strazi cu filtrare exacta dupa oras/judet ▼

Parametri

q* string Textul de cautat in numele strazii

city string Filtreaza exact dupa oras, sector sau judet

limit integer Numar maxim rezultate (default: 20, max: 50)

curl "https://adresa.apidata.ro/api/v1/search?q=victoriei&city=bucuresti&limit=5"

import requests

response = requests.get("https://adresa.apidata.ro/api/v1/search", params={
    "q": "victoriei",
    "city": "bucuresti",
    "limit": 5
})

streets = response.json()["results"]
for street in streets:
    print(street["full_address"])

const response = await fetch(
    "https://adresa.apidata.ro/api/v1/search?q=victoriei&city=bucuresti&limit=5"
);
const data = await response.json();

data.results.forEach(street => {
    console.log(street.full_address);
});

Raspuns

{
    "query": "victoriei",
    "count": 2,
    "results": [
        {
            "name": "Calea Victoriei",
            "city": "București",
            "sector": "Sector 1",
            "county": "București",
            "postcode": "010061",
            "full_address": "Calea Victoriei, Sector 1, București",
            "score": 15.2
        }
    ]
}

GET /api/v1/full-search Cautare combinata strada + oras in acelasi query ▼

Parametri

q* string Query combinat (ex: "eminescu cluj", "victoriei sector 1")

limit integer Numar maxim rezultate (default: 20, max: 50)

curl "https://adresa.apidata.ro/api/v1/full-search?q=eminescu%20cluj&limit=5"

import requests

# Cauta "eminescu" in Cluj
response = requests.get("https://adresa.apidata.ro/api/v1/full-search", params={
    "q": "eminescu cluj",
    "limit": 5
})

for street in response.json()["results"]:
    print(street["full_address"])

GET /api/v1/counties Lista tuturor judetelor din Romania ▼

curl "https://adresa.apidata.ro/api/v1/counties"

import requests

response = requests.get("https://adresa.apidata.ro/api/v1/counties")
counties = response.json()["counties"]

print(f"Total judete: {len(counties)}")
# ['Alba', 'Arad', 'Argeș', 'Bacău', ...]

Raspuns

{
    "count": 42,
    "counties": ["Alba", "Arad", "Argeș", "Bacău", "..."]
}

GET /api/v1/cities Lista oraselor, optional filtrate dupa judet ▼

Parametri

county string Filtreaza dupa judet. Pentru București returneaza sectoarele.

# Orase din Cluj
curl "https://adresa.apidata.ro/api/v1/cities?county=Cluj"

# Sectoare Bucuresti
curl "https://adresa.apidata.ro/api/v1/cities?county=Bucuresti"

import requests

# Orase din Cluj
response = requests.get("https://adresa.apidata.ro/api/v1/cities", params={
    "county": "Cluj"
})
cities = response.json()["cities"]

# Sectoare Bucuresti
response = requests.get("https://adresa.apidata.ro/api/v1/cities", params={
    "county": "Bucuresti"
})
sectors = response.json()["cities"]
# ['Sector 1', 'Sector 2', ..., 'Sector 6']

GET /api/v1/stats Statistici despre indexul de strazi ▼

curl "https://adresa.apidata.ro/api/v1/stats"

Raspuns

{
    "total_streets": 204532,
    "index_size": 52428800,
    "index_size_human": "50.0mb"
}

GET /api/v1/usage Statistici utilizare API ▼

Parametri

days integer Numar zile pentru breakdown zilnic (default: 30, max: 365)

curl "https://adresa.apidata.ro/api/v1/usage?days=7"

Raspuns

{
    "total": {
        "/api/v1/search": 1250,
        "/api/v1/full-search": 3420,
        "/api/v1/counties": 89,
        "/api/v1/cities": 156
    },
    "today": {
        "/api/v1/full-search": 127
    },
    "daily": {
        "2025-01-19": {"/api/v1/full-search": 127},
        "2025-01-18": {"/api/v1/full-search": 342}
    },
    "total_requests": 4915
}

Response fields

name string Numele complet al strazii (ex: "Strada Victoriei")

city string Numele orasului

sector string Sectorul (doar pentru București)

county string Judetul

postcode string Codul postal

full_address string Adresa completa formatata

county_code string Codul judetului

county_siruta string Codul SIRUTA al judetului

city_code string Codul localitatii

city_siruta string Codul SIRUTA al localitatii