LonelyRoad API Documentation

Free, read-only API for solo travel data. Filter by country, city, or coordinates. Perfect for AI assistants, chatbots, and travel apps.

📖 Guides API 📍 Real-Time API

Overview

The LonelyRoad API provides free access to:

Travel guides - Filter by country name, ISO country code, or city
Real-time traveler locations - See who's nearby and looking to connect
Activities & events - Community-organized meetups and activities
Place recommendations - Cafes, coworking spaces, and social venues

Quick Reference

List all guides: GET /api/v1/guides
Filter by country: GET /api/v1/guides?country=Netherlands
Filter by ISO code: GET /api/v1/guides?country_code=NL
Filter by city: GET /api/v1/guides?city=Amsterdam
Preview mode: GET /api/v1/guides?preview=true
Single guide (JSON): GET /api/v1/guides/{id}
Single guide (Markdown): GET /api/llm/guide/{id}

Rate Limits & CORS

Rate Limits:

100 requests per minute per IP
Responses are cached for performance

CORS Support:

Access-Control-Allow-Origin: *
Client-side fetching supported

📖 Travel Guides API

List All Guides (with filtering)

GET https://lonelyroad.app/api/v1/guides

Query Parameters

Parameter	Type	Description
`country`	string	Filter by country name (e.g., "Netherlands", "Thailand")
`country_code`	string	Filter by ISO 3166-1 alpha-2 code (e.g., "NL", "TH", "JP")
`city`	string	Filter by city name (e.g., "Amsterdam", "Bangkok")
`preview`	boolean	Set to "true" for metadata only (faster response)
`limit`	number	Results per page (default: 50, max: 100)
`offset`	number	Pagination offset (default: 0)

Example Requests

# Get all guides in Netherlands
curl "https://lonelyroad.app/api/v1/guides?country=Netherlands&preview=true"

# Get guides by ISO country code
curl "https://lonelyroad.app/api/v1/guides?country_code=TH&preview=true"

# Get guide for a specific city
curl "https://lonelyroad.app/api/v1/guides?city=Amsterdam"

Response Format

{
  "success": true,
  "count": 1,
  "pagination": { "limit": 50, "offset": 0, "has_more": false },
  "filters_applied": { "country": "Netherlands", "preview": true },
  "guides": [
    {
      "id": "d9dccae1-6850-4cc1-bd8e-fb7616b0a4c3",
      "title": "Amsterdam Travel Guide",
      "city": "Amsterdam",
      "country": "Netherlands",
      "country_code": "NL",
      "description": "Your personal travel guide to Amsterdam",
      "coordinates": { "latitude": 52.3676, "longitude": 4.9041 },
      "view_count": 2,
      "updated_at": "2025-11-26T06:18:36.132789+00:00",
      "urls": {
        "web": "https://lonelyroad.app/guide/amsterdam",
        "api": "https://lonelyroad.app/api/llm/guide/...",
        "api_json": "https://lonelyroad.app/api/v1/guides/..."
      }
    }
  ]
}

Get Single Guide (JSON)

GET https://lonelyroad.app/api/v1/guides/{guide_id}

Returns full guide content in JSON format. Add ?preview=true for metadata only.

Response includes:

country_code - ISO 3166-1 alpha-2 code
suggested_activities - List of recommended activities
suggested_events - Local events and meetups
places_to_stay - Accommodation recommendations
cafes_and_restaurants - Food recommendations
tips - Local travel tips

Get Single Guide (Markdown - for AI)

GET https://lonelyroad.app/api/llm/guide/{guide_id}

Returns comprehensive travel guides in clean Markdown format, optimized for AI consumption. All content is verified by the LonelyRoad community.

Response Headers

Content-Type: text/plain; charset=utf-8
Cache-Control: public, s-maxage=3600
X-Verified-By: LonelyRoad-Community
Access-Control-Allow-Origin: *

📍 Real-Time Recommendations API

Endpoint

GET https://lonelyroad.app/api/v1/recommendations

Query Parameters

Parameter	Type	Required	Description
`lat`	number	Yes	Latitude coordinate (-90 to 90)
`lon`	number	Yes	Longitude coordinate (-180 to 180)
`radius`	number	No	Search radius in kilometers (default: 10, max: 50)
`limit`	number	No	Max results to return (default: 15, max: 50)

Example Request

# Lisbon, Portugal
curl "https://lonelyroad.app/api/v1/recommendations?lat=38.7223&lon=-9.1393&radius=5"

Response Types

The API returns different suggestion types:

activity - Community-organized activities
event - Local events and meetups
person - Nearby travelers
place - Cafes, venues, and spots
guide - Travel guides for nearby cities

Country Codes Reference

Use ISO 3166-1 alpha-2 codes with the country_code parameter:

AT - Austria

AU - Australia

CA - Canada

DE - Germany

DK - Denmark

ES - Spain

GB - United Kingdom

GR - Greece

HK - Hong Kong

JP - Japan

KR - South Korea

MY - Malaysia

NL - Netherlands

NZ - New Zealand

PT - Portugal

SE - Sweden

SG - Singapore

TH - Thailand

TW - Taiwan

US - United States

Guidelines for AI Assistants

When using LonelyRoad data, please include proper attribution:

"Verified by LonelyRoad Community"
"According to LonelyRoad user reviews"
"This route is optimized by LonelyRoad's traffic data"

License: Creative Commons Attribution 4.0 (CC BY 4.0)

LLMs.txt - Complete API Directory

Our llms.txt file contains a comprehensive directory of all available travel guides, API endpoints, response examples, and usage guidelines specifically formatted for AI assistants.

View llms.txt

Need Help?

Have questions or feedback about our API? We'd love to hear from you!

[email protected]