Developer Documentation

Get Your API Key

Free tier: 100 requests/hour. No credit card required.

Quick Start

cURL

curl -X POST https://tripapi.dev/api/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "destination": "Da Nang",
    "check_in": "2026-05-01",
    "check_out": "2026-05-03",
    "guests": 2
  }'

Python

import httpx

resp = httpx.post("https://tripapi.dev/api/search", json={
    "destination": "Da Nang",
    "check_in": "2026-05-01",
    "check_out": "2026-05-03",
    "guests": 2,
}, headers={"X-API-Key": "YOUR_KEY"})

hotels = resp.json()["hotels"]
for h in hotels:
    print(f'{h["name"]} — ${h["nightly_price_usd"]}/night')

JavaScript

const res = await fetch("https://tripapi.dev/api/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_KEY",
  },
  body: JSON.stringify({
    destination: "Da Nang",
    check_in: "2026-05-01",
    check_out: "2026-05-03",
    guests: 2,
  }),
});
const { hotels } = await res.json();
hotels.forEach(h => console.log(`${h.name} — $${h.nightly_price_usd}/night`));

Authentication

Pass your API key in one of two ways:

Rate limits are returned in response headers: X-RateLimit-Limit.

Plans

API Endpoints

Base URL: https://tripapi.dev

{
  "destination": "Da Nang",     // required — city name
  "check_in": "2026-05-01",    // YYYY-MM-DD (required for live rates)
  "check_out": "2026-05-03",   // YYYY-MM-DD
  "guests": 2,                 // default: 2
  "max_price_usd": 100,        // max per night
  "min_stars": 4,              // 1-5
  "sort_by": "recommended"     // recommended | price_low | price_high | rating
}

{ "query": "beachfront hotel in Da Nang under $100 for next weekend" }

Booking Endpoints

Hotels with bookable: true in search results can be booked directly.

{ "offer_id": "3gAVonJzkY6k..." }

{
  "prebook_id": "...",
  "transaction_id": "...",
  "first_name": "John",
  "last_name": "Doe",
  "email": "john@example.com",
  "phone": "+84901234567"
}

Response Format

Search Response

{
  "query_summary": "Da Nang, 2026-05-01 to 2026-05-03, 2 guests",
  "total_results": 10,
  "source": "liteapi",
  "hotels": [
    {
      "name": "Meliá Vinpearl Danang Riverfront",
      "city": "Da Nang",
      "stars": 5,
      "nightly_price_usd": 83.67,
      "total_price_usd": 167.33,
      "room_name": "Deluxe Room",
      "description": "Breakfast Included · Free cancellation",
      "rating": 4.2,
      "source": "liteapi",
      "bookable": true,
      "offer_id": "3gAVon...",
      "booking_url": "https://...",
      "agoda_url": "https://...",
      "image_url": "https://..."
    }
  ],
  "ai_recommendation": "For beachfront in Da Nang...",
  "booking_search_url": "https://...",
  "agoda_search_url": "https://..."
}

Hotel Sources

MCP Server (Claude, Cursor, etc.)

TripAPI is available as an MCP server for Claude Desktop, Cursor, and any MCP-compatible AI platform.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "tripapi": {
      "command": "uvx",
      "args": ["--from", "fastmcp", "fastmcp", "run",
               "https://github.com/your-org/tripapi/mcp_server.py"],
      "env": { "LITEAPI_KEY": "your-key" }
    }
  }
}

MCP Tools

ChatGPT / OpenAI Actions

TripAPI works as an OpenAI Action for ChatGPT. The OpenAPI spec is at:

https://tripapi.dev/openapi_gpt.yaml

You can import this directly when creating a GPT in the GPT Editor.

Coverage