APIKAPI
GirişÜcretsiz anahtar al

Yerel Profil API

freeYayında2 endpoint · TÜİK (ADNKS, sosyoekonomik seviye, il göstergeleri) + PTT posta kodları · Yıllık; ETag ile 24 saat önbellek

Bir posta kodunu ya da ilçeyi, o yerin nüfus ve sosyoekonomik künyesine çevirir: TÜİK sosyoekonomik seviye skoru, 973 ilçe içindeki sıra ve yüzdelik dilim, nüfus kırılımı, ilin ekonomik göstergeleri. CRM zenginleştirme ve yer seçimi için; toplu uçla tek istekte 100 kayıt.

Ücretsiz anahtar alKonsolda deneDokümantasyon
curl "https://api.apikapi.com/v1/profile?postal_code=06420" \
  -H "X-API-Key: apk_…"
örnek yanıt · /v1/profile
{
  "data": {
    "resolution": {
      "province": {
        "code": 6,
        "name": "Ankara",
        "slug": "ankara"
      },
      "district": {
        "code": 1231,
        "name": "Çankaya",
        "slug": "cankaya"
      },
      "lat": 39.81167,
      "lng": 32.89236,
      "postal_code": "06420",
      "units": 10,
      "confidence": "official"
    },
    "population": {
      "year": 2025,
      "total": 952198,
      "male": 454348,
      "female": 497850,
      "density_per_km2": 1965.7,
      "province_share": 0.1611
    },
    "socioeconomic": {
      "score": 178.11,
      "national_rank": 1,
      "of": 973,
      "percentile": 100,
      "quintile": 1,
      "band": "en üst %20",
      "province_rank": 1,
      "province_of": 25
    },
    "province_context": {
      "gdp_per_capita_usd": {
        "value": 24031,
        "period": "2024"
      },
      "unemployment_rate": {
        "value": 8.5,
        "period": "2025"
      },
      "labour_force_rate": {
        "value": 55.2,
        "period": "2025"
      },
      "avg_education_years": {
        "value": 9.4,
        "period": "2025"
      }
    }
  }
}
Endpoint
2yayında
Katman
Freeücretsiz
Tazelik
Yıllık
Free aylık limit
2.000istek / ay
Neler var

Bir uygulamanın yerel profil için ihtiyacı olanlar

  • Posta kodu → ilçe çözümü, %99,9 tek ilçeye düşer
  • TÜİK sosyoekonomik seviye skoru, ülke sırası ve yüzdelik dilim
  • Nüfus, cinsiyet kırılımı, yoğunluk ve ilçenin il içindeki payı
  • İl bağlamı: kişi başı GSYH, işsizlik, işgücüne katılma, ortalama eğitim
  • Toplu uç: tek istekte 100 kayıt, çözülemeyen satır partiyi düşürmez
  • Çözüm güveni alanı: official, derived, estimated, ambiguous
GET/v1/profileYerel profilPOST/v1/profile/batchToplu yerel profil

Veri

Güncellendi 3 Eyl 2026
Kaynak
TÜİK (ADNKS nüfus, sosyoekonomik seviye skoru, il göstergeleri) + PTT posta kodları
Veri dönemi
ADNKS 2025 · SES güncel
Son güncelleme
3 Eyl 2026
Güncelleme sıklığı
yılda bir (kaynak veri setleri güncellendiğinde)
Beklenen sonraki güncelleme
Şubat 2027

Bu API sürüm parametresi almaz; geçmiş zaten veride: dönemi period ile seçersin.

Türetilmiş üründür: yeni veri toplamaz, geo/postal/population/stats veri setlerini birleştirir. Sosyoekonomik skor TÜİK'in ilçe bazlı ortalama sosyoekonomik seviye skorudur; ülke içindeki sıralama ve yüzdelik dilim 973 ilçe üzerinden sorgu anında hesaplanır. Skor Nielsen/TÜAD A-B-C1-C2-D-E ölçeğine ÇEVRİLMEZ — böyle bir eşleme resmî değildir; yerine ham skor, sıra ve beşte birlik dilim verilir.

