Skip to main content

Documentation Index

Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
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