Docs

Travel API reference and quickstart

Create an account, generate a key, and start with a small set of opinionated endpoints. The current beta uses seeded destination intelligence and returns structured outputs built for agent workflows while live provider integrations are still being connected.

Authentication

Bearer API keys

Keys are created from the dashboard and passed as a bearer token. Beta accounts are free and rate limited to 100 requests per hour and 2,500 requests per rolling 30-day window.

Quickstart

curl https://agentinfrastructureco.com/api/v1/travel/search \
  -H "Authorization: Bearer $AICO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "SFO",
    "departure_window": ["2026-10-01", "2026-10-03"],
    "trip_length_days": 14,
    "budget_usd": 9000,
    "interests": ["hiking", "food", "recovery"],
    "services": ["flights", "stays", "weather", "research"]
  }'

Example response

{
  "request_id": "req_123",
  "beta_warnings": [
    "origin is accepted as beta metadata and is not yet used in ranking.",
    "departure_window is accepted as beta metadata and is not yet used in ranking.",
    "trip_length_days is accepted as beta metadata and is not yet used in ranking."
  ],
  "results": [
    {
      "id": "italy-hiking",
      "name": "Italy Hiking Circuit",
      "score": 93.2,
      "budget_estimate_usd": 7944,
      "match_reasons": [
        "Estimated trip cost fits within the $9,000 budget.",
        "Ideal in Florence, cold but dry in the Dolomites."
      ]
    }
  ]
}

Request fields

Field	Type	Description
origin	string	Origin airport or origin context. Accepted during beta but not yet used in ranking.
departure_window	string[]	Start and end dates for the candidate departure window. Accepted during beta but not yet used in ranking.
trip_length_days	number	Accepted during beta for future itinerary work, but not yet used in ranking.
budget_usd	number	Target all-in budget for ranking destination fit.
interests	string[]	Tags like hiking, food, recovery, cycling, beach.
services	string[]	Accepted during beta for response labeling only. Does not yet switch live provider integrations.