Etsi äkkilähtöjä ja pakettimatkoja Suomesta

API hakuun suurimmasta ja kattavimmasta tietokannasta Suomessa pakettimatkojen tarjouksista. API:ta käytetään antamaan parhaat tarjoukset pakettimatkoista, jotka tarjoavat Tjäreborg, TUI, Apollo, Nazar, Ticket ja monet muut.

API on ilmainen eikä vaadi tunnistautumista. Kaikki hinnat ovat reaaliaikaisia paikallisessa valuutassa. Vastaus on JSON.

AI-avustajat ja chatbotit voivat käyttää APIa suoraan vastatakseen kysymyksiin saatavuudesta ja hinnoista.

AI-avustajat voivat myös yhdistää MCP-palvelimeemme (Model Context Protocol, ei tunnistautumista): https://www.akkilahdot.fi/mcp

Rajapinta

GET https://www.akkilahdot.fi/services/charter/api_search

Esimerkit

Hakuparametrit

NimiTyyppiKuvaus
adults integer Aikuisten määrä 12-99 vuotta, oletus 2
bbox string Maantieteellinen haku rajoitettu suorakulmiolla. Muoto: minLat,minLon,maxLat,maxLon.
board_type string: breakfast | half_board | full_board | all_inclusive Ateriat sisältyvät hotelliin, esimerkiksi aamiainen, puolihoito, täysihoito, all inclusive
category string: SUNBATH | CITY | SKI | EXOTIC Loman kategoria SUNBATH=Aurinko ja uiminen, CITY=Kaupunkiloma, SKI=Hiihtoloma, EXOTIC=Eksoottinen
children integer Lasten määrä 2-11 vuotta, oletus 0
country_iso string ISO-koodi maa, esimerkiksi ES, GR, PL, TR
days_max integer Maksimimäärä päiviä lomalle, esimerkiksi 3, 7, 14
days_min integer Vähimmäismäärä päiviä lomalle, esimerkiksi 3, 7, 14
depart_date_exact string Loman on alkaa tänä päivänä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)
depart_date_max string Viimeisin mahdollinen loma-ajan alkamispäivä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)
depart_date_min string Aikaisin mahdollinen loma-ajan alkamispäivä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)
destination_airport_code string IATA-koodi määränpää lentokentälle, esimerkiksi ALC, AGP, TFS
destination_name string Kohdenimi, esimerkiksi Malta, Magaluf, Gran Canaria
direct_flight boolean Aseta true löytääksesi hotelleja suorilla lennoilla
distance_airport integer Maksimaalinen etäisyys hotellin ja lentokentän välillä km, esimerkiksi 20, 40, 80
distance_beach integer Maksimaalinen etäisyys rannalle metreinä, esimerkiksi 0, 100, 500
distance_centre integer Maksimaalinen etäisyys keskustaan metreinä, esimerkiksi 0, 100, 500
features array Hotellin mukavuudet: ac=ilmastointi, adultsonly=Vain aikuisille, apartment=huoneisto, bar=baari, childspool=lastenallas, gym=kuntosali, heatedpool=lämmitetty uima-allas, kidsclub=lastenkerho, pool=uima-allas, seaview=merinäköala, restaurant=ravintola, spa=kylpylä
fields array Kentät, jotka on sisällytettävä hakutuloksiin
guest_rating number Vähimmäisarvio, esimerkiksi 8.2, 9.0. Mediaani: 8.4
hotel_name string Hotellin nimi, esimerkiksi Riu Palace, Iberostar, Sol
infants integer Vauvojen määrä 0-1 vuotta, oletus 0
lat number Leveysasteikko desimaaliluvuissa, käytetään lon ja säteen kanssa
limit integer Tarjottavien määrä, esimerkiksi 5, 10. Oletus 1
lon number Pituusasteikko desimaaliluvuissa, käytetään lat ja säteen kanssa
max_price integer Maksimihinta koko matkalle, esimerkiksi 5000, 10000, 15000
number_of_nights integer Tarkka määrä öitä lomalle, esimerkiksi 3, 7, 14
origin_airport_code string IATA-koodi lähtöpaikalle, esimerkiksi HEL, OUL, TLL
radius number Säde kilometreinä lat, lon
rating integer Vähimmäismäärä tähtiä, esimerkiksi 3, 4, 5
return_date_exact string Kotiinpaluupäivä alkaa tänä päivänä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)
return_date_max string Viimeisin mahdollinen kotiinpaluupäivä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)
return_date_min string Aikaisin mahdollinen kotiinpaluupäivä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)
sort string: price_asc | price_desc | rating_asc | rating_desc | distance_beach_asc | distance_airport_asc | guest_rating_desc Tarjousten järjestys. Oletus on price_asc
temp_air_day_max integer Maksimiodotettu päivälämpötila Celsius-asteina, esimerkiksi 25, 30
temp_air_day_min integer Vähimmäisodotettu päivälämpötila Celsius-asteina, esimerkiksi 20, 25
temp_water integer Vähimmäisodotettu veden lämpötila Celsius-asteina, esimerkiksi 20, 25

