{
    "name": "Nomads.com API",
    "purpose": "Help AI assistants and developers find a city to live and work remotely",
    "endpoints": {
        "GET /api/search": "Search. Params: region, country, max_cost_usd, min_internet_mbps, min_safety (0-5), min_temperature_c, max_temperature_c, limit (max 100)",
        "GET /api/top": "The live ranking: top 100 cities by overall score, no filters",
        "GET /api/city/{slug}": "One city by slug",
        "GET /api/meetups": "Upcoming nomad meetups. Params: city (slug), country, days_ahead (1-365), limit. Gives date, venue and how many people are going, never who",
        "GET /api/cities": "The full city list with coordinates and scores, for maps",
        "GET /api/trips": "A member's own trip history. Params: username, key (from https://nomads.com/settings). Private, per-account, no relation to search",
        "DELETE /api/trips": "Remove one of the member's own trips. Params (query or JSON body): username, key, trip_id (from GET /api/trips). Only the owner's trips can be removed",
        "POST /api/trips": "Add a trip to a member's own history. JSON body: username, key, date_start, date_end (YYYY-MM-DD), plus EITHER city_slug (from search_cities/get_city) OR latitude+longitude. Coordinates within 5km of a Nomads.com city snap to it; any other place is stored as-is when city and country names are included - same as the site's own trip editor"
    },
    "limits": "Max 100 results per search, 60 requests/hour per IP, curated fields only. No bulk export.",
    "mcp": "https://nomads.com/mcp",
    "llms_txt": "https://nomads.com/llms.txt"
}