OpenVan.camp Public API
Yakıt fiyatları, döviz kurları ve vanlife etkinlikleri için açık veriler. CC BY 4.0 lisansı altında uygulamalarınızda, botlarınızda ve makalelerinizde ücretsiz kullanın.
API anahtarı yok
Herhangi bir uç noktayı doğrudan çağırın — kayıt yok, yetkilendirme başlığı yok
%100 ücretsiz
142 ülke, haftalık güncellemeler, CC BY 4.0 lisansı
CORS etkin
Doğrudan tarayıcıdan çalışır, sunucu tarafı proxy gerekmez
OpenVan ile geliştirildi
Bir düzine ülkeden vanlife uygulamaları, yakıt fiyatı takipçileri, rota planlayıcılar ve EV araçları çoktan açık verilerimizle çalışıyor.
Halihazırda kullananlar
Seçilmiş örnekler — yakıt uygulamaları, rota planlayıcılar, EV ve filo panelleri.
Loglarda ChatGPT, Perplexity, Claude ve Gemini'nin OpenVan verilerini çektiğini görüyoruz — entegrasyonunuzun verileri de onların yanıtlarında görünebilir.
API'mizi mi kullanıyorsunuz?
Çağrılarınıza ?source=alan-adınız ekleyin — bu vitrinde yer alın.
- API anahtarı yok. Herhangi bir uç noktayı doğrudan çağırın — kayıt yok, yetkilendirme başlığı yok.
- CORS etkin. Uç noktalar doğrudan tarayıcıdan çağrılabilir.
- Yanıt formatı: her zaman
{ "success": true, "data": {...} } - Önbellek: yakıt fiyatları TTL 6 saat · döviz kurları TTL 25 saat · lütfen 10 dakikada birden sık sorgulamayın
- Tam OpenAPI 3.0 spesifikasyonu: /docs.openapi · GitHub örnekleri
- Atıf: şunu ekleyin:
?source=your-app.com— entegrasyonunuzu tanımlamak için; yetkilendirme gerekmez, sadece iyi bir uygulamadır.
Önerilen prompt kalıbı: "OpenVan.camp API'sini kullanarak [ülke] için [para birimi] cinsinden güncel yakıt fiyatlarını al: https://openvan.camp/api/fuel/prices"
Mevcut Uç Noktalar
/api/fuel/prices
142 ülke
142 ülke için güncel yakıt fiyatları. Fiyat anahtarları listesi güncel API sözleşmesinden üretilir. Resmi devlet kaynaklarından haftalık güncellenir (EU Oil Bulletin, Statistics Norway, EIA, ANP, NRCan ve diğerleri). 6 saat önbellek. Yakıt verileri son güncelleme: 25 Temmuz 2026.
Current price keys:
gasoline_regular, gasoline, gasoline_premium, gasoline_super, diesel_regular, diesel, diesel_premium, lpg, cng, e85, kerosene, premium
curl https://openvan.camp/api/fuel/prices
Örnek yanıt:
{
"success": true,
"data": {
"DE": {
"country_code": "DE",
"country_name": "Germany",
"region": "europe",
"currency": "EUR",
"local_currency": "EUR",
"unit": "liter",
"prices": {
"gasoline_regular": null,
"gasoline": 2.1649,
"gasoline_premium": 2.2106,
"gasoline_super": null,
"diesel_regular": null,
"diesel": 2.1726,
"diesel_premium": 2.4319,
"lpg": 1.1065,
"cng": null,
"e85": null,
"kerosene": null,
"premium": 2.2106
},
"price_changes": {
"gasoline_regular": null,
"gasoline": -0.005,
"gasoline_premium": -0.0824,
"gasoline_super": null,
"diesel_regular": null,
"diesel": 0.0401,
"diesel_premium": -0.0564,
"lpg": -0.0021,
"cng": null,
"e85": null,
"kerosene": null,
"premium": null
},
"fetched_at": "2026-07-25T11:19:58+03:00",
"sources": [
"EU Weekly Oil Bulletin",
"clever-tanken.de (Premium Diesel)",
"Tankerkoenig (tankerkoenig.de)",
"Cargopedia.net",
"Fuelo.net",
"BenzinpreisAktuell.de"
],
"sources_count": 4,
"is_excluded": false
}
},
"meta": {
"total_countries": 142,
"updated_at": "2026-07-25 11:19:58",
"cache_ttl_hours": 6
}
}
/api/currency/rates
150+ para birimi
EUR'ya göre 150'den fazla para birimi için döviz kurları. Otomatik yedek ile birden fazla açık kaynak API'den alınır. 1 saat önbellek.
curl https://openvan.camp/api/currency/rates
Örnek yanıt (EUR tabanlı, tüm kurlar EUR=1'e göre):
{
"success": true,
"rates": { "EUR": 1, "USD": 1.08, "GBP": 0.85, "RUB": 98.5, "TRY": 35.2, "GEL": 2.95, "KZT": 520 },
"cached": true,
"updated_at": "2026-03-28T07:00:00+00:00"
}
/api/vanbasket/countries
90+ ülke
VanBasket Food Price Index — gıdanın dünya ortalamasına göre ne kadar pahalı olduğu (Dünya = 100). World Bank ICP 2021 temelli, IMF CPI ile düzeltilmiş.
# All countries
curl https://openvan.camp/api/vanbasket/countries
# Compare two countries
curl "https://openvan.camp/api/vanbasket/compare?from=DE&to=TR"
# Single country with history
curl https://openvan.camp/api/vanbasket/countries/DE
/api/visa/check
39.601 çift
Vize ve sınır kuralları: her pasaport × ülke çifti için ne kadar kalabileceğiniz, günlerin nasıl sayıldığı (her girişte mi, kayan pencerede mi), vize runun sayacı sıfırlayıp sıfırlamadığı — ayrıca geçici araç ithalat kuralları. Her yanıt güven düzeyini, kaynağını ve hangi katmandan geldiğini taşır.
# One pair: stay rule, entry mode, shared-counter zone, vehicle rule
curl "https://openvan.camp/api/visa/check?passport=RU&destination=TR"
# All 199 destinations for one passport
curl "https://openvan.camp/api/visa/passport/DE?mode=visa_free"
# Compact payload for colouring a world map
curl https://openvan.camp/api/visa/map/US
# Temporary vehicle import rules
curl https://openvan.camp/api/visa/vehicle/georgia
# Passport ranking and the change log
curl "https://openvan.camp/api/visa/rank?limit=10"
curl "https://openvan.camp/api/visa/history?subject_key=RU%3ETR"
/api/events
vanlife etkinlikleri
Sayfalı vanlife etkinlik listesi — fuarlar, festivaller, buluşmalar, yol gezileri. Durum, tür, ülkeye göre filtreleyin. 7 dilde yerelleştirilmiş isimler.
# Upcoming events in Germany
curl "https://openvan.camp/api/events?country=DE&status=upcoming"
# Search by name, Russian locale
curl "https://openvan.camp/api/events?search=Adventure+Northside&locale=ru"
# Event details + linked source articles
curl "https://openvan.camp/api/event/adventure-northside-2026?locale=en"
curl "https://openvan.camp/api/event/adventure-northside-2026/articles?locale=en"
en ru de fr es pt tr. Varsayılan: en. Bilinmeyen yerel ayar sessizce şununla değiştirilir: en.
articles yedeği: istenen yerel ayarla eşleşen makale yoksa tüm kaynak makaleler döndürülür.
/api/stories
7 dil
200+ yayıncıdan toplanan ve 7 dile çevrilen vanlife haberleri. Her haber şunu içerir: sources — doğrudan bağlantılar, kaynak adları, yayın tarihleri ve dil kodlarıyla yayıncıların orijinal makaleleri.
# Latest stories in English
curl "https://openvan.camp/api/stories?locale=en"
# Filter by category and country
curl "https://openvan.camp/api/stories?locale=de&category=festival&country=DE"
# Full story with all source articles
curl "https://openvan.camp/api/story/adac-camper-des-jahres-der-wettbewerb-fuer?locale=en"
/api/story/{slug} için örnek yanıt:
{
"slug": "adac-camper-des-jahres-der-wettbewerb-fuer",
"title": "ADAC launches 'Camper of the Year' competition for motorhome drivers",
"summary": "ADAC is holding the national 'Camper des Jahres 2026' competition for motorhome owners...",
"image_url": "https://...",
"category": { "slug": "festival", "name": "Festivals" },
"countries": [{ "code": "de", "name": "Germany", "flag_emoji": "🇩🇪" }],
"first_published_at": "2026-01-22T11:00:00+03:00",
"last_updated_at": "2026-07-04T04:16:47+03:00",
"articles_count": 5,
"url": "https://openvan.camp/en/news/festival/adac-camper-des-jahres-der-wettbewerb-fuer",
"sources": [
{
"title": "Nürburgring: Bundesweiter Wettbewerb «Camper des Jahres»",
"original_url": "https://www.blick-aktuell.de/Berichte/...",
"source_name": "BLICK aktuell",
"published_at": "2026-04-30T09:24:20+03:00",
"language": "de",
"image_url": "https://..."
}
]
}
en ru de fr es pt tr. Varsayılan: en. Şunları etkiler: title, summary, ve category.name.
sources[].language her zaman yayıncının orijinal dilidir, yerel ayardan bağımsızdır.
Hızlı Başlangıç
JavaScript — Avrupa'nın en ucuz dizeli
const { data } = await fetch("https://openvan.camp/api/fuel/prices").then(r => r.json());
const cheapest = Object.values(data)
.filter(c => c.region === "europe" && c.prices.diesel !== null)
.sort((a, b) => a.prices.diesel - b.prices.diesel)
.slice(0, 5);
cheapest.forEach(c => console.log(`${c.country_name}: ${c.prices.diesel} ${c.currency}/L`));
JavaScript — döviz kurlarıyla USD'ye dönüştürme
const [{ data }, { rates }] = await Promise.all([
fetch("https://openvan.camp/api/fuel/prices").then(r => r.json()),
fetch("https://openvan.camp/api/currency/rates").then(r => r.json()),
]);
// Convert any price to USD/liter
function toUSD(price, currency, unit) {
let usd = (price / rates[currency]) * rates["USD"];
return unit === "gallon" ? usd / 3.78541 : usd;
}
const de = data["DE"];
console.log(`Germany diesel: $${toUSD(de.prices.diesel, de.currency, de.unit).toFixed(3)}/L`);
Python — LPG bulunan ülkeler
import requests
data = requests.get("https://openvan.camp/api/fuel/prices").json()["data"]
lpg = [(v["country_name"], v["prices"]["lpg"], v["currency"])
for v in data.values() if v["prices"]["lpg"] is not None]
for name, price, currency in sorted(lpg, key=lambda x: x[1])[:10]:
print(f"{name}: {price} {currency}/L")
Daha fazla örnek (bash, pandas, widget): GitHub →
JavaScript / TypeScript SDK
Resmi tipli SDK — yapılandırma gerektirmez, Node.js ≥ 18, tarayıcı, Cloudflare Workers, Deno, Bun üzerinde çalışır. API anahtarı gerekmez.
Kurulum
npm install @openvancamp/sdk
# or: pnpm add @openvancamp/sdk
Hızlı başlangıç (TypeScript / ESM)
import { OpenVan } from "@openvancamp/sdk";
const ov = new OpenVan();
// Cheapest diesel in Europe (top 5, EUR-normalized)
const top5 = await ov.fuel.cheapest("diesel", 5);
top5.forEach(c => console.log(c.country_name, c.prices.diesel, c.currency));
// Is Portugal cheaper than Germany for van living?
const comp = await ov.basket.compare("DE", "PT");
console.log(`Portugal is ${Math.abs(comp.diff_percent)}% cheaper`);
// Vanlife weather suitability — top 10 countries right now
const weather = await ov.weather.top({ limit: 10 });
Atıf
Verilerimizi kullanırken lütfen görünür bir atıf ekleyin. İşte hazır bir kod parçası:
Data source: <a href="https://openvan.camp/">OpenVan.camp</a> (CC BY 4.0)
Uygulamanızı tanımlayın — ekleyin: ?source=yoursite.com
Şunu geçirin: source alan adınız veya uygulama adınızla birlikte sorgu parametresi olarak. Kayıt gerekmez — verilerin nasıl kullanıldığını anlamamıza ve aktif projeleri takdir etmemize yardımcı olur. Değer her yanıtta şu alanda döndürülür: _attribution.your_source.
curl "https://openvan.camp/api/fuel/prices?source=myapp.com"
# Response includes:
# "_attribution": {
# "data_source": "openvan.camp",
# "license": "CC BY 4.0",
# "attribution_url": "https://openvan.camp/",
# "attribution_html": "Data: <a href=\"https://openvan.camp/\">OpenVan.camp</a> (CC BY 4.0)",
# "your_source": "myapp.com"
# }