The Wanderlust API · v1

Travel data that ships.

10,000+ cities. 250+ countries. Safety, cost, internet, rankings. One key. One JSON response. The same data that powers wanderlustapp.io — now available for your app, your AI agent, your spreadsheet.

Get a free API keyRead the docs →

Free tier · No credit card · Rate-limited, not bait-and-switch

GET /v1/countries/portugal
{
  "object": "country",
  "data": {
    "@id": "https://wanderlustapp.io/api/public/v1/countries/portugal",
    "slug": "portugal",
    "name": "Portugal",
    "official_name": "Portuguese Republic",
    "alpha2_code": "PT",
    "alpha3_code": "PRT",
    "continent": "Europe",
    "region": "Southern Europe",
    "capital": "Lisbon",
    "population": 10300000,
    "area_sq_km": 92090,
    "currency": "EUR",
    "languages": ["Portuguese"],
    "timezones": ["UTC", "UTC-01:00"],
    "calling_code": "+351",
    "emoji": "🇵🇹"
  }
}

Live data. Try it now ↓

Get going · 60 seconds

Your first request.

See full reference

Step 01

Sign up

Hit /developers/signup. Your first team + key are created on the spot.

Step 02

Set a header

Send Authorization: Bearer wl_live_… on every request.

Step 03

Call any endpoint

That's the whole on-boarding. Welcome aboard.

terminalbash
curl https://wanderlustapp.io/api/public/v1/search?q=lisbon \
  -H "Authorization: Bearer $WL_API_KEY"

What you get

A travel API that's actually pleasant to integrate.

Cities, scored

Overall, safety, cost, leisure, internet, and air-quality scores for 10,000+ cities — the same data that powers wanderlustapp.io.

Countries, complete

Capitals, currencies, languages, calling codes, ISO codes, regions, borders, and timezones — for every nation on earth.

Search you can ship

Sub-100ms search across cities and countries. Wire it into your autocomplete in an afternoon.

Teams, first-class

Organizations with owner/admin/developer/viewer roles, email invites, team-owned keys, and a shared usage dashboard.

Built for AI agents

Stable canonical @ids and quote-ready summary sentences so retrievers cache cleanly and agents cite correctly.

Honest rate limits

Per-key, per-minute. We tell you the limit, what's left, and when it resets — every single response.

Versioned forever

Everything lives under /v1. We add — we don't break. Breaking changes ship as /v2 or never.

Usage you can see

Per-day request and error charts, per-key breakdowns, success rate — all in your team dashboard.

For teams

Invite your team in under a minute.

Create an organization, invite teammates by email, and share API keys without sharing passwords. Every member gets a role that fits — from full-access owner to read-only viewer.

  • Role-based access control
  • Email invitations with 14-day expiry
  • Team-owned API keys
  • Shared 30-day usage dashboard
  • Revoke keys when teammates leave
  • Per-key request & error breakdowns
Create a teamRoles & permissions →

Acme Inc

Members · 4

Pro plan
  • ML

    Maya Lindgren

    maya@acme.io

    owner
  • JK

    Jaehyun Kim

    jae@acme.io

    admin
  • NS

    Noor Saleh

    noor@acme.io

    developer
  • RB

    Ravi Bhatt

    ravi@acme.io

    viewer
+ 1 pending invite · sara@acme.io · viewer

Who's building on it

Travel data, in any shape.

Travel apps

Drop our city database into your itinerary planner or trip-tracker.

AI agents

Ground LLM responses with citable, dated travel facts.

Newsrooms

Pull country statistics and city rankings for editorial pieces.

Relocation tools

Power 'where should I move?' calculators with real cost and safety data.

Pricing

Start free, grow up cleanly.

01 / Free

Free

Everything you need to prototype an integration. No credit card. No clock.

$0/ month
  • 30 requests / minute
  • 10,000 requests / month
  • All read endpoints
  • Personal + team workspaces
  • Community support
Get a free key

02 / Pro

Pro

For production apps that need real headroom and the higher-quality city scoring data.

$29/ month
  • 120 requests / minute
  • 250,000 requests / month
  • Unlimited team members
  • Higher freshness on city refresh
  • Email support, 1 business day
Start with Pro

03 / Business

Business

Volume tier for travel platforms, AI agents, and embedded experiences.

Custom
  • 600+ requests / minute
  • 5M+ requests / month
  • SSO + audit log (on request)
  • SLA & priority support
  • Bulk export & webhooks (early access)
Talk to sales

All plans include all read endpoints. Limits enforced per minute, per key.

Frequently asked

The short answers.

How do teams work?

Create an organization, invite teammates by email, and assign roles (owner, admin, developer, viewer). Team-owned API keys are shared across the org and inherit the team's plan, so an admin upgrade lifts every key.

Is the free tier rate-limited into uselessness?

No. 30 req/min × 60 × 24 = 43,200 requests in a day, and you get 10,000 a month. Plenty for prototypes, side projects, and small apps.

Can I use it from the browser?

Yes — CORS is open. But never embed your live key in a public client. Proxy through your backend, or use restricted scopes when those land.

Do you commit to backwards compatibility?

Yes. v1 endpoints are additive-only. We will never remove a field or change its type within v1. Breaking changes ship as v2.

How fresh is the data?

City scores refresh on a rolling schedule; recently-requested cities are re-checked in the background. Country reference data is reviewed quarterly.

Can I redistribute the data?

You can build products on top of it. You can't republish the bulk dataset as a competing API. See the Terms for the precise wording.

What about webhooks and write endpoints?

On the roadmap — early access via the Business plan. Tell us what you need on the contact page.

The whole world, one curl away

Start building. It's free.

Generate a key, paste it into your editor, and ship the integration this afternoon.

Get my API keyRead the docs