Sıfır Araç Fiyatları API
ÖTV matrah dilimleri; marka liste fiyatı anlaşma sonrası
Genel bakış
Sıfır Araç Fiyatları API’nin yasal çekirdeği Resmi Gazete’deki ÖTV matrah dilimleri ve tarife değişiklikleridir. Marka–model anahtar teslim liste fiyatı, distribütör veya ODMD protokolü olmadan yayımlanmaz; üretici sitelerinden kazıma yapılmaz.
Uç noktalar
Temel adres: https://api.apibir.com/v1
Kimlik doğrulama
Tüm isteklerde API anahtarınızı Authorization başlığında gönderin:
Authorization: apikey APIBIR-8f2c4b7e9a1d3c5f7b2e9d41
Accept: application/jsonSorgu parametreleri
| Parametre | Tip | Durum | Açıklama |
|---|---|---|---|
| brand | string | opsiyonel | Marka. Örn: toyota |
| model | string | opsiyonel | Model. Örn: corolla |
| fuel | string | opsiyonel | benzin, dizel, hibrit, elektrik |
| bodyType | string | opsiyonel | sedan, hatchback, suv, ticari |
| maxPrice | number | opsiyonel | Üst fiyat sınırı (TL) |
| sort | string | opsiyonel | price_asc, price_desc, updated |
Örnek istek
curl --request GET \
--url "https://api.apibir.com/v1/vehicles/new/prices?brand=toyota" \
--header "authorization: apikey APIBIR-8f2c...9d41" \
--header "content-type: application/json"package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.apibir.com/v1/vehicles/new/prices?brand=toyota", nil)
req.Header.Add("authorization", "apikey APIBIR-8f2c...9d41")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}const https = require('https');
const options = {
hostname: 'api.apibir.com',
path: '/v1/vehicles/new/prices?brand=toyota',
method: 'GET',
headers: { 'authorization': 'apikey APIBIR-8f2c...9d41' }
};
https.get(options, (res) => {
let data = '';
res.on('data', (chunk) => data += chunk);
res.on('end', () => console.log(JSON.parse(data)));
});const res = await fetch(
"https://api.apibir.com/v1/vehicles/new/prices?brand=toyota",
{ headers: { authorization: "apikey APIBIR-8f2c...9d41" } }
);
const { data } = await res.json();
console.log(data);import java.net.http.*;
import java.net.URI;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.apibir.com/v1/vehicles/new/prices?brand=toyota"))
.header("authorization", "apikey APIBIR-8f2c...9d41")
.GET().build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());import requests
r = requests.get(
"https://api.apibir.com/v1/vehicles/new/prices?brand=toyota",
headers={"authorization": "apikey APIBIR-8f2c...9d41"},
timeout=10,
)
print(r.json()["data"])require 'net/http'
require 'uri'
uri = URI.parse("https://api.apibir.com/v1/vehicles/new/prices?brand=toyota")
request = Net::HTTP::Get.new(uri)
request["authorization"] = "apikey APIBIR-8f2c...9d41"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts response.bodyusing var client = new HttpClient();
client.DefaultRequestHeaders.Add("authorization", "apikey APIBIR-8f2c...9d41");
var json = await client.GetStringAsync("https://api.apibir.com/v1/vehicles/new/prices?brand=toyota");
Console.WriteLine(json);import Foundation
var request = URLRequest(url: URL(string: "https://api.apibir.com/v1/vehicles/new/prices?brand=toyota")!)
request.addValue("apikey APIBIR-8f2c...9d41", forHTTPHeaderField: "authorization")
let task = URLSession.shared.dataTask(with: request) { data, _, _ in
if let data = data, let str = String(data: data, encoding: .utf8) {
print(str)
}
}
task.resume()open Cohttp_lwt_unix
open Lwt
let uri = Uri.of_string "https://api.apibir.com/v1/vehicles/new/prices?brand=toyota" in
let headers = Header.init_with "authorization" "apikey APIBIR-8f2c...9d41" in
Client.get ~headers uri >>= fun (resp, body) ->
Cohttp_lwt.Body.to_string body >>= fun body_str ->
Lwt_io.printl body_str<?php
$ch = curl_init("https://api.apibir.com/v1/vehicles/new/prices?brand=toyota");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["authorization: apikey APIBIR-8f2c...9d41"]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($data["data"]);Örnek yanıt
{
"success": true,
"creditsUsed": 1,
"currency": "TRY",
"updatedAt": "2026-08-07T08:00:00+03:00",
"total": 3,
"data": [
{
"brand": "Toyota",
"model": "Corolla",
"trim": "1.8 Hybrid Dream e-CVT",
"modelYear": 2026,
"bodyType": "sedan",
"fuel": "hibrit",
"transmission": "e-CVT",
"engineCc": 1798,
"power": 140,
"listPrice": 2189000,
"previousPrice": 2124000,
"changePercent": 3.06,
"priceBreakdown": {
"baseWithoutTax": 1094500,
"otvRate": 45,
"otvAmount": 492525,
"kdvRate": 20,
"kdvAmount": 364855,
"mtvFirstYear": 37095
},
"campaign": "36 ay %0 faizli 500.000 TL kredi",
"availability": "stokta",
"effectiveDate": "2026-08-01"
}
]
}Yanıt alanları
| Alan | Tip | Açıklama |
|---|---|---|
| trim | string | Donanım paketi adı |
| listPrice | number | Anahtar teslim liste fiyatı (TL) |
| priceBreakdown | object | Vergi öncesi bedel, ÖTV, KDV ve MTV kırılımı |
| campaign | string | Varsa aktif kampanya metni |
| availability | string | stokta · siparise-acik · uretim-durdu |
Kredi tüketimi: Bu servis her başarılı istek için 1 kredi harcar.
Hatalı istekler (4xx) kredi düşürmez. Kalan krediniz her yanıtın creditsRemaining alanında döner.
Olası hatalar
| Kod | HTTP | Anlamı |
|---|---|---|
| invalid_api_key | 401 | Anahtar geçersiz veya başlık eksik. |
| insufficient_credits | 402 | Aylık kredi limitiniz doldu. |
| invalid_parameter | 422 | Parametre değeri beklenen formatta değil. |
| rate_limited | 429 | Saniyelik istek limiti aşıldı. |
| no_data | 404 | Sorgu kriterlerine uyan kayıt bulunamadı. |
Bu API ile neler yapabilirsiniz?
Otomotiv ilan siteleri
Sıfır araç kataloğunuzu ve fiyat karşılaştırma sayfalarınızı otomatik güncelleyin.
Filo kiralama fiyatlandırması
Araç alım maliyeti değiştikçe kiralama tarifelerini yeniden hesaplayın.
Sigorta ve kasko
Kasko bedeli hesabında sıfır araç liste fiyatını referans alın.
Zam takip bültenleri
Model bazında fiyat artışı olduğunda abonelere bildirim gönderin.
AI ile hızlı başlangıç. Bu API'yi Claude'a tanıtıp tek promptla pano kurmak için AI & Dashboard rehberine bakın. Hazır prompt şablonu ve çalışan dashboard örneği orada.
İlgili API'ler
Akaryakıt Fiyatları
Türkiye VerileriEPDK il bazlı bayi ve tavan fiyatları: benzin, motorin ve LPG.
Resmi Gazete & Mevzuat
Mevzuat & KamuGünlük Resmi Gazete kararları, kanun değişiklikleri ve AI destekli mevzuat özetleri.
Döviz Kurları
Finans & PiyasaTCMB resmi günlük alış/satış kurları (EVDS ve kur bülteni). Muhasebe ve fatura değerlemesi için.
Otomotiv & Galeri Otomasyonu Teklifi Alın
Her sabah markaların sıfır km fiyat değişikliklerini, zam/indirim oranlarını WhatsApp veya E-posta ile almak için teklif isteyin.