İhaleGlobal Araştırma EnstitüsüAçık Veri API'si · v1

Açık Veri API'si

Türkiye kamu alımlarının kamuya açık agrega göstergelerine — rekabet endeksi, tek teklif oranı, tenzilat, doğrudan temin hacmi, il ve sektör kırılımları — salt-okunur, JSON, programatik erişim. Akademik ve gazetecilik kullanımı için açık; atıfla serbestçe kullanılır.

● Salt-okunur REST Format: JSON Lisans: CC BY 4.0 Kişisel veri / VKN içermez
Gizlilik güvencesi. Bu API yalnızca agrega döndürür. Vergi kimlik numarası (VKN), kişisel adres, kaybeden teklif kimliği veya herhangi bir kişisel veri hiçbir uç noktada bulunmaz. Firma ve kamu kurumu unvanları, kamuya açık ihale sonuç kayıtlarının bir parçası olarak ve yalnızca sıralı özet (kova başına en yüksek 10) bağlamında yer alır.

Başlangıç

Kimlik doğrulama, herkese açık apikey anahtarıyla yapılır (Supabase anon anahtarı — tasarımı gereği publiktir). Taban yol:

# Taban yol
https://ihaleglobal.com/rest/v1/

# Örnek: yıl bazında genel rekabet endeksi (tek teklif oranı + tenzilat).
# yil=gt.0 → yıl toplamı satırını (yil=0) atlar, 2019'dan bugüne tüm yılları verir.
curl "https://ihaleglobal.com/rest/v1/veri_rekabet_endeksi?boyut=eq.genel&yil=gt.0&order=yil.asc" \
  -H "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoiYW5vbiIsImlzcyI6InN1cGFiYXNlIiwiaWF0IjoxNzg0MzA3MTU4LCJleHAiOjE5NDE5ODcxNTh9.CjNKulvirotDD_y2oO2QKgo0kbqYvL0jUSV1RiDMoso"

Yanıt (kısaltılmış):

[
  { "boyut":"genel", "deger":"Tumu", "yil":2019, "ihale_sayisi":122297, "tek_teklif_pct":33.4, "tenzilat_ort":16.5, "kapsama_pct":100 },
  { "boyut":"genel", "deger":"Tumu", "yil":2024, "ihale_sayisi":143207, "tek_teklif_pct":36.4, "tenzilat_ort":15.0, "kapsama_pct":100 }
]

Python (pandas):

import pandas as pd, requests
H = {"apikey": "<public-anon-key>"}
url = "https://ihaleglobal.com/rest/v1/veri_rekabet_endeksi"
df = pd.DataFrame(requests.get(url, headers=H, params={"boyut":"eq.sektor","yil":"eq.2024"}).json())

Uç Noktalar

On iki salt-okunur uç nokta, iki katmanda. Katman 1 saf kategori agregasıdır (isim içermez). Katman 2, kamuya açık firma/kurum unvanlarıyla sıralı özet sunar.

◆ Katman 1 — Kategori agregaları (isim içermez)
GET/rest/v1/veri_rekabet_endeksiRekabet endeksi: tek teklif oranı + tenzilat

Kolonlar: boyut (genel·il·sektor·usul·idare_tur), deger, yil, ihale_sayisi, tek_teklif_pct, tenzilat_ort, kapsama_pct

curl "https://ihaleglobal.com/rest/v1/veri_rekabet_endeksi?boyut=eq.sektor&yil=eq.2024&order=tek_teklif_pct.desc" -H "apikey: <key>"
GET/rest/v1/veri_dt_endeksiDoğrudan temin: işlem sayısı + medyan bedel

Kolonlar: boyut (genel·il·sektor·idare_tur), deger, yil, islem_sayisi, medyan_bedel, ort_bedel

curl "https://ihaleglobal.com/rest/v1/veri_dt_endeksi?boyut=eq.sektor&yil=eq.2025&order=islem_sayisi.desc" -H "apikey: <key>"
GET/rest/v1/veri_il_sektorİl × sektör ihale hacmi

Kolonlar: il, sektor, ihale_sayisi, toplam_bedel

curl "https://ihaleglobal.com/rest/v1/veri_il_sektor?il=eq.ANKARA&order=toplam_bedel.desc" -H "apikey: <key>"
GET/rest/v1/veri_il_yerlilikİl × sektör yerli firma payı

