openvan — Python client for the OpenVan.camp API

Free vanlife & RV travel data in Python: fuel prices in 160+ countries, toll roads, visa and vehicle-import rules, public and school holidays, travel hazards and wildfires, customs rules, power plugs, weather suitability scores, food cost index, currency rates, events, news and license plates of the world.

No API key, no registration, no dependencies — standard library only, Python 3.9+.

pip install openvan

Quick start

from openvan import OpenVan

ov = OpenVan(source="myapp.com")  # source is optional: it lets us see and credit your project

# Cheapest diesel in the world right now, EUR per liter
for c in ov.fuel.cheapest("diesel", 5):
    print(c["country_name"], c["prices"]["diesel"], c["currency"])

# Can a Russian passport enter Turkey, and for how long?
print(ov.visa.check("RU", "TR")["data"])

# Toll cost Rome → Paris for a van, as a EUR range
print(ov.tolls.route(["Rome", "Paris"], vehicle_class="van"))

# Best countries for vanlife weather today
for c in ov.weather.top(5):
    print(c["code"], c["van_score"], c["score_label"])

# Countries of Europe by the score of the coming week (the site ranking), one city with its place
for c in ov.weather.ranking(region="europe", limit=5):
    print(c["rank"], c["name"], c["week_score"])
print(ov.weather.city("GE", "batumi")["rank"])

# Typical weather (climate) in Batumi on 18 September and the best month to go
batumi = ov.weather.city_climate("GE", "batumi", date="09-18")
print(batumi["day"]["temp_day_c"], batumi["day"]["precipitation_days_of_35"], batumi["best_month"])

# School holidays in Germany this autumn, by federal state
ov.holidays.country("DE", from_="2026-10-01", to="2026-12-31", kind="school")

With pandas

import pandas as pd
from openvan import OpenVan

ov = OpenVan()
fuel = pd.DataFrame.from_dict(ov.fuel.prices(), orient="index")
basket = pd.DataFrame.from_dict(ov.basket.list(), orient="index")

Resources

Methods return the API's JSON as plain dict / list. Field reference: interactive docs · OpenAPI spec.

Errors raise OpenVanError with status, url, body and the API's own message:

from openvan import OpenVan, OpenVanError

try:
    OpenVan().tolls.route(["Atlantis", "Paris"])
except OpenVanError as e:
    print(e.status, e.message)  # 422 and the reason, e.g. no road route

License and attribution

Code: MIT. Data: CC BY 4.0 — credit it as Data: OpenVan.camp with a link to https://openvan.camp/.

Also available: JavaScript SDK · MCP server for AI agents · all API docs.