Skip to main content
Travel is the primitive for discovering hotels, restaurants, and places across major travel datasets. Use it for destination discovery, hotel comparison, and place research workflows. Google hotel endpoints return live data instantly, while TripAdvisor search uses async task retrieval.
Travel is a use-case view over Business Data — there is no separate /v1/travel route. Every call below maps to a /v1/business/... endpoint (Google Hotels + TripAdvisor). There is no dedicated SDK sub-client; use the CLI (naive business ...) or the Business Data REST/MCP surface.

​
CLI First

# Search hotels (live)
naive business google hotel-searches --keyword "hotels manhattan" --location-code 2840

# Get specific hotel details (live)
naive business google hotel-info --hotel-id "ChIJN1t_tDeuEmsRUsoyG83frY4"

# Search TripAdvisor places (async)
naive business tripadvisor search --keyword "restaurants paris"

​
Endpoints

PlatformEndpointDescriptionSpeedCost
Google Hotelshotel-searchesSearch hotels by query + locationLive2 credits
Google Hotelshotel-infoDetailed hotel data (profile/rates/amenities)Live2 credits
TripAdvisorsearchFind places and listingsStandard (async)2 credits

​
Google Hotels (Live)

Google hotel endpoints return immediate results via:
  • POST /v1/business/google/hotel-searches
  • POST /v1/business/google/hotel-info

​
Parameters

ParamTypeRequiredDefaultDescription
keywordstringYes (hotel-searches)—Hotel search query
hotel_identifierstringYes (hotel-info)—Google hotel identifier (CID/place ID)
location_codenumberNo—Location code
language_codestringNo—Language code
check_instringNo—Check-in date (YYYY-MM-DD)
check_outstringNo—Check-out date (YYYY-MM-DD)
adultsnumberNo—Number of adults

​
TripAdvisor Search (Async)

TripAdvisor discovery uses async workflow:
  1. Submit via POST /v1/business/tripadvisor/search/task
  2. Check via GET /v1/business/tripadvisor/search/tasks-ready
  3. Retrieve via GET /v1/business/tripadvisor/search/task/:id
# Step 1: Submit search task
curl -X POST https://api.usenaive.ai/v1/business/tripadvisor/search/task \
  -H "Authorization: Bearer nv_sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "keyword": "hotels lisbon", "location_code": 2840 }'

# Step 2: Check ready tasks
curl https://api.usenaive.ai/v1/business/tripadvisor/search/tasks-ready \
  -H "Authorization: Bearer nv_sk_your_key"

# Step 3: Retrieve results
curl https://api.usenaive.ai/v1/business/tripadvisor/search/task/TASK_ID \
  -H "Authorization: Bearer nv_sk_your_key"

​
Typical Workflow

Agent receives task: "Find mid-range hotels in Lisbon"
    │
    ├─ POST /v1/business/google/hotel-searches
    │   { keyword: "hotels lisbon", location_code: 2840 }
    │   → Immediate hotel candidates
    │
    ├─ POST /v1/business/google/hotel-info
    │   { hotel_identifier: "<selected-hotel-id>" }
    │   → Detailed profile and rates
    │
    └─ POST /v1/business/tripadvisor/search/task
        { keyword: "hotels lisbon" }
        → Broader place discovery from TripAdvisor