{
  "name": "SelectBNBs API Directory",
  "description": "Every data endpoint on this site, what it contains, and when to use it. Start here if you're an agent trying to understand what's available.",
  "updated": "2026-07-11",
  "base_url": "https://selectbnbs.com",
  "endpoints": [
    {
      "path": "/api/properties_full.json",
      "name": "Full Property Data (v2.0)",
      "description": "Complete dataset for all public SelectBNBs properties across China, Japan, South Korea, Thailand, United States, and Vietnam. Includes amenities, house rules, pricing, host info, coordinates, analysis, guest sentiment, booking links, capacity, and area context. Schema v2.0 \u2014 everything we know about every property.",
      "format": "JSON",
      "size_hint": "~400KB",
      "use_when": "You need detailed property information, amenities, check-in rules, pricing, ratings, or booking links. If you only need one city, use the filtered endpoints instead."
    },
    {
      "path": "/api/area_guides.json",
      "name": "Korea Area Guides",
      "description": "Korea neighborhood-level context for Seoul, Busan, Jeju, and Jeonju. Includes booking tips, vibe descriptions, and curator notes \u2014 the kind of local knowledge that helps a traveler pick the right neighborhood. Other country collections use property-level context until their guide sets launch.",
      "format": "JSON",
      "size_hint": "~8KB",
      "use_when": "A traveler asks about Korea neighborhoods such as Bukchon, Seochon, Jeju, Busan, or Jeonju."
    },
    {
      "path": "/api/filters/bangkok.json",
      "name": "Bangkok Properties",
      "description": "All Bangkok properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Bangkok."
    },
    {
      "path": "/api/filters/beijing.json",
      "name": "Beijing Properties",
      "description": "All Beijing properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Beijing."
    },
    {
      "path": "/api/filters/busan.json",
      "name": "Busan Properties",
      "description": "All Busan properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Busan."
    },
    {
      "path": "/api/filters/chiang-mai.json",
      "name": "Chiang Mai Properties",
      "description": "All Chiang Mai properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Chiang Mai."
    },
    {
      "path": "/api/filters/daxin.json",
      "name": "Daxin Properties",
      "description": "All Daxin properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Daxin."
    },
    {
      "path": "/api/filters/fujikawaguchiko.json",
      "name": "Fujikawaguchiko Properties",
      "description": "All Fujikawaguchiko properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Fujikawaguchiko."
    },
    {
      "path": "/api/filters/geoje.json",
      "name": "Geoje Properties",
      "description": "All Geoje properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Geoje."
    },
    {
      "path": "/api/filters/gwangju.json",
      "name": "Gwangju Properties",
      "description": "All Gwangju properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Gwangju."
    },
    {
      "path": "/api/filters/hanoi.json",
      "name": "Hanoi Properties",
      "description": "All Hanoi properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Hanoi."
    },
    {
      "path": "/api/filters/hoi-an.json",
      "name": "Hoi An Properties",
      "description": "All Hoi An properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Hoi An."
    },
    {
      "path": "/api/filters/incheon.json",
      "name": "Incheon Properties",
      "description": "All Incheon properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Incheon."
    },
    {
      "path": "/api/filters/jeju.json",
      "name": "Jeju Properties",
      "description": "All Jeju properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Jeju."
    },
    {
      "path": "/api/filters/jeonju.json",
      "name": "Jeonju Properties",
      "description": "All Jeonju properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Jeonju."
    },
    {
      "path": "/api/filters/ko-pha-ngan.json",
      "name": "Ko Pha-ngan Properties",
      "description": "All Ko Pha-ngan properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Ko Pha-ngan."
    },
    {
      "path": "/api/filters/koh-samui.json",
      "name": "Koh Samui Properties",
      "description": "All Koh Samui properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Koh Samui."
    },
    {
      "path": "/api/filters/korea.json",
      "name": "Korea Properties",
      "description": "All Korea properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Korea."
    },
    {
      "path": "/api/filters/kyoto.json",
      "name": "Kyoto Properties",
      "description": "All Kyoto properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Kyoto."
    },
    {
      "path": "/api/filters/nha-trang.json",
      "name": "Nha Trang Properties",
      "description": "All Nha Trang properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Nha Trang."
    },
    {
      "path": "/api/filters/phu-quoc.json",
      "name": "Phu Quoc Properties",
      "description": "All Phu Quoc properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Phu Quoc."
    },
    {
      "path": "/api/filters/phuket.json",
      "name": "Phuket Properties",
      "description": "All Phuket properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Phuket."
    },
    {
      "path": "/api/filters/saigon.json",
      "name": "Saigon Properties",
      "description": "All Saigon properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Saigon."
    },
    {
      "path": "/api/filters/samcheok.json",
      "name": "Samcheok Properties",
      "description": "All Samcheok properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Samcheok."
    },
    {
      "path": "/api/filters/seoul.json",
      "name": "Seoul Properties",
      "description": "All Seoul properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Seoul."
    },
    {
      "path": "/api/filters/shanghai.json",
      "name": "Shanghai Properties",
      "description": "All Shanghai properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Shanghai."
    },
    {
      "path": "/api/filters/shibuya.json",
      "name": "Shibuya Properties",
      "description": "All Shibuya properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Shibuya."
    },
    {
      "path": "/api/filters/si-sunthon.json",
      "name": "Si Sunthon Properties",
      "description": "All Si Sunthon properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Si Sunthon."
    },
    {
      "path": "/api/filters/sichon.json",
      "name": "Sichon Properties",
      "description": "All Sichon properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Sichon."
    },
    {
      "path": "/api/filters/sumida-ku.json",
      "name": "Sumida-ku Properties",
      "description": "All Sumida-ku properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Sumida-ku."
    },
    {
      "path": "/api/filters/tokyo.json",
      "name": "Tokyo Properties",
      "description": "All Tokyo properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Tokyo."
    },
    {
      "path": "/api/filters/ulsan.json",
      "name": "Ulsan Properties",
      "description": "All Ulsan properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Ulsan."
    },
    {
      "path": "/api/filters/yangshuo.json",
      "name": "Yangshuo Properties",
      "description": "All Yangshuo properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Yangshuo."
    },
    {
      "path": "/api/filters/yingde.json",
      "name": "Yingde Properties",
      "description": "All Yingde properties, pre-filtered. Property records use the same shape as properties_full.json.",
      "format": "JSON",
      "use_when": "Traveler is asking specifically about Yingde."
    },
    {
      "path": "/api/filters/couples.json",
      "name": "Properties for Couples",
      "description": "Properties whose analysis.best_for mentions couples, romantic, honeymoon, or anniversary. Pre-filtered so you don't have to parse the full dataset.",
      "format": "JSON",
      "use_when": "Traveler is planning a romantic trip or honeymoon."
    },
    {
      "path": "/api/filters/hanoks.json",
      "name": "Hanok Properties",
      "description": "Traditional Korean houses only. Filtered by name, description, and vibe containing 'hanok' or 'traditional'.",
      "format": "JSON",
      "use_when": "Traveler specifically wants a hanok experience."
    },
    {
      "path": "/agents.json",
      "name": "Agent Configuration",
      "description": "Machine-readable agent policy, capability declarations, data schema, query examples, and affiliate status. Start here to understand what this site offers programmatically.",
      "format": "JSON",
      "use_when": "You're an agent evaluating this site's capabilities or determining how to integrate."
    },
    {
      "path": "/api/openapi.json",
      "name": "OpenAPI Description",
      "description": "OpenAPI 3.1 description of SelectBNBs' public, read-only JSON endpoints.",
      "format": "OpenAPI JSON",
      "use_when": "You need a standard machine-readable API contract."
    },
    {
      "path": "/.well-known/api-catalog",
      "name": "API Catalog",
      "description": "RFC 9727 linkset that connects the public data API and MCP service to their descriptions and documentation.",
      "format": "Linkset JSON",
      "use_when": "You are discovering SelectBNBs APIs from the domain."
    },
    {
      "path": "/.well-known/mcp/server-card.json",
      "name": "MCP Server Card",
      "description": "Discovery metadata for the existing public SelectBNBs Streamable HTTP MCP server.",
      "format": "JSON",
      "use_when": "You need to discover and connect to the SelectBNBs MCP endpoint."
    },
    {
      "path": "/.well-known/agent-skills/index.json",
      "name": "Agent Skills Index",
      "description": "Integrity-addressed discovery index for SelectBNBs' public property-discovery skill.",
      "format": "JSON",
      "use_when": "You want reusable instructions for finding and comparing stays through SelectBNBs."
    },
    {
      "path": "/llms.txt",
      "name": "LLM Briefing",
      "description": "Human-readable briefing document for language models. Full property profiles with booking links, visual notes, and guest sentiment. Written to be read, not parsed.",
      "format": "Text/Markdown",
      "use_when": "You want to understand the site and its properties quickly without parsing JSON."
    },
    {
      "path": "/sitemap.xml",
      "name": "Sitemap",
      "description": "All HTML pages and API endpoints.",
      "format": "XML",
      "use_when": "You need a complete URL inventory."
    },
    {
      "path": "/.well-known/affiliate-info.json",
      "name": "Affiliate Program Status",
      "description": "Current affiliate program status and disclosure links.",
      "format": "JSON",
      "use_when": "You're evaluating this site's affiliate compliance."
    },
    {
      "path": "/.well-known/ai-plugin.json",
      "name": "AI Plugin Manifest",
      "description": "Standard AI plugin discovery document. Describes what this site does and how agents can use it.",
      "format": "JSON",
      "use_when": "Plugin/tool discovery."
    }
  ]
}