# tabiji.ai

> Free AI-curated travel data API — Reddit-sourced restaurant picks, day-by-day itineraries, destination guides, and trending travel data for 6498 destinations. No API key required.

## API Documentation
- [API Docs](https://tabiji.ai/api/): Full endpoint documentation with examples
- [OpenAPI Spec](https://tabiji.ai/api/openapi.json): Machine-readable API specification (OpenAPI 3.1)
- [agents.json](https://tabiji.ai/.well-known/agents.json): AI agent workflow definitions

## Endpoints

### Destinations
- [All Destinations](https://tabiji.ai/api/v1/destinations.json): 6498 destinations with budget, season, vibes, travel styles, and pitch
- [Single Destination](https://tabiji.ai/api/v1/destinations/{slug}.json): Full details for one destination (e.g., `tokyo.json`, `paris.json`)

### Popular Picks (Restaurant & Attraction Guides)
- [All Picks](https://tabiji.ai/api/v1/picks.json): 876 curated "best of" guides covering 9,407 places, each linking to its canonical HTML page
- Single Picks Guide (HTML canonical): `https://tabiji.ai/popular-picks/{slug}/` — full guide with all places, editorial summaries, Reddit quotes, and insider tips (e.g., `amsterdam-brunch`, `tokyo-ramen`). Per-slug JSON was retired on 2026-04-20.

### Itineraries
- [All Itineraries](https://tabiji.ai/api/v1/itineraries.json): 399 day-by-day travel itineraries
- [Single Itinerary](https://tabiji.ai/api/v1/itineraries/{slug}.json): Full itinerary with day-by-day activities, times, tips, and logistics

### Comparisons
- [All Comparisons](https://tabiji.ai/api/v1/compare.json): 867 head-to-head destination comparisons, each linking to its canonical HTML page
- Single Comparison (HTML canonical): `https://tabiji.ai/compare/{slug}/` — full comparison with categories, Reddit quotes, verdict, and FAQs (e.g., `tokyo-vs-kyoto`). Per-slug JSON was retired on 2026-04-20.

### Cross-Collection Search
- [Unified Search](https://tabiji.ai/api/v1/search.json?q=tokyo): Search destinations, picks, itineraries, and comparisons from one endpoint (`q`, optional `type`, optional `limit`)

## Data Fields

### Place Object (in Picks)
Each place includes: name, position, tags, googleRating, reviewCount, priceRange, address, area, googleMapsUrl, mapsLinks, openingHours (weekly grid), phone, website, photo, verdict, editorialSummary, bestFor, comparison, whatToOrder, redditQuotes (with source + sourceUrl), insiderTip, sourceMeta

### Itinerary Day Object
Each day includes: dayLabel, neighborhoods, title, description, activities (with time, name, description, details, tips)

### Destination Object
Each destination includes: slug, name, region, continent, budget ($–$$$$), season, vibes (array), travelStyles (array), photo, pitch, editorialSummary, bestFor, relatedPicks, relatedItineraries, relatedComparisons, relatedDestinations, sourceMeta

## What Makes This Data Unique
Unlike generic travel APIs, tabiji data is curated from real traveler discussions plus Tabiji editorial judgment, then cross-linked across destinations, picks, itineraries, and comparisons. Records now expose provenance/freshness metadata and lighter-weight enrichment fields so agents can traverse the graph instead of scraping pages.

## Usage
No authentication required. All endpoints return static JSON files served via Cloudflare CDN. CORS is permissive — call from any origin. Free for non-commercial use.