tabiji API

List all 6,683 destinations with summary data.

{
  "count": 6905,
  "destinations": [
    {
      "slug": "bogota",
      "name": "Bogotá",
      "region": "Colombia",
      "continent": "South America",
      "budget": "$",
      "season": "Dec–Mar",
      "vibes": ["Adventure", "City", "Unfrequented"],
      "photo": "https://img.tabiji.ai/find/img/bogota.webp",
      "pitch": "Graffiti tours, craft coffee, Andean sunsets..."
    },
    ...
  ]
}

Get full details for a single destination. Slug is the city name, lowercased with spaces→hyphens.

{
  "slug": "tokyo",
  "name": "Tokyo",
  "region": "Japan",
  "continent": "Asia",
  "budget": "$$$",
  "season": "Mar–May, Oct–Nov",
  "vibes": ["City", "Cultural", "Family", "Nightlife"],
  "travelStyles": ["solo", "photography"],
  "pitch": "Controlled chaos that somehow works perfectly..."
}

List all picks guides with summary metadata.

{
  "count": 1616,
  "totalPlaces": 15227,
  "picks": [
    {
      "slug": "amsterdam-brunch",
      "title": "12 Best Brunch Spots in Amsterdam 2026",
      "city": "Amsterdam",
      "category": "Brunch Spots",
      "placeCount": 12,
      "url": "https://tabiji.ai/popular-picks/amsterdam-brunch/"
    },
    ...
  ]
}

Full picks guide with all places, ratings, hours, contact info, "what to order," Reddit quotes, and insider tips.

{
  "slug": "amsterdam-brunch",
  "title": "12 Best Brunch Spots in Amsterdam 2026",
  "city": "Amsterdam",
  "category": "Brunch Spots",
  "placeCount": 12,
  "places": [
    {
      "name": "Little Collins",
      "position": 1,
      "cuisineTags": ["Antipodean Brunch"],
      "googleRating": 4.5,
      "reviewCount": 1859,
      "priceRange": "€15–€25/person",
      "address": "De Pijp",
      "googleMapsUrl": "https://maps.google.com/...",
      "openingHours": {
        "Mon": "9:00 AM – 4:00 PM",
        "Tue": "9:00 AM – 4:00 PM",
        ...
      },
      "website": "http://www.littlecollins.nl/",
      "photo": "https://img.tabiji.ai/popular-picks/...",
      "whatToOrder": "The cilbir (Turkish-style poached eggs)...",
      "redditQuotes": [
        {
          "text": "Little Collins was the first to bring...",
          "source": "— r/Amsterdam"
        }
      ],
      "insiderTip": "The undisputed king of Amsterdam brunch..."
    },
    ...
  ]
}

List all itineraries with summary metadata.

{
  "count": 398,
  "itineraries": [
    {
      "slug": "itineraries-5-day-tokyo-food-nightlife",
      "title": "5 Day Tokyo Food & Nightlife Guide (2026)",
      "destination": "Tokyo",
      "duration": "5 days",
      "tripType": ["Food Tourism", "Nightlife"],
      "url": "https://tabiji.ai/itineraries/5-day-tokyo-food-nightlife/",
      "dayCount": 9
    },
    ...
  ]
}

Full itinerary with day-by-day activities, tips, and details.

{
  "slug": "itineraries-5-day-tokyo-food-nightlife",
  "title": "5 Day Tokyo Food & Nightlife Guide (2026)",
  "destination": "Tokyo",
  "duration": "5 days",
  "days": [
    {
      "dayLabel": "Day 1",
      "title": "Tsukiji & Ginza",
      "activities": [
        {
          "time": "☀️ Morning",
          "name": "Tsukiji Outer Market",
          "description": "Start your Tokyo food journey...",
          "tips": ["Arrive before 9am for the best stalls"]
        },
        ...
      ]
    },
    ...
  ]
}

List all destination comparisons.

{
  "count": 1218,
  "comparisons": [
    {
      "slug": "tokyo-vs-kyoto",
      "title": "Tokyo vs Kyoto: Which Should You Visit?",
      "destination1": "Tokyo",
      "destination2": "Kyoto",
      "categoryCount": 10,
      "url": "https://tabiji.ai/compare/tokyo-vs-kyoto/"
    },
    ...
  ]
}

Full comparison with structured categories, quote sources, verdict cards, and FAQs.

