# VeriApi.Pro — Türkiye veri API'si (tam metin) > Bu dosya https://veriapi.pro/api altındaki sayfaların Markdown hâlidir. Temel adres: https://api.veriapi.pro/v1 · Kimlik: `X-API-Key` başlığı ya da `?anahtar=` · OpenAPI: https://api.veriapi.pro/v1/openapi.json · Dokümantasyon: https://veriapi.pro/dokumantasyon Yanıt zarfı: `{"veri": …, "kaynak": [{kod, ad, lisans, atif, url}], "guncelleme": "…", "bayat": false}`; hata `{"hata": {"kod", "mesaj"}}`. Her uç kotadan istek birimi düşer (çoğu 1 birim). ## Paketler ve fiyatlar | Paket | Aylık (KDV dahil) | Yıllık | Günlük istek birimi | API anahtarı | SLA | |---|---|---|---|---|---| | Ücretsiz | Ücretsiz | — | 500 | 1 | yok | | Başlangıç | 149 TL | 1.490 TL | 10.000 | 3 | %99 | | Profesyonel | 399 TL | 3.990 TL | 50.000 | 10 | %99 | | İşletme | 999 TL | 9.990 TL | 250.000 | 50 | %99 | Ücretsiz pakette sitede VeriApi.Pro bağlantısı (atıf) zorunludur ve bazı uçlar kapalıdır; anahtar 90 günde bir panelden yenilenir. Yıllık plan 10 aylık ücrettir. Destek (iş günleri 09.00–18.00): Ücretsiz: Dokümantasyon ve e-posta (yanıt süresi garantisiz); Başlangıç: E-posta desteği: en geç 1 iş günü içinde yanıt; Profesyonel: Öncelikli e-posta desteği: sıranın önünde, en geç 1 iş günü; İşletme: Öncelikli e-posta desteği: sıranın önünde, en geç 1 iş günü. Kurumsal (teklifle): Haber yazılımı firmaları, ajanslar, yüksek trafikli siteler ve uygulamalar için sözleşmeli, size özel paket. Size özel günlük kota ve dakika sınırı; Markasız kullanım ve müşterilerinize yeniden sunma (haber yazılımı, ajans); İhtiyacınıza özel veri ya da uç geliştirme; Sözleşmeli SLA, fatura ve ödeme koşulları; Entegrasyonda birebir teknik yardım; Telefon / WhatsApp desteği (iş günleri 09.00–18.00) ve öncelikli e-posta. Teklif: https://veriapi.pro/kurumsal # Konum ve adres ## İl, İlçe, Mahalle API Sayfa: https://veriapi.pro/api/il-ilce-mahalle-api 81 il, 973 ilçe ve 45.000'den fazla mahalle/köy; adlar, plaka kodları ve koordinatlarla. /v1/konumlar/iller tüm illeri plaka koduyla, /v1/konumlar/iller/{il}/ilceler ilçeleri koordinatlarıyla döndürür; adres formlarındaki il → ilçe açılır listesi için tek istek yeter. /v1/konumlar/bul bir koordinatın en yakın il ve ilçesini bulur. Mahalle ve köyler /v1/konumlar/mahalleler ve /v1/konumlar/yerler/ara uçlarında. Mahalle/köy verisi Wikidata'dan (CC0) derlenir ve kapsamı resmî listeden azdır; adres doğrulama için posta kodu verisiyle birlikte kullanılmalıdır. ### Uçlar - `GET /v1/konumlar/iller` — 81 il ve 973 ilçe, koordinatlarıyla (tüm paketler, 1 birim) - `GET /v1/konumlar/iller/{il}/ilceler` — İlin ilçeleri (tüm paketler, 1 birim); parametreler: `il`* - `GET /v1/konumlar/bul` — Konum çöz (slug, il/ilçe ya da en yakın koordinat) (tüm paketler, 1 birim); parametreler: `konum`, `il`, `ilce`, `enlem`, `boylam` - `GET /v1/konumlar/mahalleler` — İl/ilçe → mahalle ve köyler (kısayol) (ücretli paket, 1 birim); parametreler: `il`*, `ilce`*, `tur` - `GET /v1/konumlar/yerler/ara` — Mahalle / köy ara (ücretli paket, 1 birim); parametreler: `q`*, `il`, `tur`, `limit` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/konumlar/iller/duzce/ilceler"` ### Kullanım örnekleri - E-ticaret ve kayıt formlarında il/ilçe seçimi - Koordinattan ilçe bulma - Yerel rehber ve harita uygulamaları ### Sık sorulan sorular **İl ilçe API'si ücretsiz mi?** İl ve ilçe uçları ücretsiz pakette açıktır; mahalle/köy uçları Başlangıç ve üstü paketlerdedir. **İlçe sayısı güncel mi?** Evet, 973 ilçe (resmî sayı) bulunur. **Koordinatlar nereden?** İl ve ilçe merkez koordinatları Wikidata'dan (CC0) alınır. ## Posta Kodu ve Kargo API Sayfa: https://veriapi.pro/api/posta-kodu-api 73.000'den fazla mahallenin posta kodu: koddan adrese, adresten koda. /v1/posta-kodu bir posta kodunun il, ilçe ve mahallelerini; /v1/posta-kodu/ara il, ilçe ve mahalle adından posta kodunu bulur. Adres formlarında otomatik doldurma ve doğrulama için kullanılır. /v1/kargo/takip takip numarasının biçiminden olası kargo firmasını tahmin eder ve resmî takip sayfasının bağlantısını verir (canlı gönderi durumu döndürmez). Firmaların listesi /v1/kargo/firmalar'da. ### Uçlar - `GET /v1/posta-kodu` — Posta kodu → il, ilçe, mahalle (tüm paketler, 1 birim); parametreler: `kod`* - `GET /v1/posta-kodu/ara` — İl / ilçe (/ mahalle) → posta kodları (ücretli paket, 1 birim); parametreler: `il`*, `ilce`, `mahalle`, `limit` - `GET /v1/kargo/takip` — Takip numarasından kargo firması ve takip bağlantısı (tüm paketler, 1 birim); parametreler: `no`*, `firma` - `GET /v1/kargo/firmalar` — Kargo firmaları ve resmî takip sayfaları (tüm paketler, 1 birim) Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/posta-kodu?kod=81650"` ### Kullanım örnekleri - E-ticaret ödeme sayfasında adres doldurma - CRM'de adres doğrulama - Sipariş e-postasında kargo takip bağlantısı ### Sık sorulan sorular **Kargo durumunu gösteriyor mu?** Hayır; yalnızca firmayı tahmin eder ve resmî takip sayfasının bağlantısını verir. **Posta kodu verisi ne kadar güncel?** Mart 2024 tarihli derlemedir; yeni kurulan mahalleler eksik olabilir. ## Şehir Rehberi API Sayfa: https://veriapi.pro/api/sehir-rehberi-api Her il ve ilçe için gezilecek yerler ve önemli tesisler; konuma göre en yakınlarıyla. /v1/rehber/gezilecek bir ilçenin ya da ilin gezilecek yerlerini önem puanına göre sıralı verir: müze, kale, ören yeri, milli park, mağara, göl ve şelale, plaj, seyir noktası, anıt ve tarihî yapılar; adres, web, telefon, açılış saatleri ve Wikipedia bağlantısıyla. ?enlem=&boylam=&yaricap= ile bir noktanın çevresindekiler mesafeye göre gelir. /v1/rehber/tesisler hastane, üniversite, kütüphane, alışveriş merkezi, havalimanı, tren istasyonu ve iskeleleri listeler. Veri OpenStreetMap'ten gelir, ayda bir yenilenir; yayımlarken '© OpenStreetMap katkıcıları' atfı gerekir (ODbL). ### Uçlar - `GET /v1/rehber/gezilecek` — Şehir rehberi: il / ilçenin gezilecek yerleri (müze, kale, mağara, şelale, plaj…) (ücretli paket, 2 birim); parametreler: `konum`, `il`, `ilce`, `enlem`, `boylam`, `tur`, `yaricap`, `limit` - `GET /v1/rehber/tesisler` — Hastane, üniversite, kütüphane, AVM, havalimanı, tren istasyonu, iskele (ücretli paket, 2 birim); parametreler: `konum`, `il`, `ilce`, `enlem`, `boylam`, `tur`, `yaricap`, `limit` - `GET /v1/rehber/kategoriler` — Şehir rehberi türleri (gezilecek yerler ve tesisler) (tüm paketler, 1 birim) Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/rehber/gezilecek?konum=ankara-altindag&limit=5"` ### Kullanım örnekleri - Yerel portallarda 'gezilecek yerler' sayfası - Turizm ve gezi uygulamaları - Belediye siteleri için ilçe rehberi ### Sık sorulan sorular **Şehir rehberi ücretsiz pakette var mı?** Gezilecek yerler ve tesisler Başlangıç ve üstü paketlerdedir (2 birim); tür listesi her pakette açıktır. **Veri nereden geliyor?** OpenStreetMap topluluk verisinden (ODbL lisansı); ayda bir güncellenir. **Yakınımdaki yerleri alabilir miyim?** Evet; enlem, boylam ve yaricap (km) verirseniz ilin tüm listesi mesafeye göre sıralanır. ## İl ve İlçe Sınırları API Sayfa: https://veriapi.pro/api/il-ilce-sinirlari-api Bir koordinatın hangi il ve ilçede olduğunu sınır poligonuyla kesin olarak bulun; ilçe sınırlarını GeoJSON alın. /v1/konumlar/sinir/bul?enlem=&boylam= noktayı içeren ilçeyi ilçe sınırına göre döndürür; en yakın ilçe merkezine bakan yöntemlerin aksine sınır komşusu ilçeleri karıştırmaz. Sınır dışında kalan noktalarda (deniz) en yakın ilçe verilir ve kesin: false ile belirtilir. /v1/konumlar/sinir?konum=ankara-cankaya bir ilçenin, ?il=ankara bir ilin tüm ilçelerinin sınırını GeoJSON olarak verir; harita uygulamalarına doğrudan eklenebilir. Sınırlar OpenStreetMap verisidir (ODbL) ve 90 günde bir yenilenir. ### Uçlar - `GET /v1/konumlar/sinir/bul` — Koordinat hangi il ve ilçede? (sınır poligonuyla kesin) (tüm paketler, 1 birim); parametreler: `enlem`*, `boylam`* - `GET /v1/konumlar/sinir` — İl ya da ilçe sınırı (GeoJSON; il → ilçeleriyle FeatureCollection) (ücretli paket, 2 birim); parametreler: `konum`, `il`, `ilce` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/konumlar/sinir/bul?enlem=39.9255&boylam=32.8663"` ### Kullanım örnekleri - Kullanıcının konumundan il / ilçe göstermek - Harita üzerinde ilçe sınırları çizmek - Adres verisini ilçeye göre gruplamak ### Sık sorulan sorular **Koordinattan ilçe bulma ücretsiz mi?** Evet, /v1/konumlar/sinir/bul her pakette açıktır. GeoJSON sınır ucu Başlangıç ve üstü paketlerdedir (2 birim). **Ne kadar hassas?** İlçe sınırları yaklaşık 1 km sadeleştirilmiş OpenStreetMap poligonlarıdır; sınırın hemen yanındaki noktalarda küçük sapma olabilir. ## Havalimanı API Sayfa: https://veriapi.pro/api/havalimani-api Havalimanını kodundan bulun, bir konuma en yakın havalimanlarını ve iki havalimanı arasındaki mesafeyi alın. /v1/ulasim/havalimanlari ad, şehir, IATA ya da ICAO ile arar; ülke, il, tür (büyük / orta / küçük) ve yalnızca tarifeli seferi olanlar süzülebilir. Türkiye'deki havalimanlarında il ve ilçe de vardır. /havalimanlari/{kod} tek havalimanını getirir. /v1/ulasim/havalimanlari/yakin bir koordinata ya da il / ilçeye en yakın havalimanlarını uzaklığıyla, /mesafe iki havalimanı arasındaki kuş uçuşu mesafeyi (km, mil, deniz mili), yönü ve kabaca uçuş süresini verir. /v1/konumlar/mesafe koordinat, il / ilçe ve havalimanı kodlarını karıştırarak kuş uçuşu mesafe hesaplar. Veri OurAirports'tan (kamu malı). Canlı uçuş ve sefer bilgisi yoktur. ### Uçlar - `GET /v1/ulasim/havalimanlari` — Havalimanları: IATA / ICAO, il / ilçe (tüm paketler, 1 birim); parametreler: `ara`, `ulke`, `il`, `tur`, `tarifeli`, `limit` - `GET /v1/ulasim/havalimanlari/yakin` — Koordinata ya da konuma en yakın havalimanları (tüm paketler, 1 birim); parametreler: `enlem`, `boylam`, `konum`, `il`, `ilce`, `tarifeli`, `limit`, `yaricap` - `GET /v1/ulasim/havalimanlari/mesafe` — İki havalimanı arası kuş uçuşu mesafe, yön ve yaklaşık uçuş süresi (tüm paketler, 1 birim); parametreler: `nereden`*, `nereye`* - `GET /v1/konumlar/mesafe` — İki nokta arası kuş uçuşu mesafe ve yön (koordinat, il/ilçe slug'ı ya da havalimanı kodu) (tüm paketler, 1 birim); parametreler: `nereden`*, `nereye`* Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/ulasim/havalimanlari?ulke=TR&tarifeli=true&limit=5"` ### Kullanım örnekleri - Seyahat sitelerinde havalimanı seçimi - Otel ve etkinlik sayfalarında en yakın havalimanı - Uçuş mesafesine göre karbon / süre tahmini ### Sık sorulan sorular **Havalimanı API ücretsiz mi?** Evet; havalimanı arama, en yakın havalimanı ve mesafe uçları her pakette açıktır. **Canlı uçuş bilgisi var mı?** Hayır; yalnızca havalimanı bilgileri ve hesaplanan mesafeler vardır. # Doğrulama ve araçlar ## IBAN Doğrulama API Sayfa: https://veriapi.pro/api/iban-dogrulama-api IBAN'ın geçerliliğini MOD-97 ile denetleyin, Türkiye IBAN'larında bankayı öğrenin. /v1/iban/dogrula boşluklu ya da boşluksuz IBAN'ı denetler: ülke uzunluğu ve MOD-97 kontrol basamakları. Türkiye IBAN'larında banka kodundan banka adını da döndürür; ödeme formlarında yanlış yazılmış IBAN'ı göndermeden yakalarsınız. /v1/bankalar TCMB ödeme sistemleri katılımcısı 70 kurumu 5 haneli banka kodlarıyla listeler. IBAN doğrulaması hesabın var olduğunu göstermez, yalnızca biçimin doğru olduğunu gösterir. ### Uçlar - `GET /v1/iban/dogrula` — IBAN doğrulama ve banka adı (tüm paketler, 1 birim); parametreler: `iban`* - `GET /v1/bankalar` — Türkiye'deki bankalar ve 5 haneli banka (EFT) kodları (tüm paketler, 1 birim); parametreler: `tur` - `GET /v1/bankalar/{kod}` — Banka kodu → banka (tüm paketler, 1 birim); parametreler: `kod`* Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/iban/dogrula?iban=TR330006100519786457841326"` ### Kullanım örnekleri - Ödeme ve iade formlarında IBAN kontrolü - Muhasebe yazılımında banka adı doldurma - Bordro aktarımında ön denetim ### Sık sorulan sorular **Hesap sahibini gösteriyor mu?** Hayır. Yalnızca biçim ve kontrol basamağı denetlenir; hesap sahibi bilgisi yoktur. **Ücretsiz mi?** Evet, IBAN ve banka uçları temel veriler arasındadır. ## QR Kod API Sayfa: https://veriapi.pro/api/qr-kod-api QR kodu tek istekle üretin ya da bir fotoğraftaki QR'ı okuyup içeriğini alan alan çözümleyin. POST /v1/araclar/qr içerik türünü ve alanlarını alır, QR'a yazılacak metni standart biçimde kendisi kurar: Wi-Fi (WIFI:T:WPA;S:…), vCard 3.0 kartvizit, e-posta, telefon, SMS, harita konumu, WhatsApp sohbeti, IBAN bilgisi, SEPA ödeme (EPC / GiroCode) ve takvim etkinliği. Uzun metinler ve Wi-Fi şifreleri adreste taşınmasın diye gövde JSON'dur; yalnızca bir adres ya da metin için GET /v1/araclar/qr?icerik= doğrudan görsel döndürür. Çıktı PNG, SVG, WebP ya da JPG; boyut 64–2048 px, hata düzeltme L/M/Q/H, ön plan ve zemin rengi (şeffaf zemin dahil), kenar boşluğu ve ortaya logo. Logo eklenince hata düzeltme H'ye çıkar; her üretilen QR sunucuda yeniden okunur ve yanıttaki okunabilir alanı karekodun gerçekten çözülebildiğini söyler. POST /v1/araclar/qr/oku bir fotoğraftaki tüm QR kodları ve barkodları okur; QR içeriği türüne göre çözümlenir (Wi-Fi ağı ve şifresi, kartvizit alanları, adresin alan adı ve HTTPS olup olmadığı…). Toplu üretim (100'e kadar, ZIP + liste.csv) ücretli paketlerdedir. ### Uçlar - `GET /v1/araclar/qr` — Metin / adresten QR kod (doğrudan görsel; için) (tüm paketler, 1 birim); parametreler: `icerik`*, `bicim`, `boyut`, `hata_duzeltme`, `renk`, `zemin`, `kenar`, `cikti` - `GET /v1/araclar/qr/turler` — QR kod türleri (Wi-Fi, vCard, WhatsApp, IBAN…) — üretim POST /v1/araclar/qr (tüm paketler, 1 birim) Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/araclar/qr?icerik=https://veriapi.pro&cikti=json&boyut=256"` ### Kullanım örnekleri - Restoran / kafe masalarına Wi-Fi QR'ı - Kartvizit ve broşürlere vCard QR'ı - Faturaya IBAN ya da ödeme QR'ı - Kullanıcının yüklediği görseldeki QR'ı okumak ### Sık sorulan sorular **QR kod API ücretsiz mi?** Evet; ücretsiz pakette PNG ve SVG, en çok 1024 px, siyah-beyaz ve logosuz QR üretilir. Renk, logo, WebP/JPG, 2048 px ve toplu üretim ücretli paketlerdedir. **QR okuma nasıl çalışır?** Görseli multipart (dosya alanı), JSON (gorsel: base64) ya da doğrudan image/* gövde olarak gönderirsiniz; istek 3 birimdir. Gövde en çok 5 MB olabilir; telefon fotoğrafları doğrudan gönderilebilir. Görsel saklanmaz. **Hangi QR türleri var?** url, metin, wifi, vcard, eposta, telefon, sms, konum, whatsapp, iban, sepa ve etkinlik; alanlar /v1/araclar/qr/turler ucunda listelenir. ## Barkod API Sayfa: https://veriapi.pro/api/barkod-api Barkod numarasını doğrulayın, kontrol hanesini hesaplayın, ürünü bulun; barkod görseli üretin ya da fotoğraftan okuyun. /v1/barkod/dogrula numaranın türünü (EAN-13, EAN-8, UPC-A, UPC-E, GTIN-14, ISBN-10/13, ISSN, ISMN), kontrol hanesinin doğruluğunu ve beklenen değerini, GTIN-14 karşılığını ve GS1 önekini (ör. 868–869 GS1 Türkiye) verir. GS1 öneki numarayı tahsis eden kuruluşu gösterir, ürünün üretildiği ülkeyi değil; 2 ile başlayan mağaza içi numaralar ayrıca işaretlenir. /v1/barkod/sorgula ürün adını, markayı, miktarı, kategorileri, görseli, içindekileri, alerjenleri ve 100 g başına besin değerlerini Open Food Facts, Open Beauty Facts ve Open Products Facts açık veritabanlarından getirir. Her barkod bulunmaz: bulunamayan ürün bulundu: false döner. Sonuçlar önbelleğe alınır. /v1/barkod/olustur EAN-13, EAN-8, UPC-A/E, ITF-14, Code 128/39/93, Codabar, Data Matrix, PDF417 ve Aztec görseli üretir (SVG, PNG, WebP; eksik kontrol hanesi eklenir). /v1/barkod/oku fotoğraftaki barkodları okur. ### Uçlar - `GET /v1/barkod/dogrula` — Barkod doğrulama: tür, kontrol hanesi, GS1 öneki, ISBN (tüm paketler, 1 birim); parametreler: `kod`* - `GET /v1/barkod/sorgula` — Barkoddan ürün adı, marka, görsel, besin değerleri (tüm paketler, 5 birim); parametreler: `kod`* - `GET /v1/barkod/olustur` — Barkod görseli üret (EAN-13, EAN-8, UPC, ITF-14, Code 128/39/93, Data Matrix, PDF417, Aztec) (tüm paketler, 1 birim); parametreler: `kod`*, `tur`, `bicim`, `olcek`, `yazi`, `cikti` - `GET /v1/barkod/kontrol-hanesi` — Kontrol hanesini hesapla (7 → EAN-8, 11 → UPC-A, 12 → EAN-13, 13 → GTIN-14) (tüm paketler, 1 birim); parametreler: `kod`* Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/barkod/dogrula?kod=8690504020004"` ### Kullanım örnekleri - Stok ve e-ticaret formlarında barkod doğrulama - Barkoddan ürün adı ve görselini otomatik doldurmak - Etiket basmak için EAN-13 / Code 128 görseli - Mobil uygulamada fotoğraftan barkod okumak ### Sık sorulan sorular **Barkoddan ürün bulma ücretsiz mi?** Evet; /v1/barkod/sorgula her pakette açıktır, istek 5 birimdir. Ürün adına göre arama ve toplu doğrulama ücretli paketlerdedir. **Her barkodun ürünü bulunur mu?** Hayır. Veri gönüllülerin oluşturduğu açık veritabanlarından gelir; özellikle gıda dışı ürünlerde kapsam sınırlıdır. Bulunamayınca bulundu: false döner. **869 ile başlayan barkod Türk malı mı demek?** Hayır; 868–869 öneki numaranın GS1 Türkiye tarafından tahsis edildiğini gösterir. Ürün başka ülkede üretilmiş olabilir. ## Telefon Numarası API Sayfa: https://veriapi.pro/api/telefon-numarasi-api Kullanıcının girdiği numarayı doğrulayın, standart biçime çevirin, türünü ve ülkesini öğrenin. /v1/telefon/bilgi numarayı 0532…, +90…, 00 49… gibi her biçimde alır; geçerli ve olası olup olmadığını, E.164 (+905321234567), uluslararası ve ulusal biçimi, ülkeyi, numara türünü (cep, sabit hat, 0800, 0850, 444, VoIP), Türkiye sabit hatlarında ili, maskelenmiş hâlini ve tel / sms / WhatsApp bağlantılarını döndürür. ilk_operator alanı numara aralığının ilk tahsis edildiği operatördür. Numara taşıma nedeniyle güncel operatör numaradan bilinemez; bu yüzden guncel_operator her zaman null döner. Numara aralıkları Google libphonenumber verisidir. /v1/telefon/toplu-dogrula 1000'e kadar numarayı tek istekte doğrular, biçimlendirir ve tekrarlananları sayar (ücretli paket). /v1/telefon/ulke-kodlari ülke telefon kodlarını, /v1/telefon/ulke/{kod} ülkenin numara biçimini verir. ### Uçlar - `GET /v1/telefon/bilgi` — Telefon numarası: geçerlilik, biçimler, cep / sabit, ilk operatör (tüm paketler, 1 birim); parametreler: `numara`*, `ulke` - `GET /v1/telefon/dogrula` — Numara geçerli mi? (kısa yanıt) (tüm paketler, 1 birim); parametreler: `numara`*, `ulke` - `GET /v1/telefon/formatla` — Numarayı E.164, uluslararası, ulusal ve RFC 3966 biçimine çevir (tüm paketler, 1 birim); parametreler: `numara`*, `ulke` - `GET /v1/telefon/ulke-kodlari` — Ülke telefon kodları (+90, +49…) ve örnek cep numarası (tüm paketler, 1 birim); parametreler: `ara` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/telefon/bilgi?numara=05321234567"` ### Kullanım örnekleri - Kayıt ve sipariş formlarında numara doğrulama - CRM'de numaraları E.164'e çevirmek - SMS göndermeden önce cep numarası ayıklamak - Ekranda numarayı maskeleyerek göstermek ### Sık sorulan sorular **Telefon numarası API ücretsiz mi?** Evet; bilgi, doğrulama, biçimlendirme, maskeleme ve ülke kodları her pakette açıktır. Toplu doğrulama ücretli paketlerdedir. **Numaranın şu anki operatörünü verir mi?** Hayır. Yalnızca aralığın ilk tahsis edildiği operatör verilir; numarası taşınmış abonede bu bilgi güncel değildir. **Numaranın kime ait olduğunu söyler mi?** Hayır; kişisel bilgi döndürülmez ve numaralar saklanmaz. ## VKN / TCKN ve VIN Doğrulama API Sayfa: https://veriapi.pro/api/vkn-tckn-dogrulama-api Formlardaki VKN, TCKN ve şasi numarasını kaydetmeden önce doğrulayın. /v1/dogrula/vkn 10 haneli vergi kimlik numarasını, /v1/dogrula/tckn 11 haneli T.C. kimlik ve yabancı kimlik numarasını resmî kontrol hanesi algoritmasıyla denetler; /v1/dogrula/vergi-no uzunluğa göre ikisinden birini seçer. Algoritmaya uyan numaranın gerçekten birine verildiği ya da mükellefin faal olduğu bu yolla bilinemez; numaralar saklanmaz. /v1/arac/vin 17 karakterlik şasi numarasını parçalarına ayırır (WMI, VDS, VIS), kontrol hanesini ve model yılı adaylarını hesaplar, üretici, marka, fabrika ülkesi ve şehri, araç tipi ve varsa model ile motor bilgisini NHTSA vPIC'ten getirir. ABD dışı modellerde çoğu zaman yalnızca üretici ve fabrika bulunur. ### Uçlar - `GET /v1/dogrula/vkn` — Vergi kimlik numarası algoritma doğrulaması (tüm paketler, 1 birim); parametreler: `vkn`* - `GET /v1/dogrula/tckn` — T.C. kimlik / yabancı kimlik numarası (11 hane) algoritma doğrulaması (tüm paketler, 1 birim); parametreler: `tckn`* - `GET /v1/dogrula/vergi-no` — VKN (10) ya da TCKN (11, şahıs mükellefi) — uzunluğa göre doğrular (tüm paketler, 1 birim); parametreler: `no`* - `GET /v1/arac/vin` — Şasi numarası (VIN): üretici, model yılı, fabrika (tüm paketler, 3 birim); parametreler: `vin`*, `ayrinti` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/dogrula/vkn?vkn=1234567890"` ### Kullanım örnekleri - Fatura ve cari kart formlarında VKN denetimi - Üyelik formunda TCKN biçim kontrolü - Galeri ve ekspertiz uygulamalarında şasi numarasından üretici ve model yılı ### Sık sorulan sorular **VKN doğrulama ücretsiz mi?** Evet; tekil VKN, TCKN ve VIN doğrulaması her pakette açıktır. Toplu VKN / TCKN doğrulama (1000'e kadar) ücretli paketlerdedir. **Kimlik numarasının kime ait olduğu görülür mü?** Hayır; yalnızca algoritma denetlenir, kişisel veri sorgulanmaz ve numaralar saklanmaz. **VIN ile hasar ya da kilometre bilgisi gelir mi?** Hayır; yalnızca üreticinin bildirdiği araç bilgileri gelir. ## Sayıyı Yazıya Çevirme API Sayfa: https://veriapi.pro/api/sayiyi-yaziya-cevirme-api Tutarı TDK yazımıyla yazıya çevirir; fatura, çek, senet ve makbuz için hazır biçimlerle. /v1/cevir/yaziyla tutarı dört biçimde döndürür: düz metin (bin iki yüz elli Türk lirası elli kuruş), büyük harf, bitişik (BinİkiYüzElliTürkLirasıElliKuruş) ve fatura satırı (YALNIZ: BİN İKİ YÜZ ELLİ TÜRK LİRASI ELLİ KURUŞ). Kuruş iki haneye yuvarlanır; 1.250,50, 1250.50 ve 1,250.50 yazımlarının hepsi kabul edilir. Para birimi boş bırakılırsa sayı okunur (12,05 → on iki virgül sıfır beş) ve tam sayılarda sıra sayısı da verilir (2026 → iki bin yirmi altıncı). Türk lirası, ABD doları, avro, sterlin ve İsviçre frangı desteklenir. ### Uçlar - `GET /v1/cevir/yaziyla` — Sayıyı yazıya çevir: fatura satırı (YALNIZ), bitişik, sıra sayısı (tüm paketler, 1 birim); parametreler: `tutar`*, `para` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/cevir/yaziyla?tutar=1250,50¶=TRY"` ### Kullanım örnekleri - E-fatura ve e-arşiv faturada yazıyla tutar - Çek, senet ve makbuz yazdırma - Muhasebe ve ön muhasebe programları ### Sık sorulan sorular **Sayıyı yazıya çevirme API'si ücretsiz mi?** Evet; her pakette açıktır, istek başına 1 birim. **Fatura biçimi nedir?** Faturada, çekte ve senette yaygın kullanılan "YALNIZ: …" kalıbıdır; mevzuatta tek bir zorunlu kalıp yoktur. Kendi biçiminiz için metin ya da bitisik alanını kullanabilirsiniz. **En büyük tutar ne?** 999 katrilyona kadar; kuruş yarım yukarı yuvarlanır (100,999 → yüz bir Türk lirası). ## Türkçe Metin API Sayfa: https://veriapi.pro/api/turkce-metin-api Programlama dillerinin Türkçede yanlış yaptığı işler: i–İ, ı–I dönüşümü ve ç, ğ, ö, ş, ü'nün doğru sırası. /v1/araclar/metin bir metni tek istekte büyük harf (istanbul → İSTANBUL), küçük harf (IŞIK → ışık), başlık biçimi (düzce'de → Düzce'de), cümle düzeni, ASCII (Çağrı → Cagri) ve slug (duzcede-ilik-hava) olarak döndürür; karakter, harf ve kelime sayısını da verir. Uzun metinler POST ile gönderilir. POST /v1/araclar/metin/sirala listeyi Türk alfabesine göre sıralar: c'den sonra ç, g'den sonra ğ, h'den sonra ı, o'dan sonra ö. İsteğe bağlı olarak tekrarları atar (büyük / küçük harf duyarsız). ### Uçlar - `GET /v1/araclar/metin` — Türkçe metin: İ/ı doğru büyük-küçük harf, başlık, ASCII, slug, sayım (tüm paketler, 1 birim); parametreler: `metin`* Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/araclar/metin?metin=düzce'de ılık hava"` ### Kullanım örnekleri - SEO uyumlu adres (slug) üretimi - Ad / soyad alanlarını doğru büyük harfe çevirme - İl, ilçe ve ürün listelerini Türkçe sıralama ### Sık sorulan sorular **Türkçe metin API'si ücretsiz mi?** Evet; her pakette açıktır, istek başına 1 birim. **Neden kendi kodumla yapamıyorum?** Yapabilirsiniz; ancak çoğu dilin varsayılan upper()/lower() işlevi i → I ve I → i dönüştürür, sıralama da ç, ğ, ş'yi alfabenin sonuna atar. Bu uç Türkçe kurallarını uygular. ## Zararlı Bağlantı Kontrol API Sayfa: https://veriapi.pro/api/zararli-baglanti-kontrol-api USOM zararlı bağlantı listesinde tek istekle sorgu: oltalama, sahte banka siteleri, zararlı yazılım. /v1/guvenlik/zararli-kontrol?adres= bir alan adını, URL'yi ya da IP adresini yaklaşık 500 bin kayıtlık USOM listesinde arar. Alan adının kendisi ya da üst alan adı listedeyse (giris.ornek-banka.shop ← ornek-banka.shop), URL listedeki bir bağlantıyla başlıyorsa ya da IP birebir eşleşiyorsa zararli: true döner; eşleşen kaydın kategorisi (oltalama, bankacılık oltalaması, zararlı yazılım), kritiklik seviyesi ve eklenme tarihiyle. Aynı alan adı altındaki diğer zararlı bağlantılar ilgili alanında bilgi olarak verilir. /v1/guvenlik/zararli/son listeye son eklenen adresleri türe, kategoriye ve güne göre süzer; /v1/guvenlik/bildirimler Siber Güvenlik Başkanlığı'nın TR-26-xxxx güvenlik bildirimlerini özet, etiket ve CVE numaralarıyla döndürür. Liste 30 dakikada bir, tekil sorgular kaynaktan anlık (bir saat önbellekli) gelir. ### Uçlar - `GET /v1/guvenlik/zararli-kontrol` — Alan adı / URL / IP USOM zararlı bağlantı listesinde mi? (tüm paketler, 2 birim); parametreler: `adres`* - `GET /v1/guvenlik/zararli/son` — Son eklenen zararlı adresler: oltalama, zararlı yazılım, komuta kontrol (tüm paketler, 1 birim); parametreler: `tur`, `kategori`, `gun`, `limit` - `GET /v1/guvenlik/bildirimler` — Siber Güvenlik Başkanlığı güvenlik bildirimleri ve CVE'ler (tüm paketler, 1 birim); parametreler: `etiket`, `limit` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/guvenlik/zararli/son?tur=alan_adi&kategori=BP&limit=5"` ### Kullanım örnekleri - Yorum, forum ve mesaj formlarında paylaşılan bağlantıyı yayımlamadan önce denetleme - Haber sitesinde "bu siteye girmeyin" dolandırıcılık haberleri ve son eklenen sahte siteler kutusu - Kurum içi URL filtresi, e-posta güvenlik ağ geçidi ve SIEM entegrasyonu - Yazılım ekipleri için kullandıkları ürünlere ait güvenlik bildirimi takibi ### Sık sorulan sorular **Zararlı bağlantı API'si ücretsiz mi?** Evet; üç uç da her pakette açıktır. Tekil kontrol istek başına 2 birim, liste ve bildirimler 1 birimdir. **Listede yoksa site güvenli mi?** Hayır. Liste yalnızca Siber Güvenlik Başkanlığı'nın tespit ettiği ya da ihbarla doğruladığı adresleri içerir; yeni açılan sahte siteler henüz listede olmayabilir. **Türkçe karakterli alan adları?** Desteklenir: ödeme-türkiye.shop gibi adresler otomatik olarak punycode'a (xn--…) çevrilip aranır. **Yanıtta kaynak göstermem gerekir mi?** Evet; veri T.C. Siber Güvenlik Başkanlığı'na (USOM) aittir, kaynak alanındaki atıf metni gösterildiği yerde yazılmalıdır. # Vergi, maaş ve mevzuat ## Asgari Ücret ve Vergi API Sayfa: https://veriapi.pro/api/asgari-ucret-vergi-api Asgari ücret, gelir vergisi dilimleri, KDV oranları ve işveren maliyeti; her değer Resmî Gazete kaynağıyla. /v1/mevzuat/asgari-ucret yılın brüt, net ve günlük asgari ücretini; /v1/mevzuat/gelir-vergisi ücret ve ücret dışı gelirler için vergi dilimlerini verir, matrah gönderirseniz vergiyi hesaplar. /v1/mevzuat/isveren-maliyeti brüt ücretin işverene toplam maliyetini (SGK %21,75 + işsizlik %2, teşvikli ve teşviksiz) hesaplar. KDV oranları ve VUK yeniden değerleme oranı da ayrı uçlarda. Değerler yeni yıl Resmî Gazete'de yayımlanınca güncellenir. ### Uçlar - `GET /v1/mevzuat/asgari-ucret` — Asgari ücret: brüt, net, günlük (tüm paketler, 1 birim); parametreler: `yil` - `GET /v1/mevzuat/gelir-vergisi` — Gelir vergisi tarifesi ve matrahtan vergi hesabı (tüm paketler, 1 birim); parametreler: `yil`, `tur`, `matrah` - `GET /v1/mevzuat/kdv` — KDV oranları (tüm paketler, 1 birim) - `GET /v1/mevzuat/isveren-maliyeti` — Brüt ücretin işveren maliyeti (teşvikli / teşviksiz) (ücretli paket, 1 birim); parametreler: `yil`, `brut`, `tesvik` - `GET /v1/mevzuat/yeniden-degerleme` — Yeniden değerleme oranı (tüm paketler, 1 birim); parametreler: `yil` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/mevzuat/gelir-vergisi?matrah=750000"` ### Kullanım örnekleri - Bordro ve İK yazılımları - Maaş hesaplama araçları - Muhasebe ve e-fatura uygulamaları ### Sık sorulan sorular **Yeni yıl değerleri ne zaman eklenir?** Resmî Gazete'de yayımlandığı gün ya da ertesi gün; yanıtta yürürlük yılı yer alır. **İşveren maliyeti ücretsiz mi?** Asgari ücret, gelir vergisi ve KDV ücretsizdir; işveren maliyeti hesabı Başlangıç ve üstü paketlerdedir. ## Vergi Hesaplama API Sayfa: https://veriapi.pro/api/vergi-hesaplama-api KDV, tevkifat, stopaj, damga vergisi ve maaş hesabı; her yanıtta o tarihte yürürlükteki kural ve dayanağı. Vergi kuralları sürümlüdür: her oran ve tutar yürürlük başlangıcı, bitişi ve Resmî Gazete dayanağıyla tutulur. Hesap uçlarına tarih gönderirseniz o gün geçerli kuralla hesaplanır (ör. 2025'te değişen beyanname damga vergisi tutarları); yanıttaki surum alanı hangi kuralın kullanıldığını gösterir. /v1/vergi/kurallar tüm sürümleri listeler. /v1/vergi/kdv KDV hariç ve dahil tutarlar arasında çevirir, tevkifat kodu verilirse kısmi tevkifatı (4/10, 9/10…) fatura sınırıyla birlikte uygular. /v1/vergi/stopaj GVK 94 kesintisini brütten nete ya da netten brüte hesaplar. /v1/vergi/damga nispi kağıtta azami tutarı, maktu kağıtta güncel tutarı verir. /v1/vergi/maas sabit brütle 12 aylık bordroyu (SGK tavanı, kümülatif vergi dilimi, asgari ücret istisnası, engellilik indirimi) çıkarır. ### Uçlar - `GET /v1/vergi/kurallar` — Sürümlü vergi kuralları (yürürlük tarihi ve dayanağıyla) (tüm paketler, 1 birim) - `GET /v1/vergi/kdv` — KDV hesabı (dahil ↔ hariç) ve kısmi tevkifat (ücretli paket, 1 birim); parametreler: `tutar`*, `oran`, `dahil`, `tevkifat`, `tarih` - `GET /v1/vergi/kdv/oranlar` — Tarihte geçerli KDV oranları (tüm paketler, 1 birim); parametreler: `tarih` - `GET /v1/vergi/kdv/tevkifat` — KDV kısmi tevkifat kalemleri ve sınır (tüm paketler, 1 birim); parametreler: `tarih` - `GET /v1/vergi/stopaj` — Stopaj (GVK 94): brütten nete, netten brüte (ücretli paket, 1 birim); parametreler: `tutar`*, `tur`*, `net`, `tarih` - `GET /v1/vergi/stopaj/oranlar` — Stopaj oranları (tüm paketler, 1 birim); parametreler: `tarih` - `GET /v1/vergi/damga` — Damga vergisi (nispi, azami tutar, maktu) (ücretli paket, 1 birim); parametreler: `tur`*, `tutar`, `nusha`, `tarih` - `GET /v1/vergi/damga/oranlar` — Damga vergisi oranları ve maktu tutarlar (tüm paketler, 1 birim); parametreler: `tarih` - `GET /v1/vergi/gelir` — Gelir vergisi tarifesi; matrah verilirse vergi (tüm paketler, 1 birim); parametreler: `matrah`, `tur`, `yil` - `GET /v1/vergi/mtv` — Motorlu Taşıtlar Vergisi (/v1/hesapla/mtv ile aynı hesap) (ücretli paket, 1 birim); parametreler: `silindir`, `yas`*, `deger`, `tescil`, `tur`, `guc`, `yil` - `GET /v1/vergi/maas` — Brütten nete maaş (12 ay bordro) / netten brüte (ücretli paket, 2 birim); parametreler: `brut`, `net`, `ay`, `yil`, `engelli` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/vergi/kdv?tutar=100000&oran=20&tevkifat=yapim"` ### Kullanım örnekleri - Ön muhasebe ve e-fatura yazılımları - Bordro ve İK uygulamaları - Haber sitelerinde hesaplama araçları - Serbest meslek ve kira makbuzu hesapları ### Sık sorulan sorular **Mevzuat değişince ne olur?** Yeni oran yeni bir sürüm olarak eklenir; eski sürüm silinmez, geçmiş tarihli hesaplar eski kuralla yapılmaya devam eder. **Hangi uçlar ücretsiz?** Kural ve oran listeleri ile gelir vergisi tarifesi tüm paketlerde; KDV, stopaj, damga, MTV ve maaş hesaplayıcıları Başlangıç ve üstü paketlerde. **Hesaplar resmî mi?** Hayır, bilgilendirme amaçlıdır; özel durumlar (istisnalar, teşvikler, önceki işveren matrahı) için mali müşavirinize danışın. ## Hesaplama API'leri Sayfa: https://veriapi.pro/api/hesaplama-api Kredi, mevduat, MTV, tazminat ve emeklilik hesaplarını kendi formülünüzü yazmadan, güncel oranlarla yapın. /v1/hesapla/kredi tutar, vade ve aylık faizden taksiti, toplam faizi, KKDF ve BSMV'yi kredi türüne göre (ihtiyaç, konut, taşıt, ticari) hesaplar ve ödeme planını döndürür. /v1/hesapla/mevduat brüt getiri, stopaj ve net kazancı verir. /v1/hesapla/mtv motorlu taşıtlar vergisini (elektrikli araç indirimi dahil), /v1/hesapla/kidem ve /v1/hesapla/ihbar tazminatları güncel tavan ve vergilerle, /v1/hesapla/issizlik ödenek tutarını ve süresini, /v1/hesapla/emekli zam sonrası aylığı hesaplar. Oranlar mevzuat değiştikçe güncellenir; sizin kodunuz aynı kalır. ### Uçlar - `GET /v1/hesapla/kredi` — Kredi ödeme planı: taksit, faiz, KKDF, BSMV (ücretli paket, 1 birim); parametreler: `tutar`*, `vade`*, `faiz`*, `tur`, `kkdf`, `bsmv`, `plan` - `GET /v1/hesapla/mevduat` — Mevduat getirisi: brüt, stopaj, net (ücretli paket, 1 birim); parametreler: `tutar`*, `faiz`*, `gun`, `para`, `stopaj` - `GET /v1/hesapla/mtv` — Motorlu Taşıtlar Vergisi (otomobil, elektrikli, motosiklet, panelvan) (ücretli paket, 1 birim); parametreler: `silindir`, `yas`*, `deger`, `tescil`, `tur`, `guc`, `yil` - `GET /v1/hesapla/kidem` — Kıdem tazminatı (tavan, damga, net) (ücretli paket, 1 birim); parametreler: `brut`*, `giris`*, `cikis`*, `ek_odeme` - `GET /v1/hesapla/ihbar` — İhbar tazminatı (süre, gelir vergisi, net) (ücretli paket, 1 birim); parametreler: `brut`*, `giris`*, `cikis`*, `ek_odeme`, `kumulatif_matrah` - `GET /v1/hesapla/issizlik` — İşsizlik ödeneği: aylık tutar ve süre (ücretli paket, 1 birim); parametreler: `brut_ortalama`*, `prim_gunu`*, `yil` - `GET /v1/hesapla/emekli` — Emekli aylığı zammı (SSK/Bağ-Kur, memur) (ücretli paket, 1 birim); parametreler: `aylik`*, `tur`, `donem` - `GET /v1/hesapla/yakit` — Yolculuk yakıt maliyeti (ilin güncel fiyatıyla) (ücretli paket, 1 birim); parametreler: `mesafe`*, `tuketim`*, `fiyat`, `il`, `yakit`, `kisi`, `gidis_donus` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/hesapla/kredi?tutar=100000&vade=12&faiz=3.5"` ### Kullanım örnekleri - Finans ve emlak sitelerinde hesaplama araçları - Haber sitelerinde "ne kadar ödeyeceğim" içerikleri - Avukat ve İK uygulamalarında tazminat hesabı ### Sık sorulan sorular **Hesaplayıcılar ücretsiz mi?** Hayır; /v1/hesapla/* uçları Başlangıç ve üstü paketlerdedir. **Oranlar güncel mi?** KKDF/BSMV, stopaj, MTV tarifesi, kıdem tavanı ve emekli zammı mevzuat değiştikçe güncellenir; yanıtta kullanılan oranlar da döner. ## Resmî Gazete API Sayfa: https://veriapi.pro/api/resmi-gazete-api Resmî Gazete'nin her sayısı, maddeleri türüne göre sınıflandırılmış ve aranabilir hâlde JSON olarak. /v1/resmigazete/son ve /bugun günün gazetesini mükerrerleriyle birlikte verir: her maddenin türü (kanun, Cumhurbaşkanlığı kararnamesi, Cumhurbaşkanı kararı, yönetmelik, tebliğ, genelge, kurul / ilke kararı, yargı kararı…), kanun ve karar numarası, HTML maddelerde düzenleyen kurum, başlık ve resmigazete.gov.tr bağlantısı. Arşiv 2005'ten bugüne fihristten kurulur; /tarih/{tarih}, /sayi/{sayi}, /liste?tur=&kurum= ve /kanunlar, /yonetmelikler, /tebligler gibi kısa yollar türe göre listeler. /ara başlıkta ya da (HTML yayımlanan maddelerde) tam metinde arar; "tam ifade" ve -hariç desteklenir. /madde/{id} maddenin düz metnini verir. /v1/resmigazete/yeni?son_id= düzenli yoklama içindir: önceki yanıttaki son_id ile yalnızca yeni yayımlanan maddeler gelir; tür ve kurum süzgeciyle yalnızca ilgilendiğiniz düzenlemeleri takip edersiniz. Hukuki işlemlerde Resmî Gazete'nin kendisi esastır. ### Uçlar - `GET /v1/resmigazete/son` — Son Resmî Gazete: tüm maddeler türüne göre (kanun, yönetmelik, tebliğ…) (tüm paketler, 1 birim); parametreler: `ilanlar` - `GET /v1/resmigazete/bugun` — Bugünkü Resmî Gazete (tüm paketler, 1 birim); parametreler: `ilanlar` - `GET /v1/resmigazete/ara` — Resmî Gazete'de başlık / tam metin arama (ücretli paket, 2 birim); parametreler: `q`*, `kapsam`, `tur`, `kurum`, `baslangic`, `bitis`, `sirala`, `sayfa`, `adet` - `GET /v1/resmigazete/liste` — Türe / kuruma / tarih aralığına göre maddeler (yeniden eskiye) (ücretli paket, 1 birim); parametreler: `tur`, `kurum`, `baslangic`, `bitis`, `sayfa`, `adet` - `GET /v1/resmigazete/yeni` — Takip: son_id'den sonra arşive giren yeni maddeler (son 10 gün; düzenli yoklama için) (ücretli paket, 1 birim); parametreler: `son_id`, `tur`, `kurum`, `adet` - `GET /v1/resmigazete/turler` — Madde türleri, sayıları ve arşiv kapsamı (tüm paketler, 1 birim) Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/resmigazete/son"` ### Kullanım örnekleri - Muhasebe ve İK yazılımlarında yeni vergi ve SGK düzenlemelerini yakalamak - Hukuk sitelerinde günün mevzuatı - Haber sitelerinde Resmî Gazete özeti - Sektöre göre yönetmelik / tebliğ takibi ### Sık sorulan sorular **Resmî Gazete API ücretsiz mi?** Son gazete, bugünkü gazete ve tür listesi her pakette açıktır. Tarih / sayı arşivi, listeler, arama, madde metni ve yeni madde takibi ücretli paketlerdedir. **Tam metin aramada her madde var mı?** Tam metin yalnızca HTML yayımlanan maddelerde ve metni arşive alınmış dönemde aranır; PDF yayımlanan maddelerde (ör. ilke kararları) başlık ve bağlantı vardır. **Yeni gazete ne zaman gelir?** Resmî Gazete gece yarısından sonra yayımlanır; arşiv 15 dakikada bir yenilenir, gün içinde eklenen mükerrer sayılar da yakalanır. ## Maaş Hesaplama API (döviz ve enflasyon) Sayfa: https://veriapi.pro/api/maas-doviz-hesaplama-api Maaşın döviz ve enflasyon karşısındaki değişimini tek istekte hesaplayın. /v1/hesapla/maas-doviz maaşı istediğiniz paralara (anlık Kapalıçarşı satış, ECB referans ya da TCMB döviz satış kuru) çevirir; aylık, yıllık, haftalık, günlük ve saatlik karşılıkları ve asgari ücretin kaç katı olduğunu verir. /v1/hesapla/maas-gecmis geçmiş bir tarihteki maaşın o gün kaç dolar ettiğini, bugün aynı dolar karşılığı ve aynı alım gücü (TÜFE) için kaç TL gerektiğini söyler. /maas-enflasyon maaşı iki ay arasındaki TÜFE ile günceller ve bugünkü maaşla reel değişimi, /maas-zam zam oranını ve enflasyona göre reel zammı, /maas-karsilastir iki tarihteki maaşı nominal, reel, döviz ve asgari ücret katıyla karşılaştırır. Kur geçmişi TCMB döviz satış kurudur (5 yıl), enflasyon TÜFE endeksidir (2005'ten; son açıklanan ay kullanılır). Brütten nete hesap için /v1/vergi/maas. ### Uçlar - `GET /v1/hesapla/maas-doviz` — Maaşın dolar / euro / sterlin karşılığı (aylık, yıllık, saatlik) (ücretli paket, 1 birim); parametreler: `maas`*, `para`, `hedef`, `donem`, `kur` - `GET /v1/hesapla/maas-gecmis` — Geçmiş maaş: o gün kaç dolardı, bugün aynı alım gücü için kaç TL (ücretli paket, 1 birim); parametreler: `maas`*, `tarih`*, `para`, `hedef` - `GET /v1/hesapla/maas-enflasyon` — Maaşı TÜFE'ye göre güncelle, reel değişim (ücretli paket, 1 birim); parametreler: `maas`*, `baslangic`*, `bitis`, `guncel_maas` - `GET /v1/hesapla/maas-zam` — Zam oranı ve enflasyona göre reel zam (ücretli paket, 1 birim); parametreler: `maas`*, `zam_orani`, `yeni_maas`, `enflasyon` - `GET /v1/hesapla/maas-karsilastir` — İki tarihteki maaşı karşılaştır: nominal, reel (TÜFE), döviz ve asgari ücret katı (ücretli paket, 1 birim); parametreler: `maas1`*, `tarih1`*, `maas2`*, `tarih2`, `doviz` - `GET /v1/hesapla/maas-donem` — Maaşı dönemler arasında çevir (aylık ↔ yıllık ↔ günlük ↔ saatlik) (ücretli paket, 1 birim); parametreler: `maas`*, `donem`, `saat` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/hesapla/maas-doviz?maas=50000&hedef=USD,EUR"` ### Kullanım örnekleri - İK portallarında zam ve reel ücret karşılaştırması - Haber sitelerinde 'maaşınız kaç dolar' aracı - Yurt dışı iş tekliflerini TL ile karşılaştırmak ### Sık sorulan sorular **Maaş hesaplama uçları ücretsiz mi?** Hayır; /v1/hesapla altındaki hesaplayıcılar Başlangıç ve üstü paketlerdedir. **Hangi kur kullanılıyor?** kur=anlik Kapalıçarşı satış kuru (dakikada bir), kur=referans ECB, kur=tcmb TCMB döviz satış kurudur. Geçmiş tarihler için TCMB satış kuru kullanılır. **Enflasyon hangi ay için?** TÜFE aylık açıklandığı için hesap son açıklanan aya kadar yapılır; yanıtta ay belirtilir. ## E-ticaret Komisyon Hesaplama API Sayfa: https://veriapi.pro/api/e-ticaret-komisyon-api Bir pazaryeri satışında elinize ne geçtiğini ve hedef kâr için hangi fiyattan satmanız gerektiğini hesaplayın. /v1/hesapla/eticaret KDV dahil satış fiyatı, komisyon oranı, kargo, hizmet bedeli, diğer giderler ve ürün maliyetiyle; komisyonun KDV'sini, e-ticaret stopajını (GVK 94/A, varsayılan %1), platformun yatıracağı hakedişi, ödenecek ya da devreden KDV'yi, net kârı, kâr marjını, nakit kalanı ve başa baş fiyatı verir. /v1/hesapla/eticaret/fiyat hedef kâr tutarı ya da kâr marjı için gereken satış fiyatını ve ,90 ile biten psikolojik fiyatı hesaplar. Komisyon oranları kategoriye ve pazaryerine göre değiştiği için istekte verilir. /v1/kargo/desi en × boy × yükseklik ÷ 3000 ile desiyi ve firmanın ücretlendireceği ağırlığı (desi ile kilogramdan büyüğü) hesaplar; yurt dışı için 5000 ya da firmanın böleni verilebilir. ### Uçlar - `GET /v1/hesapla/eticaret` — Pazaryeri satışı: komisyon, kargo, stopaj, KDV, hakediş, kâr (ücretli paket, 1 birim); parametreler: `fiyat`*, `komisyon`*, `kdv`, `komisyon_matrahi`, `kargo`, `hizmet_bedeli`, `diger`, `maliyet`, `maliyet_kdv`, `stopaj`, `hizmet_kdv` - `GET /v1/hesapla/eticaret/fiyat` — Hedef kâr ya da kâr marjı için gereken satış fiyatı (komisyon dahil) (ücretli paket, 1 birim); parametreler: `komisyon`*, `maliyet`*, `hedef_kar`, `hedef_marj`, `kdv`, `komisyon_matrahi`, `kargo`, `hizmet_bedeli`, `diger`, `stopaj` - `GET /v1/kargo/desi` — Kargo desisi ve ücretlendirilecek ağırlık (tüm paketler, 1 birim); parametreler: `en`*, `boy`*, `yukseklik`*, `agirlik`, `adet`, `kapsam`, `bolen` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/hesapla/eticaret?fiyat=1200&komisyon=18&kargo=60&maliyet=500"` ### Kullanım örnekleri - Satıcı panellerinde ürün başına kârlılık - Fiyatlandırma araçlarında hedef marja göre fiyat - Kargo maliyeti tahmini ### Sık sorulan sorular **E-ticaret hesaplayıcı ücretsiz mi?** Komisyon ve fiyat hesapları ücretli paketlerdedir; desi hesabı her pakette açıktır. **Pazaryerlerinin komisyon oranları var mı?** Hayır; oranlar kategoriye ve kampanyaya göre sık değiştiği için satıcı panelinizdeki oranı istekte gönderirsiniz. **Stopaj kârdan mı düşülüyor?** Hayır; stopaj gelir / kurumlar vergisinden mahsup edilir. Hakedişten düşer ama kâr hesabında gider sayılmaz. ## Vergi Dairesi API Sayfa: https://veriapi.pro/api/vergi-dairesi-api Fatura ve kayıt formlarındaki vergi dairesi seçimi için GİB'in resmî listesi; il ve ilçeye göre. /v1/vergi/daireler il, ilçe ve ada göre vergi dairelerini döndürür: muhasebe birim kodu, ad, tür (müdürlük, şube, defterdarlık), il ve ilçe. /v1/vergi/daireler/{kod} beş haneli koddan daireyi bulur. Liste GİB'in Defterdarlık ve Vergi Daireleri Listesi'nden derlenmiştir. Büyükşehirlerde merkezdeki daireler birden çok ilçeye hizmet verir. İlçeye göre sorguda önce o ilçenin kendi dairesi, yoksa adında ilçe geçen merkez dairesi, o da yoksa il merkezindeki daireler döner; eslesme alanı hangisi olduğunu söyler. ### Uçlar - `GET /v1/vergi/daireler` — Vergi daireleri ve muhasebe birim kodları (GİB; il / ilçe / ad) (tüm paketler, 1 birim); parametreler: `il`, `ilce`, `ara`, `tur` - `GET /v1/vergi/daireler/{kod}` — Muhasebe birim koduna göre vergi dairesi (tüm paketler, 1 birim); parametreler: `kod`* Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/vergi/daireler?il=duzce"` ### Kullanım örnekleri - E-fatura ve üyelik formlarında vergi dairesi açılır listesi - Muhasebe programlarında cari kartı - VKN doğrulamasıyla birlikte firma bilgisi ### Sık sorulan sorular **Vergi dairesi API'si ücretsiz mi?** Evet; her pakette açıktır, istek başına 1 birim. **Şubelerin kodu neden yok?** GİB listesinde şubelerin muhasebe birim kodu yer almaz; şubeler bağlı oldukları müdürlüğün koduyla işlem görür. **Bir firmanın vergi dairesini bulur mu?** Hayır; mükellef sorgusu GİB'in kendi sistemindedir. Bu uç dairelerin listesini verir; VKN algoritma kontrolü için /v1/dogrula/vkn kullanılır. # Finans ve piyasa ## Döviz Kuru API Sayfa: https://veriapi.pro/api/doviz-kuru-api Dolar, euro, sterlin ve 30'dan fazla paranın TL karşılığı; tek istekte, JSON olarak. /v1/doviz varsayılan olarak anlık Kapalıçarşı kurunu döndürür: USD, EUR, GBP, CHF, CAD, AUD, JPY, SAR, KWD, AED, QAR ve JOD için alış ve satış fiyatı dakikada bir güncellenir. Listede olmayan paralar için Avrupa Merkez Bankası (ECB) referans kurundan hesaplanan çapraz kur verilir; her satırın kaynak alanı hangisinin kullanıldığını söyler. ?tur=referans ile yalnızca merkez bankası referans kurlarını alırsınız (günde bir güncellenir, banka satış kuru değildir). Tutar çevirmek için /v1/cevir/doviz yeterli: 100 USD kaç TL, 250 EUR kaç GBP gibi soruları tek çağrıda yanıtlar. Temel döviz uçları ücretsiz pakette de açıktır. Haber siteleri, e-ticaret fiyat çevirisi, muhasebe ve mobil uygulamalar için yeterli sıklıktadır; kendi sunucunuzda 1–5 dakika önbelleklemeniz kotanızı korur. ### Uçlar - `GET /v1/doviz` — Döviz kurları (TRY): anlık Kapalıçarşı alış/satış, dakikada bir; ?tur=referans ile merkez bankası kuru (tüm paketler, 1 birim); parametreler: `kod`, `tur` - `GET /v1/cevir/doviz` — Döviz çevirici (anlık kur) (tüm paketler, 1 birim); parametreler: `miktar`*, `kaynak`*, `hedef`*, `tur` - `GET /v1/doviz/gecmis` — TCMB döviz alış / satış kuru geçmişi (5 yıla kadar) (tüm paketler, 1 birim); parametreler: `kod`, `gun`, `baslangic`, `bitis` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/doviz?kod=USD,EUR,GBP"` ### Kullanım örnekleri - Haber sitesinde döviz bandı ya da kutusu - E-ticarette fiyatı TL'ye çevirme - Muhasebe ve fatura uygulamasında günlük kur - Mobil uygulamada kur takibi ### Sık sorulan sorular **Döviz kuru API'si ücretsiz mi?** Evet. /v1/doviz ve /v1/cevir/doviz ücretsiz pakette de kullanılabilir; günlük 500 istek birimi hakkınız vardır ve her döviz isteği 1 birimdir. **Kurlar ne sıklıkla güncellenir?** Kapalıçarşı kurları dakikada bir, ECB referans kurları iş günlerinde günde bir güncellenir. Yanıttaki guncelleme alanı verinin zamanını verir. **Banka kuru mu, serbest piyasa kuru mu?** Varsayılan kur Kapalıçarşı (serbest piyasa) alış/satış fiyatıdır. Merkez bankası referans kuru için ?tur=referans kullanın; hiçbiri belirli bir bankanın gişe kuru değildir. **Geçmiş kurlar alınabilir mi?** TCMB döviz alış/satış kuru geçmişi /v1/doviz/gecmis ucundan 5 yıla kadar alınır (EVDS bağlantısı açıkken). ## Altın Fiyatları API Sayfa: https://veriapi.pro/api/altin-fiyatlari-api Kapalıçarşı altın fiyatları: gram altından Reşat'a 15 tür, alış ve satış, günlük değişimle. /v1/altin gram altın, has altın, çeyrek, yarım, tam, Cumhuriyet, Ata çeyrek/yarım, beşli, Reşat, gremse, 22 ve 14 ayar bilezik, ons ve gümüş fiyatlarını alış, satış ve günlük değişimiyle döndürür; fiyatlar 30 saniyede bir yenilenir. Altın türlerinin ağırlığı, ayarı (milyem) ve içerdiği saf altın /v1/altin/turler ucunda; /v1/altin/hesapla verdiğiniz has gram fiyatıyla teorik değeri hesaplar ("5 çeyrek kaç gram has altın" gibi). Fiyat grafiği için /v1/piyasa/grafik?sembol=GRAM kullanılır. ### Uçlar - `GET /v1/altin` — Anlık altın fiyatları: gram, çeyrek, yarım, tam, Cumhuriyet, Ata, Reşat, 22/14 ayar, ons (ücretli paket, 2 birim); parametreler: `tur` - `GET /v1/altin/turler` — Altın türleri: ağırlık, ayar, saf altın; /v1/altin/hesapla teorik değer (tüm paketler, 1 birim) - `GET /v1/altin/hesapla` — Teorik değer: adet × saf altın × has gram fiyatı (ücretli paket, 1 birim); parametreler: `tur`*, `adet`, `has_fiyat` - `GET /v1/piyasa/grafik` — Mum grafiği: 15 dakika, 1 saat, 1 gün (ücretli paket, 5 birim); parametreler: `sembol`*, `aralik`, `adet` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/altin?tur=gram,ceyrek,cumhuriyet"` ### Kullanım örnekleri - Kuyumcu sitesinde canlı fiyat tablosu - Haber sitesinde altın bandı - Birikim / portföy uygulaması - Düğün altını hesaplayıcı ### Sık sorulan sorular **Altın fiyatları API'si ücretsiz pakette var mı?** Canlı fiyatlar (/v1/altin, istek başına 2 birim) ve teorik değer hesabı Başlangıç ve üstü paketlerdedir; altın türlerinin ağırlık ve ayar bilgisi (/v1/altin/turler) ücretsiz pakette de açıktır. **Fiyatlar nereden geliyor?** Kapalıçarşı fiyatları (Harem Altın / Hakan Döviz) biquote.io üzerinden, yazılı yeniden dağıtım izniyle sunulur. **Ne sıklıkla güncellenir?** Altın fiyatları 30 saniyede bir yenilenir; yanıtta güncelleme zamanı yer alır. ## Piyasa Verileri API Sayfa: https://veriapi.pro/api/piyasa-verileri-api 400'den fazla canlı sembol: döviz, altın, gümüş, parite, emtia ve kripto; grafik, takvim ve haberlerle. /v1/piyasa/fiyat ile bir sembolün ya da bir grubun (doviz, altin, kripto, emtia…) alış, satış ve günlük değişimini dakikada bir alırsınız. Sembol kodları /v1/piyasa/semboller'de; USD, GRAM, CEYREK, BRENT, BTC gibi kolay kodlar hazırdır. /v1/piyasa/grafik 15 dakikalık, saatlik ve günlük OHLC mumları verir (günlükte 1 yıla kadar). /v1/piyasa/takvim Türkiye'nin tüm, diğer ülkelerin önemli ekonomik olaylarını beklenti ve gerçekleşen değerleriyle listeler; /v1/piyasa/hareketliler günün en çok yükselen ve düşenlerini, /v1/piyasa/haberler piyasa başlıklarını döndürür. ### Uçlar - `GET /v1/piyasa/fiyat` — Anlık döviz, altın, gümüş, parite, emtia ve kripto (Kapalıçarşı alış/satış) (ücretli paket, 2 birim); parametreler: `sembol`, `grup` - `GET /v1/piyasa/semboller` — Canlı semboller ve hazır kodlar (ücretli paket, 2 birim); parametreler: `tur`, `ara` - `GET /v1/piyasa/grafik` — Mum grafiği: 15 dakika, 1 saat, 1 gün (ücretli paket, 5 birim); parametreler: `sembol`*, `aralik`, `adet` - `GET /v1/piyasa/hareketliler` — Günün en çok yükselen, düşen ve hareketli enstrümanları (ücretli paket, 2 birim); parametreler: `tur`, `liste`, `adet` - `GET /v1/piyasa/takvim` — Ekonomik takvim: enflasyon, faiz kararları; beklenti ve gerçekleşen (ücretli paket, 5 birim); parametreler: `ulke`, `onem`, `baslangic`, `gun` - `GET /v1/piyasa/haberler` — Piyasa haberleri (başlık, yayıncı, bağlantı) (ücretli paket, 2 birim); parametreler: `dil`, `adet` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/piyasa/fiyat?grup=kripto"` ### Kullanım örnekleri - Finans haber sitesinde piyasa sayfası - Kripto ve emtia takip uygulaması - Ekonomik takvim widget'ı - Grafikli fiyat sayfaları ### Sık sorulan sorular **Hangi enstrümanlar var?** Döviz ve pariteler, altın türleri, gümüş, platin, paladyum, Brent ve WTI petrol, doğalgaz, bakır, Bitcoin ve Ethereum dahil 400'den fazla sembol. Borsa İstanbul hisseleri yoktur. **Mum grafiği hangi aralıklarda?** 15 dakika (son 24 saat), 1 saat (son 7 gün) ve 1 gün (son 1 yıl). **Ücretsiz pakette kullanılabilir mi?** Piyasa uçları Başlangıç ve üstü paketlerdedir; grafik istek başına 5, takvim 5, diğerleri 2 birimdir. ## Kripto Para API Sayfa: https://veriapi.pro/api/kripto-para-api 100'den fazla coinin fiyatı tek istekte hem dolar hem Türk lirası olarak; TL karşılığı Kapalıçarşı dolar kuruyla. /v1/kripto Bitcoin, Ethereum, Solana, XRP, Dogecoin gibi 100'den fazla kripto paranın fiyatını, alış/satış, gün içi en yüksek/en düşük ve 24 saatlik değişimiyle döndürür. Her satırda usd ve tl alanları birlikte gelir: USD fiyatı kripto borsalarının USDT paritesidir, TL karşılığı Kapalıçarşı dolar satış kuruyla hesaplanır (kullanılan kur yanıtta usd_try). kod ile istediğiniz coinleri seçer (BTC,ETH,SOL), sirala=degisim ile günün en çok yükselenlerini alırsınız. /v1/kripto/{kod} tek coin, /v1/kripto/hesapla ise 0,5 BTC'nin ya da 10.000 TL'nin karşılığını hesaplar. /v1/kripto/{kod}/grafik her coin için 15 dakikalık (24 saat), saatlik (7 gün) ve günlük geçmiş mumları USD ve TL olarak verir; TL değeri her mumun zamanındaki dolar kuruyla hesaplanır. ### Uçlar - `GET /v1/kripto` — Kripto paralar: 100+ coin, USD ve TL fiyatı, günlük değişim (ücretli paket, 2 birim); parametreler: `kod`, `ara`, `sirala`, `adet` - `GET /v1/kripto/{kod}` — Tek coin: USD ve TL fiyatı, alış/satış, gün içi aralık (ücretli paket, 2 birim); parametreler: `kod`* - `GET /v1/kripto/{kod}/grafik` — Kripto mum grafiği (USD ve TL): 15 dk, 1 saat, günlük geçmiş (ücretli paket, 5 birim); parametreler: `kod`*, `aralik`, `adet`, `para` - `GET /v1/kripto/hesapla` — Kripto tutarının USD ve TL karşılığı (ücretli paket, 2 birim); parametreler: `kod`*, `miktar`*, `birim` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/kripto?kod=BTC,ETH,SOL"` ### Kullanım örnekleri - Haber sitesinde kripto fiyat kutusu - TL bazlı kripto takip uygulaması - Kripto çevirici / hesaplayıcı - Günün en çok yükselen coinleri listesi ### Sık sorulan sorular **TL fiyatı nasıl hesaplanıyor?** USD (USDT) fiyatı, aynı andaki Kapalıçarşı dolar satış kuruyla çarpılır. Kullanılan kur yanıttaki usd_try alanındadır. Türk kripto borsalarının TRY paritesi değildir. **Hangi coinler var?** Bitcoin, Ethereum, XRP, BNB, Solana, TRON, Dogecoin, Cardano, Avalanche, Pepe dahil 100'den fazla coin; tam liste /v1/kripto yanıtındadır. **Ne sıklıkla güncelleniyor?** Fiyatlar dakikada bir yenilenir. Fiyatlar yol gösterici niteliktedir, yatırım tavsiyesi değildir. **Geçmiş grafik ne kadar geriye gidiyor?** Günlük geçmiş 22 Eylül 2026'dan başlar ve kalıcı arşivlendiği için her gün uzar. Saatlik mumlar son 7 günü, 15 dakikalıklar son 24 saati kapsar. **Ücretsiz pakette var mı?** Kripto uçları Başlangıç ve üstü paketlerdedir; fiyat istek başına 2, grafik 2/grafik} birimdir. ## Enflasyon ve Kira Artışı API Sayfa: https://veriapi.pro/api/enflasyon-api TÜFE ve ÜFE değişimleri, yasal kira artış sınırı ve mevduat faizleri; TCMB EVDS'den, her pakette ücretsiz. /v1/ekonomi/enflasyon TÜFE endeksini ve aylık, yıllık ve 12 aylık ortalama değişimi TÜİK yöntemiyle verir. /v1/ekonomi/ufe aynısını Yİ-ÜFE için yapar. /v1/mevzuat/kira-artisi yenileme ayına göre uygulanacak TÜFE ayını seçer (TBK m.344: on iki aylık ortalama), kira tutarı verirseniz azami yeni kirayı hesaplar. /v1/ekonomi/mevduat-faizi bankaların TL mevduata vadeye göre uyguladığı haftalık ağırlıklı ortalama faizi döndürür. TCMB EVDS koşulu gereği bu veriler ek ücrete konu edilmez: tüm paketlerde, ücretsiz pakette de açıktır. ### Uçlar - `GET /v1/ekonomi/enflasyon` — TÜFE: endeks, aylık, yıllık ve 12 aylık ortalama değişim (TCMB EVDS) (tüm paketler, 1 birim); parametreler: `ay` - `GET /v1/ekonomi/ufe` — Yİ-ÜFE: endeks, aylık, yıllık ve 12 aylık ortalama değişim (tüm paketler, 1 birim); parametreler: `ay` - `GET /v1/ekonomi/tufe-ufe` — TÜFE ve Yİ-ÜFE yan yana (son ay ve aylık seri) (tüm paketler, 1 birim); parametreler: `ay` - `GET /v1/mevzuat/kira-artisi` — Kira artış sınırı ve azami yeni kira (tüm paketler, 1 birim); parametreler: `yenileme`, `kira` - `GET /v1/ekonomi/mevduat-faizi` — TL mevduat ağırlıklı ortalama faizleri (vadeye göre, haftalık) (tüm paketler, 1 birim); parametreler: `hafta` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/mevzuat/kira-artisi?kira=20000"` ### Kullanım örnekleri - Emlak sitesinde kira artış hesaplayıcı - Haber sitesinde enflasyon kutusu - Finans uygulamasında mevduat karşılaştırma ### Sık sorulan sorular **Kira artış oranı nasıl hesaplanıyor?** Konut ve çatılı iş yeri kiralarında artış, bir önceki kira yılındaki TÜFE'nin 12 aylık ortalamasıyla sınırlıdır (TBK m.344). API yenileme ayına göre doğru ayın oranını seçer. **Veri ne zaman güncellenir?** TÜİK enflasyonu ayın 3'ünde 10:00'da açıklar; API EVDS'yi aynı gün 10:40 ve 16:40'ta çeker. **Ücretli mi?** Hayır. EVDS verisi tüm paketlerde ücretsizdir. ## Fındık Fiyatları API Sayfa: https://veriapi.pro/api/findik-fiyatlari-api Karadeniz'in 16 fındık merkezinde Sivri, Levant ve Giresun kalite serbest piyasa fiyatları; TMO alım fiyatıyla. /v1/findik kilogram başına serbest piyasa ortalamalarını (kabuklu, 50 randıman) döndürür: üç kalitenin Türkiye ortalaması, Akçakoca, Ordu, Giresun, Trabzon, Samsun, Düzce, Sakarya ve diğer merkezlerin fiyatı (her fiyatın kendi tarihiyle), haftalık, aylık ve yıllık değişim ile en düşük / en yüksek değerler. ?il=ordu ya da ?merkez=unye ile süzülür; merkezler il ve ilçeyle eşlenmiştir. TMO ve Fiskobirlik'in açıkladığı resmî alım fiyatları aynı yanıtta gelir. /v1/findik/tuccarlar firmaların ilan ettiği alış fiyatlarını (firma, ilçe, kalite, ilan tarihi), /v1/findik/gecmis günlük fiyat geçmişini verir. Veri saatte bir güncellenir; fiyatlar yol göstericidir, bağlayıcı alım teklifi değildir. ### Uçlar - `GET /v1/findik` — Fındık fiyatları: Sivri / Levant / Giresun, 16 merkez, TMO alım fiyatı (ücretli paket, 2 birim); parametreler: `merkez`, `il`, `kalite`, `istatistik` - `GET /v1/findik/tuccarlar` — Tüccarların fındık alış fiyatları (firma, ilçe / il, kalite, ilan tarihi) (ücretli paket, 2 birim); parametreler: `il`, `merkez`, `kalite`, `gun` - `GET /v1/findik/gecmis` — Günlük fındık fiyatı geçmişi (kalite ortalamaları ve merkezler) (ücretli paket, 2 birim); parametreler: `merkez`, `gun` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/findik?il=duzce&kalite=levant"` ### Kullanım örnekleri - Karadeniz'deki yerel haber sitelerinde günlük fındık fiyatı kutusu - Üretici ve kooperatif uygulamaları - Tarım haberlerinde merkezler arası fiyat karşılaştırması ### Sık sorulan sorular **Fındık fiyatları ücretsiz pakette var mı?** Hayır; fındık uçları Başlangıç ve üstü paketlerdedir (istek başına 2 birim). **Fiyatlar hangi randımana göre?** Kilogram başına, kabuklu ve 50 randıman serbest piyasa ortalamasıdır. **TMO fiyatı da var mı?** Evet; TMO ve Fiskobirlik'in resmî alım fiyatları kalite bazında aynı yanıtta gelir. **Ne sıklıkla güncellenir?** Saatte bir; her merkezin fiyatı kendi tarihiyle verilir. # Takvim ve zaman ## Namaz Vakitleri API Sayfa: https://veriapi.pro/api/namaz-vakitleri-api 81 il ve 973 ilçe için günlük ya da 31 günlük namaz vakitleri, iftar ve sahur saatleriyle. /v1/namaz il, ilçe, konum adı ya da koordinatla çalışır; gun=31'e kadar ardışık günleri tek istekte döndürür. Sahur saati imsak, iftar saati akşam vaktidir. Vakitler Diyanet'in yöntemiyle (imsak 18°, yatsı 17°, temkinler dahil) kendi sunucumuzda hesaplanır; dış kaynağa bağlı olmadığı için kesinti riski yoktur. Diyanet'in yayımladığı takvimle karşılaştırmalarımızda fark ±1 dakikadır; resmî Diyanet verisi değildir. Güneşin doğuş ve batış saatleri ile gün uzunluğu için /v1/gunes kullanılır. Ramazan başlangıcı, kandiller ve bayramlar /v1/takvim/dini-gunler ucundadır. ### Uçlar - `GET /v1/namaz` — Namaz vakitleri, iftar ve sahur (31 güne kadar) (tüm paketler, 1 birim); parametreler: `tarih`, `gun`, `konum`, `il`, `ilce`, `enlem`, `boylam` - `GET /v1/gunes` — Güneş doğuş / batış, gün uzunluğu (tüm paketler, 1 birim); parametreler: `tarih`, `gun`, `konum`, `il`, `ilce`, `enlem`, `boylam` - `GET /v1/takvim/dini-gunler` — Kandiller, Ramazan başlangıcı, hicri yılbaşı, bayramlar (tüm paketler, 1 birim); parametreler: `yil` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/namaz?il=duzce&ilce=akcakoca&gun=1"` ### Kullanım örnekleri - Haber sitesinde namaz vakti ve iftar sayacı - Cami ve dernek siteleri - Mobil namaz vakti uygulaması - Ramazan'da iftar/sahur widget'ı ### Sık sorulan sorular **Namaz vakitleri API'si ücretsiz mi?** Evet, ücretsiz pakette de açıktır. 31 günlük vakit tek istektir (1 birim); hazır namaz vakti widget'ı da vardır. **Diyanet ile aynı mı?** Diyanet yöntemiyle hesaplanır, yayımlanan takvimle ±1 dakika uyumludur. Resmî Diyanet verisi değildir; yanıttaki atıf bunu belirtir. **İlçe bazında var mı?** Evet, 973 ilçenin tamamı için. Ayrıca enlem/boylam vererek herhangi bir nokta için hesaplatabilirsiniz. **İftar ve sahur saati nerede?** Her günün kaydında iftar (akşam vakti) ve sahur (imsak) alanları ayrıca yer alır. ## Resmî Tatiller ve Takvim API Sayfa: https://veriapi.pro/api/resmi-tatiller-api Resmî tatiller, dini günler, hicri takvim, ay evreleri ve okul tatilleri tek takvim API'sinde. /v1/takvim/tatiller bir yılın resmî tatillerini, dini bayramları ve yarım günleri (arife, 28 Ekim) verir. /v1/takvim/gun ise tek bir tarihin hafta numarasını, iş günü olup olmadığını ve varsa tatil adını döndürür; vardiya, kargo teslim tahmini ve randevu sistemleri için idealdir. Kandiller, Ramazan başlangıcı, hicri yılbaşı ve Aşure /v1/takvim/dini-gunler'de; /v1/takvim/hicri ve /v1/takvim/miladi iki takvim arasında dönüşüm yapar (Diyanet'in duyurduğu ay başlarıyla). Ay evresi ve dolunay saatleri /v1/takvim/ay, MEB ara tatilleri ve yarıyıl /v1/takvim/okul ucundadır. ### Uçlar - `GET /v1/takvim/tatiller` — Resmî tatiller ve dini bayramlar (tüm paketler, 1 birim); parametreler: `yil` - `GET /v1/takvim/gun` — Gün bilgisi: hafta numarası, iş günü, tatil (tüm paketler, 1 birim); parametreler: `tarih` - `GET /v1/takvim/dini-gunler` — Kandiller, Ramazan başlangıcı, hicri yılbaşı, bayramlar (tüm paketler, 1 birim); parametreler: `yil` - `GET /v1/takvim/hicri` — Miladi tarihin hicri karşılığı (Diyanet takvimi) (tüm paketler, 1 birim); parametreler: `tarih` - `GET /v1/takvim/miladi` — Hicri tarihin miladi karşılığı (tüm paketler, 1 birim); parametreler: `yil`*, `ay`*, `gun` - `GET /v1/takvim/ay` — Ay evresi, aydınlanma yüzdesi, sıradaki dolunay / yeni ay (tüm paketler, 1 birim); parametreler: `tarih` - `GET /v1/takvim/okul` — MEB okul takvimi: ara tatiller, yarıyıl, karne günleri (tüm paketler, 1 birim); parametreler: `yil` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/takvim/gun?tarih=2026-10-29"` ### Kullanım örnekleri - İK ve bordro yazılımında iş günü hesabı - Randevu ve kargo teslim tarihi - Haber sitesinde "bugün" kutusu - Okul ve veli uygulamalarında tatil sayacı ### Sık sorulan sorular **Dini bayram tarihleri nereden?** Diyanet'in duyurduğu tarihlerden; henüz duyurulmamış yıllar için bayram eklenmez, hicri dönüşüm uçları ise hesapla çalışmaya devam eder. **Yarım gün tatiller var mı?** Evet; arife günleri ve 28 Ekim yarım gün olarak işaretlenir. **Ücretsiz mi?** Takvim uçlarının tamamı ücretsiz pakette açıktır. ## Dünya Saati, Ülke ve Birim API Sayfa: https://veriapi.pro/api/dunya-saati-ulke-api Şehirlerin yerel saati, 196 ülkenin bilgileri ve dekardan m²'ye birim çevirici. /v1/saat Türkçe şehir adıyla (Londra, Tokyo, New York) ya da IANA saat dilimiyle yerel saati, UTC farkını ve Türkiye'yle saat farkını verir. /v1/ulkeler kıtaya veya para birimine göre ülkeleri ISO 2/3 harfli ve sayısal kod, başkent, para birimi ve telefon koduyla listeler. /v1/cevir/birim uzunluk, kütle, alan (dönüm, dekar), hacim, hız ve sıcaklık birimleri arasında çevirir. ### Uçlar - `GET /v1/saat` — Dünya saatleri: yerel saat, UTC ve Türkiye farkı (tüm paketler, 1 birim); parametreler: `sehir`, `bolge` - `GET /v1/saat/sehirler` — Tanımlı şehirler ve şu anki yerel saatleri (tüm paketler, 1 birim); parametreler: `ulke` - `GET /v1/ulkeler` — Ülkeler: ISO kodları, başkent, para birimi, telefon kodu (tüm paketler, 1 birim); parametreler: `kita`, `para` - `GET /v1/ulkeler/{kod}` — Tek ülke (ISO2, ISO3, sayısal kod ya da ad) (tüm paketler, 1 birim); parametreler: `kod`* - `GET /v1/cevir/birim` — Birim çevirici (uzunluk, kütle, alan, hacim, hız, sıcaklık) (ücretli paket, 1 birim); parametreler: `miktar`*, `kaynak`*, `hedef`* Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/saat?sehir=londra"` ### Kullanım örnekleri - Seyahat ve vize sitelerinde ülke bilgisi - Toplantı planlayıcıda saat farkı - Tarım sitelerinde dönüm-m² çevirisi ### Sık sorulan sorular **Yaz saati uygulaması dikkate alınıyor mu?** Evet; IANA saat dilimi veritabanı kullanıldığı için yaz/kış saati geçişleri kendiliğinden hesaplanır. **Ücretsiz mi?** Saat ve ülke uçları ücretsiz pakette açıktır; birim çevirici Başlangıç ve üstü paketlerdedir. ## İş Günü Hesaplama API Sayfa: https://veriapi.pro/api/is-gunu-hesaplama-api Teslim, vade ve süre hesabı için: hafta sonu, resmî tatil ve bayramlar atlanarak iş günü. /v1/takvim/is-gunu/ekle bir tarihten N iş günü sonrasını (eksi değerle öncesini) verir; başlangıç günü sayılmaz. /v1/takvim/is-gunu/say iki tarih arasındaki iş günü, hafta sonu ve tatil sayısını, aradaki tatillerin listesiyle döndürür. Arifeler ve 28 Ekim yarım gündür; varsayılan olarak iş günü sayılır, arife=tatil ile tatil sayılabilir. cumartesi=true altı günlük çalışma düzeni içindir. Dini bayram tarihleri girilmemiş bir yıla taşan hesapta yanıt uyari alanıyla bunu belirtir. ### Uçlar - `GET /v1/takvim/is-gunu/ekle` — N iş günü sonrası: hafta sonu, resmî tatil ve bayramlar atlanır (tüm paketler, 1 birim); parametreler: `gun`*, `tarih`, `cumartesi`, `arife` - `GET /v1/takvim/is-gunu/say` — İki tarih arası iş günü sayısı ve aradaki tatiller (tüm paketler, 1 birim); parametreler: `baslangic`*, `bitis`*, `cumartesi`, `arife`, `baslangic_dahil`, `bitis_dahil` - `GET /v1/takvim/gun` — Gün bilgisi: hafta numarası, iş günü, tatil (tüm paketler, 1 birim); parametreler: `tarih` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/takvim/is-gunu/ekle?tarih=2026-05-22&gun=5"` ### Kullanım örnekleri - E-ticarette tahmini teslim tarihi - Hukuk ve muhasebede süre / vade hesabı - Bordro ve izin hesapları ### Sık sorulan sorular **İş günü API'si ücretsiz mi?** Evet; her pakette açıktır, istek başına 1 birim. **Arife günü iş günü mü?** Arifeler öğleden sonra tatildir. Varsayılan hesap arifeyi iş günü sayar; arife=tatil ile tatil sayabilirsiniz. **Köprü (idari izin) günleri dahil mi?** Hayır; idari izin kamu personeli içindir ve yalnızca Cumhurbaşkanlığı kararı yayımlanınca eklenir. # Hava, çevre ve afet ## Hava Durumu API Sayfa: https://veriapi.pro/api/hava-durumu-api 81 il ve 973 ilçe için anlık hava, UV indeksi, 24 saatlik ve 7 günlük tahmin; Türkçe durum adlarıyla. /v1/hava konum adı, il/ilçe ya da koordinatla çalışır; anlık sıcaklık, nem, basınç, rüzgâr, bulut, yağış, UV indeksi ve Türkçe durum adını ("parçalı bulutlu" gibi), ardından 24 saatlik ve 7 günlük tahmini döndürür. Tüm il ve ilçe merkezlerinin verisi önceden çekildiği için yanıtlar hızlıdır. Daha fazla ayrıntı için /v1/hava/detay (hissedilen sıcaklık, çiy noktası, görüş, rüzgâr hamlesi, 16 güne kadar tahmin) ve /v1/hava/yagis (önümüzdeki 24 saat için 15 dakikalık yağış, kar ve olasılık) uçları vardır. ### Uçlar - `GET /v1/hava` — Anlık hava, UV indeksi, 24 saatlik ve 7 günlük tahmin (tüm paketler, 1 birim); parametreler: `konum`, `il`, `ilce`, `enlem`, `boylam` - `GET /v1/hava/detay` — Ayrıntılı hava: hissedilen, çiy noktası, basınç, görüş, hamle; 16 gün (ücretli paket, 2 birim); parametreler: `saat`, `gun`, `konum`, `il`, `ilce`, `enlem`, `boylam` - `GET /v1/hava/yagis` — Yağış tahmini: 15 dakikalık ve saatlik, olasılık, kar (ücretli paket, 2 birim); parametreler: `konum`, `il`, `ilce`, `enlem`, `boylam` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/hava?il=duzce&ilce=akcakoca"` ### Kullanım örnekleri - Haber sitesinde hava durumu bandı - Yerel portalda ilçe hava sayfası - Tarım ve etkinlik planlama uygulamaları - Mobil hava widget'ı ### Sık sorulan sorular **Hava durumu API'si ücretsiz mi?** Evet; /v1/hava (anlık hava, UV, 24 saatlik ve 7 günlük tahmin) ücretsiz pakette açıktır ve hazır hava widget'ı vardır. Ayrıntılı 16 günlük tahmin ve 15 dakikalık yağış uçları Başlangıç ve üstü paketlerdedir (istek başına 2 birim). **Veri kaynağı ne?** Anlık hava ve 7 günlük tahmin MET Norway'den (CC BY 4.0), ayrıntılı tahmin ve yağış Open-Meteo'dan gelir; yanıttaki atıf metnini gösterdiğiniz yerde yazmanız gerekir. **Ne sıklıkla güncellenir?** Konumlar kaynağın yeni tahmin yayımlama sıklığına göre (genellikle saatte bir) yenilenir. **Koordinatla sorgulayabilir miyim?** Evet; enlem ve boylam verirseniz 60 km içindeki en yakın il/ilçe merkezi kullanılır. ## Hava Kalitesi API Sayfa: https://veriapi.pro/api/hava-kalitesi-api Her il ve ilçe için PM2.5, PM10, ozon, azot dioksit ve toz; Avrupa ve ABD indeksiyle. /v1/hava-kalitesi bir konumun anlık kirletici değerlerini (µg/m³) ve saatlik tahminini verir. Avrupa (EAQI) ve ABD (US AQI) indekslerinin yanında "iyi", "orta", "sağlıksız" gibi Türkçe seviye adını da döndürür; sağlık uyarısı kutuları için doğrudan kullanılabilir. Veri Copernicus Atmosfer İzleme Servisi (CAMS) modelinden gelir; ölçüm istasyonu değil model tahminidir, bu yüzden istasyonu olmayan ilçeler için de değer üretir. ### Uçlar - `GET /v1/hava-kalitesi` — Hava kalitesi: PM2.5, PM10, NO₂, O₃; Avrupa ve ABD indeksi, 3 günlük tahmin (tüm paketler, 2 birim); parametreler: `saat`, `konum`, `il`, `ilce`, `enlem`, `boylam` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/hava-kalitesi?il=istanbul"` ### Kullanım örnekleri - Haber sitesinde hava kalitesi uyarısı - Sağlık ve spor uygulamaları - Belediye ve çevre portalları ### Sık sorulan sorular **Ölçüm mü, tahmin mi?** CAMS modeli tahminidir; resmî ölçüm istasyonu verisi değildir. **Hangi indeks kullanılıyor?** Hem Avrupa hava kalitesi indeksi hem ABD AQI döner; Türkçe seviye adı Avrupa indeksine göredir. ## Deprem API Sayfa: https://veriapi.pro/api/deprem-api Türkiye ve çevresindeki son 7 günün depremleri; en yakın il, ilçe ve uzaklık bilgisiyle. /v1/deprem/son büyüklük, derinlik, zaman ve koordinatın yanında depremin en yakın il ve ilçe merkezine uzaklığını ("Akçakoca'nın 12 km kuzeyi" türü metinler için) verir. min_buyukluk, saat, il ve yurtici filtreleriyle yalnızca ihtiyacınız olanı alırsınız. Liste 2 dakikada bir EMSC'den, ulaşılamazsa USGS'den yenilenir. Haber siteleri son dakika kutusu, yerel portallar ise "ilimizde son depremler" sayfası için kullanır. Bu veri bilgilendirme amaçlıdır; erken uyarı sistemi değildir. ### Uçlar - `GET /v1/deprem/son` — Son depremler, en yakın il/ilçe ve uzaklık (tüm paketler, 1 birim); parametreler: `limit`, `min_buyukluk`, `saat`, `il`, `yurtici` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/deprem/son?min_buyukluk=3&limit=3"` ### Kullanım örnekleri - Haber sitesinde son depremler kutusu - Yerel portalda il deprem listesi - Mobil bildirim uygulamaları için kaynak ### Sık sorulan sorular **Deprem API'si ücretsiz mi?** Evet, ücretsiz pakette de açıktır; hazır deprem widget'ı da vardır. **AFAD ya da Kandilli verisi mi?** Hayır. EMSC (CC BY 4.0) ve USGS (kamu malı) kullanılır; Kandilli verisi ticari kullanıma kapalı olduğu için sunulmaz. **Gecikme ne kadar?** Liste 2 dakikada bir yenilenir; kaynak ajansların ilk yayımı genellikle depremden birkaç dakika sonradır. ## Baraj Doluluk API Sayfa: https://veriapi.pro/api/baraj-doluluk-api Türkiye'deki barajların güncel doluluk oranı; il ortalaması, teknik bilgiler ve günlük seyirle. /v1/baraj Türkiye ortalamasını, en dolu ve en boş beş barajı verir; il verilirse o ilin barajlarını da ekler. /v1/baraj/liste il, havza ve doluluk aralığına göre süzer; /v1/baraj/iller il ortalamalarını, /v1/baraj/{slug} barajın hacim, kot, kurulu güç, yapım yılı, amaç, konum ve 30 günlük seyrini döndürür. Doluluk, aktif (kullanılabilir) hacmin yüzdesidir. Ölçümler DSİ ile İSKİ, ASKİ, İZSU ve İSU'nundur; veri her gün iki kez yenilenir. /v1/baraj/{slug}/gecmis kendi arşivimizden günlük seriyi verir (Haziran 2026'dan beri). ### Uçlar - `GET /v1/baraj` — Baraj doluluk: Türkiye ve il ortalaması, en dolu / en boş barajlar (tüm paketler, 1 birim); parametreler: `il` - `GET /v1/baraj/liste` — Barajlar: il, havza, doluluk aralığı; doluluğa göre sıralı (ücretli paket, 2 birim); parametreler: `il`, `havza`, `en_az`, `en_cok`, `siralama` - `GET /v1/baraj/iller` — İllere göre ortalama baraj doluluğu ve baraj sayısı (ücretli paket, 2 birim) - `GET /v1/baraj/{slug}` — Baraj ayrıntısı: doluluk, hacim, kot, kurulu güç, amaç, konum ve 30 günlük seyir (ücretli paket, 2 birim); parametreler: `slug`* - `GET /v1/baraj/{slug}/gecmis` — Baraj doluluk geçmişi (günlük, kendi arşivimizden) (ücretli paket, 2 birim); parametreler: `slug`*, `gun` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/baraj?il=istanbul"` ### Kullanım örnekleri - Haber sitesinde "İstanbul barajları ne durumda?" kutusu - Kuraklık ve su kesintisi haberlerinde grafik - Tarım ve enerji (HES) uygulamaları ### Sık sorulan sorular **Baraj doluluk API'si ücretsiz mi?** Türkiye ve il özeti (/v1/baraj) her pakette açıktır; liste, ayrıntı ve geçmiş Başlangıç ve üstü paketlerdedir (istek başına 2 birim). **Veri ne sıklıkla güncellenir?** Kaynak her sabah güncellenir; biz günde iki kez (11:15 ve 17:15) yeniliyoruz. Her barajın olcum_tarihi alanı kendi ölçüm gününü gösterir. **Ortalama nasıl hesaplanıyor?** İl ve Türkiye ortalaması barajların doluluk oranlarının basit ortalamasıdır; hacme göre ağırlıklı değildir. # Enerji ve ulaşım ## Akaryakıt Fiyatları API Sayfa: https://veriapi.pro/api/akaryakit-fiyatlari-api 81 ilde dağıtıcı bazında benzin, motorin ve LPG fiyatları; Türkiye ortalaması ve geçmişiyle. /v1/akaryakit bir ildeki dağıtıcıların bildirdiği benzin, motorin, LPG ve diğer yakıt fiyatlarını döndürür; tur ve dagitici ile süzülür. İstanbul Avrupa ve Anadolu yakası ayrı bölgelerdir. /v1/akaryakit/turkiye en yüksek hacimli 8 dağıtıcının ortalamasını, /v1/akaryakit/gecmis ilin günlük ortalama fiyat geçmişini verir. Fiyatlar dağıtıcının EPDK'ya bildirdiği bayi tavan/tavsiye fiyatıdır; tek bir istasyonun pompa fiyatı değildir. Yolculuk maliyeti için /v1/hesapla/yakit ilin güncel fiyatını kendiliğinden kullanır. ### Uçlar - `GET /v1/akaryakit` — Akaryakıt ve LPG fiyatları: il ve dağıtıcı bazında (ücretli paket, 2 birim); parametreler: `il`*, `tur`, `dagitici` - `GET /v1/akaryakit/turkiye` — Türkiye ortalaması (en yüksek hacimli 8 dağıtıcı) (ücretli paket, 2 birim) - `GET /v1/akaryakit/gecmis` — İlin günlük ortalama fiyat geçmişi (toplama başladığımız günden itibaren) (ücretli paket, 2 birim); parametreler: `il`*, `gun` - `GET /v1/hesapla/yakit` — Yolculuk yakıt maliyeti (ilin güncel fiyatıyla) (ücretli paket, 1 birim); parametreler: `mesafe`*, `tuketim`*, `fiyat`, `il`, `yakit`, `kisi`, `gidis_donus` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/akaryakit?il=duzce&tur=benzin"` ### Kullanım örnekleri - Haber sitesinde akaryakıt kutusu ve zam haberleri - Filo ve lojistik maliyet hesabı - Yolculuk planlama uygulamaları ### Sık sorulan sorular **Ücretsiz pakette var mı?** Hayır; akaryakıt uçları Başlangıç ve üstü paketlerdedir (istek başına 2 birim). **Pompa fiyatı mı?** Dağıtıcının EPDK'ya bildirdiği il bazında bayi fiyatıdır; istasyonlar arasında küçük farklar olabilir. **Ne sıklıkla güncellenir?** 2 saatte bir; zamlar genellikle gece yarısı yürürlüğe girer. ## Şarj İstasyonu API Sayfa: https://veriapi.pro/api/sarj-istasyonu-api Türkiye'deki 2.000'den fazla şarj istasyonu: konum, operatör, soket, güç; en yakın istasyon aramasıyla. /v1/sarj/istasyonlar il ve ilçeye, operatöre, soket tipine, DC hızlı şarja ve en düşük güce göre süzer. /v1/sarj/yakin bir koordinata en yakın istasyonları mesafe sırasıyla verir. /v1/sarj/istatistik il sıralamasını, operatör paylarını ve soket dağılımını, /v1/sarj/yeni son eklenen istasyonları döndürür (haberler için). Anlık doluluk ve resmî fiyat bilgisi yoktur. ### Uçlar - `GET /v1/sarj/istasyonlar` — Elektrikli araç şarj istasyonları: il / ilçe, operatör, soket, güç (ücretli paket, 2 birim); parametreler: `konum`, `il`, `ilce`, `operator`, `soket`, `dc`, `min_kw`, `herkese_acik`, `sayfa`, `limit` - `GET /v1/sarj/yakin` — Koordinata en yakın şarj istasyonları (ücretli paket, 5 birim); parametreler: `enlem`*, `boylam`*, `yaricap`, `operator`, `soket`, `dc`, `min_kw`, `herkese_acik`, `limit` - `GET /v1/sarj/istatistik` — Şarj altyapısı özeti: il sıralaması, operatör payı, soket tipleri (tüm paketler, 1 birim); parametreler: `konum`, `il`, `ilce` - `GET /v1/sarj/operatorler` — Şarj operatörleri ve istasyon / soket sayıları (tüm paketler, 1 birim); parametreler: `konum`, `il`, `ilce` - `GET /v1/sarj/yeni` — Son eklenen şarj istasyonları (haberler için) (ücretli paket, 1 birim); parametreler: `gun`, `konum`, `il`, `ilce`, `limit` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/sarj/istatistik?il=duzce"` ### Kullanım örnekleri - Otomotiv sitelerinde şarj haritası - Rota planlama uygulamaları - İl il şarj altyapısı haberleri ### Sık sorulan sorular **Veri kaynağı nedir?** Open Charge Map (CC BY 4.0 ve CC0 kayıtlar); ticari kullanıma kapalı kaynakların kayıtları çıkarılır. **Doluluk bilgisi var mı?** Hayır; istasyonun konumu ve donanımı verilir, anlık doluluk ve fiyat yoktur. ## Elektrik Kesintisi API Sayfa: https://veriapi.pro/api/elektrik-kesintisi-api Dağıtım şirketlerinin bildirdiği planlı ve plansız elektrik kesintileri; il, ilçe ve mahalleye göre, yedi gün ileriye. /v1/elektrik/kesinti önümüzdeki yedi günün planlı kesintilerini ve dün ile bugünün plansız (arıza) kesintilerini döndürür: il, ilçe, etkilenen mahalleler, başlangıç ve bitiş saati, kesinti nedeni, etkilenen abone sayısı ve dağıtım şirketi. il, ilce, mahalle (adın bir kısmı), tur (planli / plansiz) ve tarih parametreleriyle süzülür. Veri, dağıtım şirketlerinin EPİAŞ Şeffaflık Platformu'na bildirdiği kayıtlardır ve 15 dakikada bir yenilenir. Saatler dağıtım şirketince değiştirilebilir; kesin bilgi için 186 numaralı hat esas alınmalıdır. ### Uçlar - `GET /v1/elektrik/kesinti` — Elektrik kesintileri: planlı / plansız, il, ilçe, mahalle, saat, neden (EPİAŞ) (ücretli paket, 2 birim); parametreler: `il`, `ilce`, `mahalle`, `tur`, `tarih`, `limit` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/elektrik/kesinti?il=istanbul&tur=planli&limit=5"` ### Kullanım örnekleri - Yerel haber sitesinde "yarın hangi mahallelerde elektrik kesilecek" haberi ve kutusu - Belediye ve kent portallarında ilçe bazlı kesinti duyurusu - Mobil uygulamada mahalleye göre bildirim - Kesinti nedeni ve süresine göre istatistik ### Sık sorulan sorular **Elektrik kesintisi API'si ücretsiz mi?** Hayır; Başlangıç ve üstü paketlerdedir, istek başına 2 birim. **Hangi dağıtım şirketlerini kapsar?** EPİAŞ'a bildirim yapan 21 elektrik dağıtım şirketinin tamamını (BEDAŞ, AYEDAŞ, SEDAŞ, Başkent, Toroslar…); her kayıtta dağıtım şirketinin adı yer alır. **Ne kadar ileriyi gösterir?** Planlı kesintiler bugünden itibaren yedi gün; plansız (arıza) kesintiler dağıtım şirketlerince sonradan bildirildiği için dün ve bugün. **Kaynak göstermem gerekir mi?** Evet; veri EPİAŞ Şeffaflık Platformu'ndandır, kaynak gösterilerek kullanılabilir. ## Elektrik Fiyatı (PTF) API Sayfa: https://veriapi.pro/api/elektrik-fiyati-ptf-api Gün öncesi piyasasında oluşan saatlik elektrik fiyatı ve Türkiye'nin anlık elektrik üretim / tüketim tablosu. /v1/elektrik/ptf günün 24 saatlik piyasa takas fiyatını (TL/MWh, USD ve EUR karşılığıyla), günlük ortalamayı, ağırlıklı ortalamayı, en yüksek ve en düşük saati döndürür; ertesi günün fiyatı her gün ~14:00'te yayımlanınca tarih parametresiyle alınır. Geçmiş günler de sorgulanabilir. /v1/elektrik/uretim son saatin üretimini kaynaklara göre (doğalgaz, linyit, ithal kömür, baraj, akarsu, rüzgâr, güneş, jeotermal, biyokütle…) yüzde paylarıyla ve yenilenebilir payını verir; saatlik=true ile günün tüm saatleri. /v1/elektrik/tuketim saatlik Türkiye tüketimini (~2 saat gecikmeli) döndürür. /v1/elektrik/piyasa günün özetini tek istekte verir: PTF, dengeleme piyasası fiyatı (SMF) ve sistem yönü (enerji açığı / fazlası), gün içi piyasa ortalaması ve doğalgaz spot piyasasının günlük referans fiyatı (GRF). ### Uçlar - `GET /v1/elektrik/ptf` — Elektrik piyasa takas fiyatı (PTF): saatlik TL / USD / EUR, günlük ortalama (tüm paketler, 2 birim); parametreler: `tarih` - `GET /v1/elektrik/piyasa` — Enerji piyasası özeti: PTF, SMF ve sistem yönü, gün içi fiyat, doğalgaz spot fiyatı (tüm paketler, 1 birim) - `GET /v1/elektrik/uretim` — Anlık elektrik üretimi: kaynak dağılımı ve yenilenebilir payı (tüm paketler, 1 birim); parametreler: `saatlik` - `GET /v1/elektrik/tuketim` — Saatlik elektrik tüketimi (Türkiye) (tüm paketler, 1 birim) Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/elektrik/uretim"` ### Kullanım örnekleri - Enerji ve ekonomi haberlerinde günlük PTF ve yenilenebilir payı - Fabrika ve işletmelerde saatlik tüketim planlaması - Elektrikli araç şarjını en ucuz saate kaydırma - Rüzgâr / güneş rekor haberleri için grafik ### Sık sorulan sorular **PTF API'si ücretsiz mi?** Evet; PTF, piyasa özeti, üretim ve tüketim uçları her pakette açıktır. Geçmiş gün PTF'si istek başına 2 birim. **PTF faturadaki fiyat mı?** Hayır; PTF toptan piyasada oluşan fiyattır (TL/MWh). Konut ve işyeri tarifeleri için /v1/elektrik/tarife kullanılır. **Yarının fiyatı ne zaman çıkar?** Gün öncesi piyasası her gün ~14:00'te sonuçlanır; yarin_yayimlandi alanı fiyatın alınıp alınmadığını gösterir. # Spor ve yaşam ## Nöbetçi Eczane API Sayfa: https://veriapi.pro/api/nobetci-eczane-api 81 ilde bugünün nöbetçi eczaneleri: ad, adres, telefon ve harita konumu. /v1/eczane/nobetci il (ve isteğe bağlı ilçe) ile o anki nöbetçi eczaneleri döndürür. Nöbet günü sabah 09:00'da değiştiği için saat 09:00'dan önce önceki günün listesi verilir. Liste güncel değilse API bayat veri göstermek yerine 503 döner; böylece sitenizde yanlış eczane yayımlanmaz. ### Uçlar - `GET /v1/eczane/nobetci` — Nöbetçi eczaneler (il / ilçe) (ücretli paket, 2 birim); parametreler: `il`*, `ilce` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/eczane/nobetci?il=duzce"` ### Kullanım örnekleri - Yerel haber sitesinde nöbetçi eczane sayfası - Belediye ve şehir rehberi uygulamaları ### Sık sorulan sorular **Liste ne zaman değişir?** Nöbetler sabah 09:00'da devredilir; API bunu dikkate alır. **Kaynak güncel değilse ne olur?** Bayat liste gösterilmez, uç 503 döner. ## Oyun Fiyatları API Sayfa: https://veriapi.pro/api/oyun-fiyatlari-api PC oyunlarında mağazalar arası fiyat karşılaştırma, güncel indirimler ve ücretsiz oyunlar. /v1/oyun/firsatlar en iyi fırsatları indirim, fiyat, Metacritic puanı ve mağazaya göre süzer; /v1/oyun/ucretsiz şu an bedava olan oyunları listeler. /v1/oyun/ara ve /v1/oyun/{oyun_id} bir oyunun tüm mağazalardaki fiyatını ve tarihteki en düşük fiyatını verir. Fiyatlar dolar cinsindendir, yanıtta güncel kurla TL karşılığı da bulunur. Mağaza bağlantıları CheapShark yönlendirmesiyle verilir. ### Uçlar - `GET /v1/oyun/firsatlar` — İndirimdeki PC oyunları (Steam, GOG, Epic…), TL karşılığıyla (ücretli paket, 2 birim); parametreler: `magaza`, `min_indirim`, `max_fiyat`, `min_metacritic`, `sirala`, `sayfa`, `limit` - `GET /v1/oyun/ucretsiz` — Şu an ücretsiz olan PC oyunları (ücretli paket, 2 birim); parametreler: `limit` - `GET /v1/oyun/ara` — Oyun ara ve mağaza fiyatlarını karşılaştır (ücretli paket, 10 birim); parametreler: `q`*, `limit` - `GET /v1/oyun/{oyun_id}` — Oyunun tüm mağazalardaki fiyatları ve tarihteki en düşük fiyatı (ücretli paket, 10 birim); parametreler: `oyun_id`* - `GET /v1/oyun/magazalar` — Takip edilen dijital oyun mağazaları (ücretli paket, 1 birim); parametreler: `tumu` Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/oyun/ucretsiz?limit=3"` ### Kullanım örnekleri - Oyun haber sitelerinde "haftanın indirimleri" - Discord / Telegram fırsat botları - Fiyat alarmı uygulamaları ### Sık sorulan sorular **Konsol oyunları var mı?** Hayır, yalnızca PC dijital mağazaları. **Ücretsiz pakette var mı?** Hayır; oyun uçları Başlangıç ve üstü paketlerdedir; arama 10, oyun ayrıntısı 10 birimdir. ## Kalori ve Besin Değerleri API Sayfa: https://veriapi.pro/api/kalori-besin-api Türkçe arama ile 154 gıda ve 41 Türk yemeğinin kalori ve besin değerleri; porsiyon ve öğün toplamı. /v1/besin/ara "mercimek", "köfte", "elma" gibi Türkçe sorgularla arar; /v1/besin/{slug} 100 gram, porsiyon ya da istediğiniz miktar için enerji, protein, yağ, doymuş yağ, karbonhidrat, şeker, lif, sodyum ve vitamin/mineral değerlerini verir. /v1/besin/hesapla bir öğünü (mercimek çorbası, 2 porsiyon pilav, ayran) tek istekte toplar. Gıda değerleri USDA FoodData Central'dan (CC0), Türk yemekleri tariften hesaplanır ve yaklaşıktır; tıbbi beslenme planı yerine kullanılmamalıdır. ### Uçlar - `GET /v1/besin/ara` — Türkçe besin ve yemek arama (kalori) (tüm paketler, 1 birim); parametreler: `q`, `kategori`, `tur`, `limit` - `GET /v1/besin/{slug}` — Besin değerleri: 100 g, porsiyon ya da istenen miktar (tüm paketler, 1 birim); parametreler: `slug`*, `gram`, `porsiyon`, `adet` - `GET /v1/besin/hesapla` — Öğün kalori hesaplayıcı (ücretli paket, 2 birim); parametreler: `liste`* - `GET /v1/besin/kategoriler` — Besin kategorileri ve kayıt sayıları (tüm paketler, 1 birim) Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/besin/mercimek-corbasi?porsiyon=1"` ### Kullanım örnekleri - Diyet ve fitness uygulamaları - Yemek tarifi sitelerinde kalori kutusu - Kafeterya menülerinde besin bilgisi ### Sık sorulan sorular **Türk yemekleri var mı?** Evet; çorbalar, ana yemekler, zeytinyağlılar, hamur işleri ve tatlılar dahil 41 yemek. **Değerler ne kadar doğru?** Gıdalar USDA ölçümlerinden, yemekler tariften hesaplanır; yemeklerde değerler yaklaşıktır. ## Burç Yorumları API Sayfa: https://veriapi.pro/api/burc-yorumlari-api 12 burç için her gün Türkçe günlük yorum; doğum tarihinden burç ve burç bilgileri. /v1/burc/gunluk her burç için günün yorumunu döndürür: yorum metni, odaklanılacak konu, dikkat edilecek nokta ve kısa bir ipucu; ayrıca o günün gezegen açıları ve gezegen geçişleri. ?burc=koc ile tek burç, ?tarih= ile son 7 günden biri alınır. Yorumlar her gece bir kez hazırlanır ve Türkçeye çevrilir; ?dil=en özgün İngilizce metni verir. /v1/burc/burclar 12 burcun tarih aralığını, elementini, niteliğini ve yönetici gezegenini; /v1/burc/bul?tarih= doğum tarihinin güneş burcunu verir. Sınır günlerinde doğanlar için yanıt bunu ayrıca belirtir. Burç yorumları eğlence amaçlıdır. ### Uçlar - `GET /v1/burc/gunluk` — Günlük burç yorumları: genel, aşk, kariyer, sağlık; açılar ve gezegen geçişleri (ücretli paket, 2 birim); parametreler: `burc`, `tur`, `tarih`, `dil`, `ayrinti` - `GET /v1/burc/burclar` — 12 burç: tarih aralığı, element, nitelik, yönetici gezegen (tüm paketler, 1 birim) - `GET /v1/burc/bul` — Doğum tarihinden burç; 12 burcun tarih aralığı, elementi ve yönetici gezegeni (tüm paketler, 1 birim); parametreler: `tarih`* Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/burc/gunluk?burc=koc"` ### Kullanım örnekleri - Haber ve magazin sitelerinde günlük burç sayfası - Mobil uygulamada burç bildirimi - Doğum tarihinden burç gösterimi ### Sık sorulan sorular **Burç yorumları ücretsiz pakette var mı?** Günlük yorum (/v1/burc/gunluk) Başlangıç ve üstü paketlerdedir (2 birim). Burç listesi ve doğum tarihinden burç bulma her pakette açıktır. **Yorumlar Türkçe mi?** Evet; kaynak İngilizce yayımlar, yorumlar yapay zekâ ile Türkçeye çevrilir. ?dil=en özgün metni verir. **Hangi yorum türleri var?** Şu an genel yorum verilir; tur parametresi aşk, kariyer ve sağlık türlerini de destekler, bunlar etkinleştirildiğinde aynı uçtan gelir. **Ne zaman güncellenir?** Her gece bir kez; son 7 günün yorumları tutulur. ## Futbol Puan Durumu API Sayfa: https://veriapi.pro/api/puan-durumu-api Süper Lig'den 3. Lig'e kadar tüm profesyonel liglerin güncel puan tablosu. /v1/spor/puan-durumu her ligin sıralamasını döndürür: oynanan, galibiyet, beraberlik, mağlubiyet, atılan ve yenilen gol, averaj ve puan. 2. Lig'in Beyaz ve Kırmızı grupları ile 3. Lig'in üç grubu ayrı tablolardır; ?lig=2-lig iki grubu birlikte verir. Puan silme cezaları tabloya yansımıştır; puan_duzeltme alanı cezanın büyüklüğünü gösterir. Tablolar her maç gününde maçlar bittikten kısa süre sonra yenilenir. ### Uçlar - `GET /v1/spor/puan-durumu` — Futbol puan durumu: Süper Lig, 1. Lig, 2. Lig ve 3. Lig grupları (ücretli paket, 2 birim); parametreler: `lig` - `GET /v1/spor/ligler` — Desteklenen ligler ve hangi verinin olduğu (ücretli paket, 2 birim) Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/spor/puan-durumu?lig=super-lig"` ### Kullanım örnekleri - Spor haberlerinde puan tablosu - Yerel haber sitesinde şehrin takımının sıralaması - Taraftar uygulamaları ### Sık sorulan sorular **Puan durumu ücretsiz pakette var mı?** Hayır; spor uçları Başlangıç ve üstü paketlerdedir (istek başına 2 birim). **Hangi ligler var?** Süper Lig, 1. Lig, 2. Lig (Beyaz ve Kırmızı grup) ve 3. Lig (1, 2 ve 3. grup). **Puan cezaları dahil mi?** Evet; tablo cezalar düşülmüş puanı gösterir, puan_duzeltme alanı cezayı ayrıca verir. ## Maç Sonuçları API Sayfa: https://veriapi.pro/api/mac-sonuclari-api Süper Lig'den 3. Lig'e maç sonuçları, oynanan maçların skoru ve yarının fikstürü; tek istekte. /v1/spor/maclar ligleri, tarihi, takımı ve durumu (bitti, canli, oynanacak, ertelendi) süzerek maçları döndürür: ev sahibi ve deplasman takımı, skor, ilk yarı skoru, hafta, dakika ve başlama saati; kaynakta varsa stadyum ve hakem. Puan durumu için /v1/spor/puan-durumu kullanılır; iki uç aynı lig kodlarını paylaşır. Maçlar oynanırken skor 15 dakikada bir, biten maçlar bitişten kısa süre sonra yenilenir; anlık (saniye saniye) canlı skor değildir. Kayıtlar 01.11.2026'dan başlar; fikstür en çok bir gün sonrasını kapsar. ### Uçlar - `GET /v1/spor/maclar` — Futbol: Süper Lig – 3. Lig maç sonuçları, canlı skor ve fikstür (ücretli paket, 2 birim); parametreler: `lig`, `tarih`, `baslangic`, `bitis`, `takim`, `durum`, `limit` - `GET /v1/spor/ligler` — Desteklenen ligler ve hangi verinin olduğu (ücretli paket, 2 birim) Örnek: `curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/spor/maclar?lig=super-lig&durum=bitti"` ### Kullanım örnekleri - Spor haberlerinde günün sonuçları - Yerel haber sitesinde şehrin takımının son maçları ve sıradaki maçı - Taraftar uygulamaları ve bildirimler ### Sık sorulan sorular **Maç sonuçları ücretsiz pakette var mı?** Hayır; spor uçları Başlangıç ve üstü paketlerdedir (istek başına 2 birim). **Canlı skor anlık mı?** Hayır; oynanan maçlar 15 dakikada bir güncellenir. Saniye saniye canlı skor sunulmaz. **Geçmiş sezonlar var mı?** Hayır; kayıtlar 01.11.2026'dan itibaren tutulur ve her gün birikir.