Developer Platform

Connect AI to Your Travel Plans

Build AI-powered travel experiences with the Yoteiko API. Create itineraries, search destinations, and plan trips — all from ChatGPT, Claude, Gemini, Copilot, or any AI assistant.

Capabilities

What AI Can Do

Full access to Yoteiko's travel planning platform through a clean, RESTful API.

🗺️

Create Itineraries

AI assistants can build complete day-by-day travel itineraries with destinations, activities, and budgets.

✏️

Modify via Natural Language

Change any part of an itinerary with simple instructions like "add a day in Kyoto" or "set budget to luxury".

🔍

Search Everything

Search destinations, hotels, restaurants, attractions, events, and community itineraries worldwide.

🍴

Fork & Customize

Fork popular community itineraries and customize them with AI assistance for your perfect trip.

📤

Publish & Share

Publish your AI-created itineraries to the community or generate shareable links for travel companions.

🔐

OAuth 2.0 Ready

Enterprise-grade authentication with OAuth 2.0 authorization code flow, compatible with ChatGPT Actions.

Try It

Example Prompts

See what's possible when you connect AI to Yoteiko.

ChatGPT

Plan a 7-day cherry blossom trip to Japan for a couple with a mid-range budget

Creates a complete 7-day itinerary covering Tokyo, Kyoto, and Osaka with cherry blossom viewing spots, restaurants, and hotels.

Claude

Find the best restaurants in Shibuya, Tokyo and add them to my itinerary

Searches Yoteiko for top-rated restaurants in Shibuya and adds them to your existing itinerary.

Gemini

Search for family-friendly attractions in Kyoto

Returns a curated list of family-friendly attractions with ratings, addresses, and coordinates.

Copilot

Fork the most popular Japan itinerary from the community

Forks the highest-rated community itinerary to your account for customization.

Get Started

Quick Start

Get up and running in under 5 minutes.

Step 1: Get Your API Token

Sign in to your Yoteiko account and generate an API access token from your account settings. This token authenticates your AI agent with the Yoteiko API.

Step 2: Make Your First Request

Use the API to search for destinations or create an itinerary. All responses are JSON with consistent structure.

curl -X POST https://api.yoteiko.com/api/ai/itineraries \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Tokyo Adventure",
    "destination": "Tokyo",
    "country": "Japan",
    "totalDays": 5,
    "budget": "mid-range",
    "travelType": "couple"
  }'

Step 3: Connect Your AI Agent

Point your ChatGPT Action, Claude tool, or MCP client to our OpenAPI spec at https://api.yoteiko.com/api/ai/openapi.json and authenticate with your token.

Code

Code Examples

Copy, paste, and start building.

curl
curl -X POST https://api.yoteiko.com/api/ai/itineraries \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Tokyo Adventure",
    "destination": "Tokyo",
    "country": "Japan",
    "totalDays": 5,
    "budget": "mid-range",
    "travelType": "couple"
  }'
python
import requests

response = requests.post(
    "https://api.yoteiko.com/api/ai/itineraries",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json={
        "title": "Tokyo Adventure",
        "destination": "Tokyo",
        "country": "Japan",
        "totalDays": 5,
        "budget": "mid-range",
        "travelType": "couple",
    },
)
print(response.json())
typescript
const response = await fetch(
  "https://api.yoteiko.com/api/ai/itineraries",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer YOUR_TOKEN",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      title: "Tokyo Adventure",
      destination: "Tokyo",
      country: "Japan",
      totalDays: 5,
      budget: "mid-range",
      travelType: "couple",
    }),
  }
);
const data = await response.json();
Plugin

ChatGPT Plugin

Install the Yoteiko plugin in ChatGPT and Codex for natural language trip planning.

13 MCP Tools

The plugin exposes 13 tools to ChatGPT via the Model Context Protocol — 7 itinerary tools and 6 search tools.

  • • Create, modify, get, list, fork, publish, share itineraries
  • • Search destinations, hotels, restaurants, attractions, events
  • • Browse community itineraries for inspiration

Quick Install

Enable developer mode in ChatGPT, then register the MCP server:

https://mcp.yoteiko.com/mcp

OAuth 2.1 authentication triggers automatically when you use write tools.

Security

Authentication

Enterprise-grade authentication for AI agents.

Bearer Token (AI Agents)

The simplest method for server-to-server communication. Include your JWT token in the Authorization header.

Authorization: Bearer YOUR_JWT_TOKEN

OAuth 2.0 (ChatGPT Actions)

For ChatGPT Actions and platforms that require OAuth. Uses the standard authorization code flow.

  1. 1. Redirect user to /api/ai/oauth/authorize
  2. 2. User grants permission
  3. 3. Receive authorization code at redirect_uri
  4. 4. Exchange code for access token at /api/ai/oauth/token
  5. 5. Use access_token in API requests
Integration

ChatGPT Actions Setup

Connect Yoteiko to ChatGPT in minutes.

  1. 1

    Create a Custom GPT

    Go to ChatGPT → Explore GPTs → Create a GPT. Give it a name like “Yoteiko Travel Planner”.

  2. 2

    Add an Action

    In the GPT configuration, go to Actions → Create new action. Click “Import from URL” and paste:

    https://api.yoteiko.com/api/ai/openapi.json
  3. 3

    Configure Authentication

    Select OAuth or API Key authentication. For OAuth, set the authorization URL to /api/ai/oauth/authorize and token URL to /api/ai/oauth/token.

  4. 4

    Test & Publish

    Test the integration by asking your GPT to plan a trip. Once verified, publish for your team or the public.

FAQ

Frequently Asked Questions

Everything you need to know about the Yoteiko AI integration.

What AI platforms does Yoteiko support?+
Yoteiko works with any AI platform that supports OpenAPI 3.1, including ChatGPT Actions, OpenAI Apps, Claude, Google Gemini, Microsoft Copilot, Perplexity, and MCP clients.
How do I connect ChatGPT to Yoteiko?+
Use ChatGPT Actions with our OpenAPI spec URL. Go to ChatGPT → Create a GPT → Actions → Import from URL, then paste https://api.yoteiko.com/api/ai/openapi.json and authenticate with your Yoteiko account.
Is the Yoteiko AI API free to use?+
The AI API is free for Yoteiko users. Rate limits apply: 100 read requests and 30 write requests per minute. Premium users get higher limits.
What can AI assistants do with the Yoteiko API?+
AI assistants can create travel itineraries, modify them using natural language, search for destinations, hotels, restaurants, attractions, and events, fork community itineraries, publish trips, and generate share links.
How does authentication work for AI agents?+
We support OAuth 2.0 authorization code flow for ChatGPT Actions and Bearer token authentication for other AI agents. Web users authenticate via secure httpOnly cookies.
Can I build a custom MCP server for Yoteiko?+
Yes. Our OpenAPI 3.1 spec is fully compatible with MCP (Model Context Protocol) clients. Use the spec to generate tool definitions for any MCP server implementation.

Ready to Build?

Start integrating AI-powered travel planning into your applications today.