# Travel Hotel Research > Researches hotels, flights, attractions, short-term rentals, and live events via the Crawlora API — Booking.com, Expedia, Agoda, TripAdvisor, Trip.com, Airbnb, and Ticketmaster — returning clean JSON. Use when the user wants to search or compare hotel/stay prices and reviews, look up flight options, find attractions/things-to-do or concerts/events, or research an Airbnb host or listing. - Skill: `crawlora-org/travel-hotel-research` (Agent Skill, multi-file: 3 files) - Install (CLI): `npx skillmds@latest add crawlora-org/travel-hotel-research` - Raw SKILL.md: https://api.skillmd.com/api/skills/crawlora-org/travel-hotel-research/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Research & Search - Author: Crawlora-org (https://skillmd.com/u/crawlora-org) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/crawlora-org/travel-hotel-research --- # Travel & hotel research Search and compare hotels, flights, attractions, short-term rentals, and live events across seven travel platforms as normalized JSON from the Crawlora API — no scraping OTA search-result pages. ## When to use this skill - "Find hotels in for " / compare prices across OTAs. - "What are the reviews like for this hotel/attraction?" - "Search flights from to ." - "What's there to do in ?" (attractions/tours, or concerts/events). - "Look up this Airbnb host/listing" (reviews, calendar, other listings). - "Find tickets/events for in " (Ticketmaster). ## Setup (one-time) - Get a free Crawlora API key (2,000 credits/mo, no card) at [https://crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills). - Set `CRAWLORA_API_KEY` in the environment before running the helper. - The helper reads `CRAWLORA_API_KEY` from the environment and sends requests to `https://api.crawlora.net/api/v1`. Missing/invalid key → `401`. ## How it works 1. **Hotels** — `/booking/search` (params `query`, `checkin`, `checkout`), `/agoda/hotels/search`, `/tripcom/hotels/search` (GET, by city) or `POST /expedia/properties/search` (Expedia's Stays API is POST-only — its exact request-body field names are undocumented, see below); detail via `/booking/hotel-detail`, `/agoda/hotels/{property_id}`, `POST /expedia/properties/detail`; reviews via `/booking/reviews`, `POST /expedia/properties/reviews`. 2. **Flights** — `/agoda/flights/search` (GET) and `POST /expedia/flights/search` / `/booking-flights/search`; use each platform's `.../autocomplete` or `.../search-locations` endpoint first to resolve city/airport codes. 3. **Attractions & things-to-do** — `/booking-attractions/search`, `POST /expedia/activities/search`, `/agoda/activities/search`, `/tripadvisor/search` (hotels, restaurants, and attractions all in one). 4. **TripAdvisor** — `/tripadvisor/autocomplete` to resolve a place, then `/tripadvisor/place` for the profile and `/tripadvisor/reviews` for guest reviews (works for hotels, restaurants, and attractions). 5. **Airbnb** — `/airbnb/search` to find stays; `/airbnb/room/{id}` for a listing (+ `/calendar`, `/reviews`); `/airbnb/host/{id}` for the host profile (+ `/listings`, `/reviews`). 6. **Ticketmaster** — `/ticketmaster/search-events` (`q`) or `/ticketmaster/discover-city-events` (`city`) to find events; `/ticketmaster/event` for detail, `/ticketmaster/venue` (+ `/venue-events`) for a venue, `/ticketmaster/attraction` (+ `/attraction-events`) for a performer/team's full schedule. Full endpoint list, methods, and params: [`reference/endpoints.md`](reference/endpoints.md). ## Calling the API ```sh # Hotel search (GET): scripts/crawlora.sh /booking/search query="Lisbon" checkin=2026-09-10 checkout=2026-09-14 | jq '.' scripts/crawlora.sh /agoda/hotels/search city="Lisbon" | jq '.' # Expedia (POST — exact body field names are unconfirmed, see Notes below): scripts/crawlora.sh -X POST /expedia/properties/search '{"destination":"Lisbon","checkIn":"2026-09-10","checkOut":"2026-09-14"}' | jq '.' # Airbnb: scripts/crawlora.sh /airbnb/search location="Lisbon" | jq '.' scripts/crawlora.sh /airbnb/room/12345678 | jq '.' # Ticketmaster: scripts/crawlora.sh /ticketmaster/search-events q="Coldplay" | jq '.' ``` Use `scripts/crawlora.sh` for all requests; it keeps the API key out of command-line arguments. ## Endpoint reference See [`reference/endpoints.md`](reference/endpoints.md) for every Booking, Expedia, Agoda, TripAdvisor, Trip.com, Airbnb, and Ticketmaster endpoint this skill uses. ## Examples - **Cross-OTA price compare:** search the same destination/dates on `/booking/search`, `/agoda/hotels/search`, and `POST /expedia/properties/search`, then diff nightly rates for comparable hotels. - **Stay vs. hotel:** `/airbnb/search` against `/booking/search` for the same city to compare short-term-rental vs. hotel pricing. - **Trip planning:** `/tripadvisor/search` for attractions in a city, then `/tripadvisor/reviews` on the top few to check recent visitor sentiment. - **Host due diligence:** `/airbnb/host/{id}` + `/airbnb/host/{id}/reviews` before booking, or `/airbnb/host/{id}/listings` to see their full portfolio. ## Notes & limits - **Credits / pay-on-success:** billed only on `2xx`; free tier 2,000 credits/mo. Key at [https://crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills). - **Public data only** — public search/listing/review pages; no booking or payment actions are performed. - **Security:** key lives in `CRAWLORA_API_KEY` only — never hardcode, query-param, or commit it. - **Expedia and some Agoda endpoints are `POST` with a JSON body** — remember `-X POST` when calling `scripts/crawlora.sh`. Most Booking/Agoda/Trip.com/ Airbnb/TripAdvisor endpoints are plain `GET` with query params. - **Expedia's exact request-body field names are unconfirmed** — the tool schema only exposes an opaque `option` object (destination, dates, occupancy, filters expected inside), and live-testing ruled out both a `{"option": {...}}` wrapper and several plausible flat field-name guesses (`checkInDate`/`checkOutDate`, `checkIn`/`checkOut`). Confirm the current shape at [crawlora.net/docs](https://crawlora.net/docs?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills) or the [playground](https://crawlora.net/playground?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills) before relying on the Expedia endpoints — every other endpoint in this skill is live-verified, Expedia's POST body shape is the one exception. - Location/city ids are platform-specific — always resolve with the platform's own autocomplete/locations-search endpoint first.