Construiește agenți AI care rezervă hoteluri
Conectează agentul tău AI la 2,5 milioane de hoteluri și apartamente din întreaga lume folosind Model Context Protocol (MCP). Căutarea este gratuită și nu necesită cheie API. Rezervă cu un simplu apel REST.
2.5M+
Hoteluri și apartamente
190+
Țări
15
Instrumente API
Gratuit
API de căutare
Cum funcționează
Trei pași de la căutare la rezervare confirmată. Agentul tău AI gestionează întregul flux programatic.
Caută hoteluri
Folosește search_location pentru a găsi o destinație, apoi hotel_search pentru a verifica disponibilitatea. Nu este necesară autentificarea. Filtrează după preț, clasificare stele, facilități și tip de masă. Obține detalii despre hotel, fotografii și recenzii.
Autentificare
Apelează guest_login cu o adresă de email pentru a obține un Bearer token. Nu este necesară parola pentru conturile de oaspeți. Folosește tokenul pentru toate operațiunile de rezervare. Tokenurile sunt JWT standard, valide pentru apeluri API autentificate.
Rezervă și plătește
Apelează prepare_booking cu detaliile oaspeților, apoi finalizează plata prin create_checkout (Revolut) sau confirm_booking (linie de credit B2B). Oaspetele primește un email de confirmare automat.
Instrumente disponibile
15 instrumente care acoperă ciclul complet de rezervare hotelieră. Instrumentele publice nu necesită autentificare. Instrumentele autentificate necesită un Bearer token de la login sau guest_login.
Instrumente publice (fără autentificare)
search_location
Caută orașe, regiuni și hoteluri după nume. Returnează ID-uri de locații și coordonate pentru utilizare în căutarea de hoteluri.
hotel_search
Inițiază o căutare de disponibilitate hotelieră după ID-ul regiunii sau coordonate GPS. Specifică datele, camerele, naționalitatea oaspetelui și moneda.
get_search_results
Obține rezultatele căutării paginate cu filtre pentru interval de preț, clasificare stele, facilități și tip de masă. Sortează după preț sau rating.
get_hotel_rooms
Obține pachetele de camere disponibile pentru un hotel specific. Returnează prețuri, planuri de masă și quoteIds necesare pentru rezervare.
check_cancellation_policy
Vizualizează termenele limită de anulare și penalitățile pentru pachete de camere înainte de rezervare.
get_hotel_details
Informații complete despre hotel: descriere, facilități, recenzii, fotografii, coordonate și atracții din apropiere.
login
Autentificare cu email și parolă. Returnează un Bearer token pentru utilizare cu instrumente autentificate.
guest_login
Înregistrare sau autentificare doar cu o adresă de email. Nu este necesară parola. Returnează un Bearer token pentru rezervare.
Instrumente autentificate (Bearer token)
prepare_booking
Creează o rezervare cu detaliile oaspeților și informații de contact. Returnează un ID de rezervare pentru plată. Rezervările expiră după ~15 minute.
confirm_booking
Confirmă și plătește prin linie de credit B2B. Confirmare instantanee cu număr de referință al rezervării. Doar pentru parteneri B2B.
create_checkout
Generează un URL de plată Revolut. Redirecționează utilizatorul final pentru plată cu cardul. Rezervarea se confirmă automat prin webhook.
get_payment_url
Generează un URL Stripe pentru plată cu cardul. Alternativă la Revolut pentru piețele unde Stripe este preferat.
list_bookings
Lista rezervărilor filtrate după status: viitoare, finalizate, anulate sau în așteptare. Rezultate paginate cu informații despre hotel și date.
get_booking_details
Detalii complete ale rezervării, inclusiv informații despre hotel, numele oaspeților, statusul plății și politica de anulare.
cancel_booking
Anularea unei rezervări. Returnează suma rambursată și taxele de anulare. Necesită confirmare explicită.
Opțiuni de integrare
Alege protocolul potrivit pentru stiva ta. Toate endpoint-urile returnează aceleași date. Clienții MCP pot descoperi automat instrumentele prin endpoint-ul de descoperire.
REST API
Apelează instrumentele direct prin HTTP POST. Fiecare instrument are propriul său URL. Trimite input JSON în corpul cererii și primește output JSON. Instrumentele publice nu necesită headere. Instrumentele autentificate necesită un header Authorization cu Bearer token.
# Search hotels in Paris (no auth)
curl -X POST \
https://locktrip.com/mcp/tools/search_location \
-H "Content-Type: application/json" \
-d '{"query": "Paris"}'
# Book with auth token
curl -X POST \
https://locktrip.com/mcp/tools/prepare_booking \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <token>" \
-d '{ ... }'Protocol MCP
Folosește Model Context Protocol pentru integrare nativă cu agenți AI. Instrumentele sunt descoperite automat prin SSE sau JSON-RPC. Compatibil cu Claude Desktop, Cursor și orice client compatibil MCP. Endpoint-ul de descoperire furnizează capabilitățile serverului și metadatele instrumentelor.
{
"mcpServers": {
"locktrip": {
"url": "https://locktrip.com/mcp/sse"
}
}
}Endpoint-uri de descoperire
Endpoint-uri citibile de mașini pentru descoperirea automată a instrumentelor. Folosește-le pentru a integra LockTrip în framework-uri de agenți AI, gateway-uri API sau registre de instrumente LLM.
Opțiuni de plată
Multiple căi de plată pentru diferite cazuri de utilizare. Agenții B2C generează linkuri de plată pentru utilizatorii finali. Partenerii B2B plătesc instant prin linie de credit.
Plată Revolut
Generează o pagină de plată găzduită prin instrumentul create_checkout. Utilizatorul final dă click pe link și plătește cu cardul. Rezervarea se confirmă automat prin webhook. Cel mai bun pentru agenții AI orientați către consumatori.
Plată Stripe
Plată alternativă cu cardul prin instrumentul get_payment_url. Returnează un URL de plată găzduit Stripe. Util pentru piețe sau monede unde Stripe este preferat față de Revolut.
Linie de credit B2B
Pentru parteneri de afaceri cu o linie de credit prefinanțată. Apelează confirm_booking pentru a plăti instant din soldul tău. Nu este necesară redirecționarea. Ideal pentru agențiile de turism și OTA-urile care construiesc fluxuri automate de rezervare.
Limite de rată
Limite generoase atât pentru utilizarea anonimă, cât și pentru cea autentificată. Utilizatorii autentificați primesc cote mai mari pentru toate endpoint-urile.
| Nivel | Instrumente de căutare | Instrumente de rezervare |
|---|---|---|
| Anonim | 30 req/min | N/A (autentificare necesară) |
| Autentificat | 60 req/min | 20 req/min |
Gata să construiești?
Începe să cauți hoteluri chiar acum fără cheie API. Citește specificația OpenAPI sau conectează clientul tău MCP pentru a descoperi automat toate cele 15 instrumente. Pentru parteneriate B2B și acces la linia de credit, contactează echipa noastră de business.