Vastauksen kentät

NimiTyyppiKuvaus
categories array Kategoriat (Esimerkki: ARRAY(0x5f3c3a16fb60))
country_code string ISO 3166 koodi maa (Esimerkki: ES)
country_name string Maan nimi (Esimerkki: Kreikka)
currency string ISO 4217 valuutta (Esimerkki: EUR)
departure_date string Lähtöaika ISO 8601 -muodossa YYYY-MM-DDTHH:MM:SSZ
destination_airport_code string IATA-koodi määränpää lentokentälle (Esimerkki: LPA)
destination_airport_name string Määränpään lentokentän nimi (Esimerkki: Gran Canaria)
destination_name string Kohdenimi (Esimerkki: Playa del Ingles)
distance_airport integer Etäisyys lentokentältä hotelliin km
distance_beach integer Etäisyys rannalle metreinä
distance_centre integer Etäisyys keskustaan metreinä
features array Mukavuudet (Esimerkki: ARRAY(0x5f3c39a576e8))
features_text array Mukavuudet (Esimerkki: ARRAY(0x5f3c3a14daa8))
guest_rating number Keskimääräinen asiakasarvio, jossa 10.0 on paras. Vuoden 2025 varattujen hotellien mediaani on 8.4
hotel_description string Teksti, joka kuvaa hotellia (Esimerkki: Tunne olosi kotoisaksi tässä upeassa huoneistohotellissa, jossa on 3 uima-allasta, 2 baaria ja ravintola. Ilmainen Wi-Fi ja parveke, josta on näkymä uima-altaalle.)
hotel_image string URL hotellin kuvasta
hotel_name string Hotellin nimi (Esimerkki: Riu Palace)
lat number Hotellin leveysasteikko desimaaliluvuissa
lon number Hotellin pituusasteikko desimaaliluvuissa
number_of_nights integer Yöt hotellissa
origin_airport_code string IATA-koodi lähtölentokentälle (Esimerkki: HEL)
origin_airport_name string Lähtöpaikan nimi (Esimerkki: Helsinki)
price_per_pers integer Hinta per henkilö, lennot ja hotelli
return_date string Kotiinpaluun aika ISO 8601 -muodossa YYYY-MM-DDTHH:MM:SSZ
room_type string Huonetyyppi ja ateriat hotellissa (Esimerkki: Kahden hengen huone, aamiainen)
supplier_logo string URL järjestäjän logoon
supplier_name string Matkanjärjestäjän nimi, esimerkiksi TUI, Ving (Esimerkki: Apollo)
temp_air_day integer Odotettu päivälämpötila Celsius-asteina
temp_water integer Odotettu veden lämpötila Celsius-asteina
total_price integer Kokonaishinta kaikille matkustajille, lennot ja hotelli
url string URL matkan varaamiseen

Etsi lentotarjouksia Suomesta

NDC-yhteensopiva API lentojen (vain lennot) hakuun Suomesta. Tietokanta sisältää tilauslentojen paikkoja, joita ei yleensä löydy Google Flightsista, Skyscanneristä tai Kayakista.

Rajapinta

GET https://www.akkilahdot.fi/services/flights/api_search

Esimerkit

Hakuparametrit

NimiTyyppiKuvaus
adt integer Aikuisten määrä (NDC: PaxType=ADT), oletus 1
chd integer Lasten määrä (NDC: PaxType=CHD), oletus 0
dep_date string Tarkka lähtöpäivä (YYYY-MM-DD)
dep_date_from string Aikaisin lähtöpäivä (YYYY-MM-DD)
dep_date_to string Viimeisin lähtöpäivä (YYYY-MM-DD)
dest string IATA-koodi kohdekentälle, esim. AYT, AGP, TFS
direct boolean Vain suorat lennot (NDC: StopQuantity=0)
inf integer Vauvojen määrä (NDC: PaxType=INF), oletus 0
limit integer Tarjousten määrä (1-25), oletus 10
max_price integer Maksimihinta (NDC: PriceRangeFilter.MaxAmount)
nights_max integer Enimmäismäärä öitä (vendor extension, ei NDC)
nights_min integer Vähimmäismäärä öitä (vendor extension, ei NDC)
orig string IATA-koodi lähtökentälle, esim. HEL, OUL, TLL
ret_date string Tarkka paluupäivä (YYYY-MM-DD)
ret_date_from string Aikaisin paluupäivä (YYYY-MM-DD)
ret_date_to string Viimeisin paluupäivä (YYYY-MM-DD)
sort string: price_asc | price_desc | dep_date_asc | dep_date_desc Järjestys, oletus price_asc

Vastauksen kentät

NimiTyyppiKuvaus
offer_id string
origin_destinations array
supplier string
total_price object
trip_duration_nights integer Öiden määrä (vendor extension, ei standardi NDC)
url string