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://www.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://www.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.

See machine-readable pricing (for AI agents) →

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