Developer API

Structured wine travel data for your apps, AI agents, and LLM tools. Every response includes affiliate booking URLs.

Quickstart

# List wine regions

curl https://thewinetrip.com/api/v1/regions

# Search Bordeaux wineries

curl "https://thewinetrip.com/api/v1/wineries?region=bordeaux&limit=10"

# Find wineries near Florence, Italy

curl "https://thewinetrip.com/api/v1/wineries/nearby?lat=43.77&lng=11.25&radius_km=30"

GET/api/v1/wineriesSearch/browse wineries with filters

GET/api/v1/wineries/{id}Single winery by UUID

GET/api/v1/wineries/nearbyGeo search by lat/lng/radius (PostGIS)

GET/api/v1/regionsList all wine regions with metadata

GET/api/v1/regions/{slug}Single region detail

POST/api/v1/tripsCreate shareable trip itinerary

GET/api/v1/trips/{id}Retrieve saved trip

PUT/api/v1/trips/{id}Update trip

GET/api/v1/openapi.jsonOpenAPI 3.1 spec

Use TheWineTrip directly from Claude Desktop, Claude.ai, and other MCP-compatible AI assistants.

# Add to Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "thewinetrip": {
      "command": "npx",
      "args": ["-y", "@thewinetrip/mcp-server"]
    }
  }
}

search_wineriesSearch by region, country, or query

get_wine_regionFull region metadata, airports, costs

list_wine_regionsAll available regions with slugs

find_nearby_wineriesPostGIS geo search by coordinates

plan_wine_tripGenerate day-by-day itinerary template

create_tripSave trip and get shareable URL

Connect TheWineTrip to a custom GPT using our OpenAPI spec — no code required.

Import via OpenAPI URL

https://thewinetrip.com/api/v1/openapi.json

Free100 req/dayFree

Pro10,000 req/day$29/mo

EnterpriseUnlimitedContact us