Kolonlar: il, sektor, ihale_sayisi, toplam_bedel, yerli_bedel, disari_bedel, yerli_pct

curl "https://ihaleglobal.com/rest/v1/veri_il_yerlilik?il=eq.KONYA&order=yerli_pct.asc" -H "apikey: <key>"
GET/rest/v1/veri_il_ticaret_akisiİl → il tedarik akışı

Kolonlar: idare_il (alan kurumun ili), firma_il (yüklenicinin ili), sozlesme_sayisi, bedel

curl "https://ihaleglobal.com/rest/v1/veri_il_ticaret_akisi?idare_il=eq.VAN&order=bedel.desc" -H "apikey: <key>"
◆ Katman 2 — Sıralı özet (firma/kurum unvanı; VKN yok)
GET/rest/v1/veri_il_top_kurumİl bazında en çok harcayan kamu kurumları

Kolonlar: il, kurum, sozlesme_sayisi, bedel, sira (1–10)

curl "https://ihaleglobal.com/rest/v1/veri_il_top_kurum?il=eq.İZMİR&order=sira.asc" -H "apikey: <key>"
GET/rest/v1/veri_sektor_top_kurumSektör bazında en çok alım yapan kurumlar

Kolonlar: sektor, kurum, sozlesme_sayisi, bedel, sira

GET/rest/v1/veri_il_dt_top_kurumİl bazında doğrudan temin — top kurumlar

Kolonlar: il, kurum, alim_sayisi, bedel, sira

GET/rest/v1/veri_il_top_firmaİl başına top-10 yüklenici (ihale)

Kolonlar: il, firma, firma_il, sozlesme_sayisi, bedel, sira

curl "https://ihaleglobal.com/rest/v1/veri_il_top_firma?il=eq.BURSA&order=sira.asc" -H "apikey: <key>"
GET/rest/v1/veri_sektor_top_firmaSektör başına top-10 yüklenici (ihale)

Kolonlar: sektor, firma, firma_il, sozlesme_sayisi, bedel, sira

GET/rest/v1/veri_il_merkez_firmaİlde merkezli top firmalar (ciro)

Kolonlar: il (firmanın ili), firma, sozlesme_sayisi, ciro, sira

GET/rest/v1/veri_il_dt_top_firmaİl bazında doğrudan temin — top yükleniciler

Kolonlar: il, firma, alim_sayisi, bedel, sira

Sorgulama, sayfalama ve hız

Uç noktalar PostgREST üzerinde çalışır; standart filtre, sıralama ve sayfalama söz dizimi geçerlidir.

AmaçSöz dizimi
Eşitlik filtresi?yil=eq.2024
Tüm zamanlar satırıEndeks uçlarında yil=0 = tüm dönem rollup'ı (havuzlanmış oran, yılların ortalaması değil). Yıl serisi çekerken ?yil=gt.0 ekleyin.
Karşılaştırma?bedel=gte.1000000 · gt·lt·lte·neq
Liste içinde?boyut=in.(il,sektor)
Sıralama?order=bedel.desc · ?order=yil.asc,sira.asc
Kolon seçme?select=il,tek_teklif_pct
Sayfalama (limit/offset)?limit=100&offset=200
Toplam satır sayısıHeader: Prefer: count=exact → yanıtta Content-Range

Hız sınırı: IP başına ~2 istek/sn (kısa taşmalara izin verilir), aşımda 429. Toplu/otomatik çekim için lütfen istekleri makul aralıklarla yollayın; daha yoğun araştırma ihtiyaçları için bize ulaşın.

Lisans ve atıf

Veri CC BY 4.0 altında sunulur: kopyalayabilir, dönüştürebilir, ticari dahil her amaçla kullanabilirsiniz — tek koşul atıf. Kaynak, EKAP'ın kamuya açık ihale ve doğrudan temin kayıtlarıdır; agregalar İhaleGlobal veri altyapısında üretilmiştir. Yöntem Araştırma Enstitüsü Yöntem bölümünde açıktır.

Önerilen atıf: İhaleGlobal Araştırma Enstitüsü, "Türkiye Kamu Alımları Açık Veri API'si", ihaleglobal.com/veri-api (erişim: 2026).  ·  Lisans: CC BY 4.0  ·  Kullanım Şartları

Kapsam sınırları: