Søk etter restplasser og pakkereisetilbud fra Norge
Søk etter tilgjengelige pakkereiser inkludert fly og overnatting med avreise fra Norge. Returnerer gjeldende priser, tilgjengelighet, hotellinformasjon og bestillingslenker som samsvarer med brukerens søkekriterier.
API-et er gratis å bruke og krever ingen autentisering. Alle priser er sanntidspriser i lokal valuta. Svaret er JSON.
API-et kan brukes direkte av AI-assistenter og chatboter for å svare på spørsmål om tilgjengelighet og priser.
AI-assistenter kan også koble til vår MCP-server (Model Context Protocol, ingen autentisering): https://www.restplass.no/mcp
Endepunkt
GET https://www.restplass.no/services/charter/api_search
- Maskinlesbar OpenAPI 3.1-spesifikasjon. Kall endepunktet uten parametre for å få den samme spesifikasjonen.
Eksempler
- Søk etter pakkereisetilbud til Gdansk fra 2026-12-01(eksakt dato for utreise) til 2026-12-04(eksakt dato for hjemreise):
https://www.restplass.no/services/charter/api_search?return_date_exact=2026-12-04T23%3A59%3A00Z&destination_name=Gdansk&depart_date_exact=2026-12-01T00%3A00%3A00Z - Reis når som helst til et hotell i nærheten av Eiffeltårnet i Paris:
https://www.restplass.no/services/charter/api_search?lon=2.294351&radius=0.8&lat=48.858844 - Søk etter pakkereisetilbud med ca 1 ukes varighet til Syden i 2027-01:
https://www.restplass.no/services/charter/api_search?days_min=6&return_date_max=2027-01-31T23%3A59%3A00Z&depart_date_min=2027-01-01T00%3A00%3A00Z&category=SUNBATH&days_max=8
Søkeparametre
| Navn | Type | Beskrivelse |
|---|---|---|
adults |
integer | Antall voksne 12-99 år, default 2 |
bbox |
string | Geografisk søk avgrenset med et rektangel. Format: minLat,minLon,maxLat,maxLon. |
board_type |
string: breakfast | half_board | full_board | all_inclusive | Måltider inkludert på hotellet, f.eks frokost, halvpensjon, helpensjon, all inclusive |
category |
string: SUNBATH | CITY | SKI | EXOTIC | Kategori for ferien SUNBATH=Syden,Sol&bad, CITY=storbyferie, SKI=skiferie, EXOTIC=fjerne strender |
children |
integer | Antall barn 2-11 år, default 0 |
country_iso |
string | ISO kode for land, for eksempel ES, GR, PL, TR |
days_max |
integer | Maksimum antall dager for ferien, for eksempel 3, 7, 14 |
days_min |
integer | Minimum antall dager for ferien, for eksempel 3, 7, 14 |
depart_date_exact |
string | Ferien skal starte denne dagen (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ) |
depart_date_max |
string | Seneste mulige start på ferien (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ) |
depart_date_min |
string | Tidligste mulige start på ferien (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ) |
destination_airport_code |
string | IATA kode for destinasjonsflyplass, for eksempel ALC, AGP, TFS |
destination_name |
string | Destinasjonsnavn, for eksempel Malta, Magaluf, Gran Canaria |
direct_flight |
boolean | Sett til true for å finne hoteller med direktefly |
distance_airport |
integer | Maksimal avstand melom hotell og flyplass i km, for eksempel 20, 40, 80 |
distance_beach |
integer | Maksimal avstand til stranden i meter, for eksempel 0, 100, 500 |
distance_centre |
integer | Maksimal avstand til sentrum i meter, for eksempel 0, 100, 500 |
features |
array | Fasiliteter på hotellet: ac=aircondition, adultsonly=Kun for voksne, apartment=leilighet, bar=bar, childspool=barnepool, gym=treningssenter, heatedpool=oppvarmet basseng, kidsclub=barnklubb, pool=basseng, seaview=havutsikt, restaurant=restaurant, spa=spa |
fields |
array | Felt som skal inkluderes i søkeresultatet |
guest_rating |
number | Minimum gjestevurdering, for eksempel 8.2, 9.0. Median: 8.4 |
hotel_name |
string | Hotellnavn, for eksempel Riu Palace, Iberostar, Sol |
infants |
integer | Antall spedbarn 0-1 år, default 0 |
lat |
number | Breddegrad i desimalgrader, brukes med lon og radius |
limit |
integer | Antall tilbud som skal returneres, for eksempel 5, 10. Default 1 |
lon |
number | Lengdegrad i desimalgrader, brukes med lat og radius |
max_price |
integer | Maksimum totalpris for hele reisen, for eksempel 5000, 10000, 15000 |
number_of_nights |
integer | Eksakt antall netter for ferien, for eksempel 3, 7, 14 |
origin_airport_code |
string | IATA kode for avreiseflyplass, for eksempel OSL, SVG, TRD |
radius |
number | Radius i kilometer fra lat, lon |
rating |
integer | Minimum antall stjerner, for eksempel 3, 4, 5 |
return_date_exact |
string | Hjemreisen skal begynner denne dagen(ISO 8601 format YYYY-MM-DDTHH:MM:SSZ) |
return_date_max |
string | Seneste mulige hjemreise (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ) |
return_date_min |
string | Tidligste mulige hjemreise (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 | Sorteringsrekkefølge for tilbudene. Default er price_asc |
temp_air_day_max |
integer | Maksimum forventet dagtemperatur i Celsius, for eksempel 25, 30 |
temp_air_day_min |
integer | Minimum forventet dagtemperatur i Celsius, for eksempel 20, 25 |
temp_water |
integer | Minimum forventet vanntemperatur i Celsius, for eksempel 20, 25 |
Felter i svaret
| Navn | Type | Beskrivelse |
|---|---|---|
categories |
array | Kategoreter (Eksempel: ARRAY(0x631e49fb7d08)) |
country_code |
string | ISO 3166 kode for land (Eksempel: ES) |
country_name |
string | Landets navn (Eksempel: Hellas) |
currency |
string | ISO 4217 valuta (Eksempel: NOK) |
departure_date |
string | Avreisetidspunkt i ISO 8601 format YYYY-MM-DDTHH:MM:SSZ |
destination_airport_code |
string | IATA kode for destinasjonsflyplass (Eksempel: LPA) |
destination_airport_name |
string | Destinasjonsflyplassens navn (Eksempel: Gran Canaria) |
destination_name |
string | Destinasjonsnavn (Eksempel: Playa del Ingles) |
distance_airport |
integer | Avstand flyplass-hotell i km |
distance_beach |
integer | Avstand til stranden i meter |
distance_centre |
integer | Avstand til sentrum i meter |
features |
array | Fasiliteter (Eksempel: ARRAY(0x631e4a0b9ba0)) |
features_text |
array | Fasiliteter (Eksempel: ARRAY(0x631e49de0d68)) |
guest_rating |
number | Gjennomsnittlig gjestevurdering hvor 10.0 er best. Median av bestilte hoteller i 2025 er 8.4 |
hotel_description |
string | Tekst som beskriver hotellet (Eksempel: Føl deg som hjemme i dette fantastiske leilighetshotellet med 3 svømmebassenger, 2 barer og en restaurant. Gratis Wi-Fi og en balkong med utsikt over bassenget.) |
hotel_image |
string | URL til bilde av hotellet |
hotel_name |
string | Hotellnavn (Eksempel: Riu Palace) |
lat |
number | Hotellets breddegrad i desimalgrader |
lon |
number | Hotellets lengdegrad i desimalgrader |
number_of_nights |
integer | Antall netter på hotellet |
offer_id |
string | Unik ID for tilbudet |
origin_airport_code |
string | IATA kode for avreiseflyplass (Eksempel: OSL) |
origin_airport_name |
string | Avreiseflyplassens navn (Eksempel: Oslo) |
price_per_pers |
integer | Pris pr person, fly og hotell |
return_date |
string | Tidspunkt for hjemreisen i ISO 8601 format YYYY-MM-DDTHH:MM:SSZ |
room_type |
string | Romtype og måltider på hotellet (Eksempel: Dobbeltrom, frokost) |
supplier_logo |
string | URL til arrangørens logo |
supplier_name |
string | Turoperatørens navn, f.eks. TUI, Ving (Eksempel: Apollo) |
temp_air_day |
integer | Forventet dagtemperatur i Celsius |
temp_water |
integer | Forventet badetemperatur i Celsius |
total_price |
integer | Totalpris for alle reisende, fly og hotell |
url |
string | URL for å bestille reisen |