{
  "slug": "tokyo-vs-kyoto",
  "title": "Tokyo vs Kyoto: Which Should You Visit?",
  "destination1": "Tokyo",
  "destination2": "Kyoto",
  "categories": [
    {
      "title": "🍜 Food & Dining",
      "summary": "Tokyo wins on sheer range and late-night depth...",
      "redditQuotes": [
        {
          "text": "Tokyo is where you eat everything. Kyoto is where you eat beautifully.",
          "source": "r/JapanTravelTips user"
        }
      ],
      "winnerSummary": {
        "winner": "Tokyo"
      }
    }
  ],
  "verdict": {
    "summary": "Tokyo is better for first-timers and foodies; Kyoto is better for slower culture-heavy trips.",
    "takeaways": ["Choose Tokyo for breadth", "Choose Kyoto for atmosphere"]
  },
  "faqs": [
    {
      "question": "Is Tokyo or Kyoto better for first-timers?",
      "answer": "Tokyo usually makes the easier first base, while Kyoto shines if you want a slower cultural trip."
    }
  ]
}

Cross-collection search across destinations, picks, itineraries, and comparisons. Optional type filter and limit.

{
  "query": "tokyo",
  "type": null,
  "count": 27,
  "items": [
    {
      "type": "destination",
      "slug": "tokyo",
      "title": "Tokyo",
      "url": "https://tabiji.ai/api/v1/destinations/tokyo.json"
    },
    {
      "type": "comparison",
      "slug": "tokyo-vs-kyoto",
      "title": "Tokyo vs Kyoto: Which Should You Visit?",
      "url": "https://tabiji.ai/api/v1/compare/tokyo-vs-kyoto.json"
    }
  ]
}

All 250 countries with facts — capital, population, area, region, borders, currencies, languages, flag, driving side, dial code, and more.

{
  "count": 250,
  "countries": [
    {
      "name": "Japan",
      "iso2": "JP",
      "iso3": "JPN",
      "capital": ["Tokyo"],
      "population": 123210000,
      "region": "Asia",
      "flag": "🇯🇵",
      "currencies": { "JPY": { "name": "Japanese yen", "symbol": "¥" } },
      "drivingSide": "left",
      "dialCode": "+81"
    }
  ]
}

Full facts for a single country. Use lowercase ISO 3166-1 alpha-2 codes (e.g. jp, fr, us, sg).

{
  "id": "country:jp",
  "name": "Japan",
  "officialName": "Japan",
  "iso2": "JP",
  "iso3": "JPN",
  "capital": ["Tokyo"],
  "population": 123210000,
  "area": 377930,
  "region": "Asia",
  "subregion": "Eastern Asia",
  "borders": [],
  "landlocked": false,
  "demonyms": { "male": "Japanese", "female": "Japanese" },
  "startOfWeek": "monday",
  "maps": { "googleMaps": "https://goo.gl/maps/...", "openStreetMaps": "..." },
  "currencies": { "JPY": { "name": "Japanese yen", "symbol": "¥" } },
  "languages": { "jpn": "Japanese" },
  "timezones": ["UTC+09:00"],
  "flag": "🇯🇵",
  "flagSvg": "https://flagcdn.com/jp.svg",
  "flagPng": "https://flagcdn.com/w320/jp.png",
  "drivingSide": "left",
  "dialCode": "+81",
  "tld": [".jp"]
}

Unified catalog spanning destinations and picks with normalized tags, good-for signals, freshness, and provenance.

{
  "version": "1.1.0",
  "generatedAt": "2026-03-19T16:00:00Z",
  "itemCount": 4000,
  "items": [
    {
      "id": "place:tokyo-cheap-eats:1",
      "entityType": "place",
      "name": "Matsuya (松屋)",
      "city": "Tokyo",
      "category": "Cheap Eats",
      "tags": ["food", "late_night"],
      "priceLevel": "$",
      "freshness": {
        "confidence": "mixed",
        "operationalFieldsMayChange": true
      },
      "provenance": {
        "sources": ["tabiji_editorial", "reddit", "google_places"]
      }
    }
  ]
}

Natural-language retrieval over the unified catalog with optional structured filters.

curl -X POST https://tabiji.ai/api/v1/search \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "quiet coffee shop with good wifi in tokyo",
    "location": "Tokyo",
    "entity_types": ["place"],
    "tags": ["remote_work"],
    "limit": 5
  }'

Deterministic hard constraints for city, entity type, budget band, tags, and open-now state.

curl -X POST https://tabiji.ai/api/v1/filter \
  -H 'Content-Type: application/json' \
  -d '{
    "location": "Tokyo",
    "entity_types": ["place"],
    "budget": ["$", "$$"],
    "open_now": true,
    "limit": 10
  }'

Intent-based ranking with short explanations and tradeoffs.

curl -X POST https://tabiji.ai/api/v1/recommend \
  -H 'Content-Type: application/json' \
  -d '{
    "intent": "first_night_dinner",
    "location": "Tokyo",
    "entity_types": ["place"],
    "party": { "traveler_type": "couple" },
    "preferences": {
      "atmosphere": ["local_feeling", "romantic"],
      "avoid": ["touristy"]
    },
    "limit": 5
  }'