KaynakTÜİK (ADNKS, sosyoekonomik seviye, il göstergeleri) + PTT posta kodları

Yıllık; ETag ile 24 saat önbellek.

KatmanFree ile başla

Tüm uçlar ücretsiz katmanda. Kota dolunca istekler 429 döner, veri kesilmez.

Fiyatlandırmayı gör →
Kimlik doğrulamaX-API-Key başlığı

Anahtarını konsolda profile kapsamına yetkilendir; kapsam dışı çağrılar 403 döner.

Referans

Endpoint referansı

GET

/v1/profile

Konsolda dene

Yerel profil — Posta kodunu ya da ilçe kodunu o yerin künyesine çevirir. Çözünürlük ilçe düzeyindedir; dönen koordinat ilçe merkezidir, adresin kendisi geocode edilmez.

Parametreler

ParametreTipYerZorunluAçıklama
postal_codestringsorguHayır5 haneli posta kodu. · örn. 06420
districtintegersorguHayırTÜİK ilçe kodu; postal_code verilmediğinde kullanılır. · örn. 1231

İstek

curl "https://api.apikapi.com/v1/profile?postal_code=06420" \
  -H "X-API-Key: apk_…"

Örnek yanıt

/v1/profile · 200
1{
2  "data": {
3    "resolution": {
4      "province": {
5        "code": 6,
6        "name": "Ankara",
7        "slug": "ankara"
8      },
9      "district": {
10        "code": 1231,
11        "name": "Çankaya",
12        "slug": "cankaya"
13      },
14      "lat": 39.81167,
15      "lng": 32.89236,
16      "postal_code": "06420",
17      "units": 10,
18      "confidence": "official"
19    },
20    "population": {
21      "year": 2025,
22      "total": 952198,
23      "male": 454348,
24      "female": 497850,
25      "density_per_km2": 1965.7,
26      "province_share": 0.1611
27    },
28    "socioeconomic": {
29      "score": 178.11,
30      "national_rank": 1,
31      "of": 973,
32      "percentile": 100,
33      "quintile": 1,
34      "band": "en üst %20",
35      "province_rank": 1,
36      "province_of": 25
37    },
38    "province_context": {
39      "gdp_per_capita_usd": {
40        "value": 24031,
41        "period": "2024"
42      },
43      "unemployment_rate": {
44        "value": 8.5,
45        "period": "2025"
46      },
47      "labour_force_rate": {
48        "value": 55.2,
49        "period": "2025"
50      },
51      "avg_education_years": {
52        "value": 9.4,
53        "period": "2025"
54      }
55    }
56  }
57}
POST

/v1/profile/batch

Konsolda dene

Toplu yerel profil — Tek istekte en fazla 100 kayıt. Çözülemeyen satırlar partiyi düşürmez: karşılıkları null olur ve query alanı girdiyi geri verir, böylece sonuçlar sıraya güvenmeden eşleştirilir.

Parametreler

ParametreTipYerZorunluAçıklama
itemsarraygövdeEvetEn fazla 100 kayıt; her biri postal_code ya da district taşır. · örn. [{"postal_code":"06420"}]

İstek

curl -X POST "https://api.apikapi.com/v1/profile/batch" \
  -H "X-API-Key: apk_…" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"postal_code":"06420"},{"postal_code":"34710"},{"district":1231}]}'

Örnek yanıt

/v1/profile/batch · 200
1{
2  "data": [
3    {
4      "query": {
5        "postal_code": "06420"
6      },
7      "profile": {
8        "resolution": {
9          "province": {
10            "code": 6,
11            "name": "Ankara",
12            "slug": "ankara"
13          },
14          "district": {
15            "code": 1231,
16            "name": "Çankaya",
17            "slug": "cankaya"
18          },
19          "confidence": "official"
20        },
21        "socioeconomic": {
22          "score": 178.11,
23          "national_rank": 1,
24          "of": 973,
25          "percentile": 100,
26          "band": "en üst %20"
27        }
28      }
29    },
30    {
31      "query": {
32        "postal_code": "99999"
33      },
34      "profile": null
35    }
36  ],
37  "count": 2,
38  "resolved": 1
39}