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
125+ ü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
134 ülke
134 ülke için güncel yakıt fiyatları (benzin, dizel, LPG). 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: 13 Haziran 2026.
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", // "gallon" for US and Ecuador
"prices": {
"gasoline": 2.13,
"diesel": 2.28,
"lpg": 1.11,
"e85": null,
"premium": null
},
"price_changes": { "gasoline": -0.02, "diesel": 0.01, "lpg": 0.0 },
"fetched_at": "2026-03-28T13:59:57+03:00",
"sources": ["Fuelo.net", "EU Weekly Oil Bulletin", "Cargopedia.net"],
"sources_count": 3,
"is_excluded": false // true for heavily subsidized countries
}
},
"meta": { "total_countries": 87, "updated_at": "2026-03-28 13:59:57", "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/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=Nauticampo&locale=ru"
# Event details + linked source articles
curl "https://openvan.camp/api/event/nauticampo-2026?locale=en"
curl "https://openvan.camp/api/event/nauticampo-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=camping&country=DE"
# Full story with all source articles
curl "https://openvan.camp/api/story/vanlife-festival-germany-2026?locale=en"
/api/story/{slug} için örnek yanıt:
{
"slug": "vanlife-festival-germany-2026",
"title": "VanLife Festival Germany 2026",
"summary": "The largest vanlife gathering in Germany returns this summer.",
"image_url": "https://...",
"category": { "slug": "events", "name": "Events" },
"countries": [{ "code": "de", "name": "Germany", "flag_emoji": "🇩🇪" }],
"first_published_at": "2026-04-01T10:00:00+00:00",
"last_updated_at": "2026-04-03T08:00:00+00:00",
"articles_count": 8,
"url": "https://openvan.camp/en/news/events/vanlife-festival-germany-2026",
"sources": [
{
"title": "Germany's biggest van life festival is back",
"original_url": "https://campermag.de/festival-2026",
"source_name": "CamperMag.de",
"published_at": "2026-04-01T10:00:00+00: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"
# }