Retrieve hotel IDs by filter
https://api-sandbox.worldota.net/api/content/v1/hotel_ids_by_filter/The call gets the identifiers for all required hotels. Use fields to search only for the desired hotels.
ℹ️
- Use this call instead of call Retrieve hotel dump.
- Use this call after Retrieve filter values call.
Sandbox limitations
⚠️
Use only field values, IDs, API keys, and any static content from the sandbox environment within the sandbox. Do not use sandbox data in test or production environments, and do not mix data or configuration between different environments.
The value of the country filter can only be one of the following:
59,153,189,201.
Searching for other countries is not possible — the service will return an empty result. All other filter parameters can take any values.
Request example
curl --user '<KEY_ID>:<API_KEY>' 'https://api.worldota.net/api/content/v1/hotel_ids_by_filter/' \
--header 'Content-Type: application/json' \
--data '{
"updated_since": null,
"country": [
59,
201
],
"serp_filter": null,
"star_rating": [
3,
4,
5
],
"kind": [
"Hotel",
"Mini-hotel"
],
"supplier_type": null,
"preferable": null,
"top": null
}'Request body
Response
Response example
{
"data": {
"hids": [
6302759,
6311831,
6494362,
6545120,
6616666,
6720545,
6737792,
6755777,
6799898,
6815321,
6815333,
6839615,
6905392,
7001894,
7049467,
7350192,
7355368,
7379253,
7389021,
7397410,
7405290,
7405430,
7439636,
7442475,
7547079,
7570809,
7571591,
7572011,
7572176,
7572386,
7572420,
7573844,
7574867,
7575239,
7575566,
7580722,
7580928,
7601289,
7663394,
7788851,
7830943,
7834679,
7856555,
7949288,
8065490,
8074369,
8140100,
8141992,
8364631,
8512687,
8576478,
8790618,
8807924,
8819408,
8819413,
8827848,
8836453,
8837145,
9011465,
9083012,
9208277,
9214046,
9253154,
9721825,
9730850,
9730851,
9730852,
9730853,
9731543,
9731545,
9731548,
9731552,
9731555,
9731556,
9731567,
9731570,
9731614,
9731615,
9731616,
9731617,
9731618,
9731619,
9741151,
9846505,
9925597,
9947804,
9955970,
10004834,
10061513,
10164510
],
"ids": [
"1003_hollywood_midcentury_retreat_rud_113273",
"1006_beverly_hills_oasis",
"1011_beverly_hills_modern_summit",
"1014_contemporary_outpost_estate_rud_113274",
"1015_hollywood_mediterranean_estate_rud_113265",
"1017_bel_air_classic_estate_rud_113270",
"1024_mulholland_rockstar_retreat_rud_113299",
"1035_beverly_hills_modern_escape",
"1039_sensational_sunset_view_rud_113307",
"1042_vista_sunset_plaza",
"1047_hollywood_midcentury_pool_view",
"1049_lilypool_rud_113260",
"1071_beverly_hills_polo_estate",
"1090_sunset_infinity_pool_view_rud_113246",
"_0x25652",
"_0x284d6",
"aero_3",
"amazing_location_and_amenities__miracle_mile",
"amoroso_retreat_eclectic_1_br_house_with_large_garden_in_a_walking_street_short_bike_ride_to_the_beach_mod_42166_2",
"apostrophe_hotel",
"appart_hotel_cosy_cadet",
"arc_de_triomphe_etoile_2",
"bac_st_germain_2_bedroom_apartment_5th_floor_penthouse_hov_50576",
"best_western_folkest_opera",
"best_western_opera_dantin",
"best_western_sevres_montparnasse",
"best_western_tour_eiffel_invalides_2",
"cantagrel",
"chabrol_opera",
"charing_cross_hotel",
"citizenm_los_angeles_downtown",
"clark_5",
"conrad_los_angeles",
"cosmotel",
"cottage_in_silver_lake",
"crowne_plaza_paris_republique",
"four_seasons_los_angeles_at_beverly_hills",
"furnished_suites_in_corporate_center_2",
"goralska_residences_paris_bastille",
"grand_hotel_malher_2",
"grand_hotel_saint_michel",
"holiday_inn_bel_air",
"hollywood_lux_steps_to_walk_of_fame",
"hostellerie_du_marais",
"hotel_angeleno",
"hotel_atlantis_7",
"hotel_bachaumont",
"hotel_du_vieux_marais",
"hotel_le_milie_rose",
"hotel_le_notre_dame_saint_michel",
"hotel_le_twelve",
"hotel_le_villiers",
"hotel_montparnasse_saint_germain",
"hotel_nord_est",
"hotel_saintmarcel",
"ibis_daumesnil_porte_doree",
"ibis_gare_de_lyon_diderot",
"ibis_jemmapes",
"istria_montparnasse",
"le_grand_hotel_de_normandie",
"le_petit_madeleine_hotel",
"le_relais_madeleine",
"maison_blanche_homes_3",
"mama_shelter_la",
"mercure_paris_gare_de_lyon_bastille",
"momart_hotel_spa",
"oakwood_4201_via_marina",
"oceana_venice_vacation_rental",
"onefinestay_firenze_avenue",
"porte_de_versailles_hotel_3",
"princesse_caroline",
"quality_htel_malesherbes_by_happyculture",
"radisson_at_usc_los_angeles",
"residence_sorbonne_2",
"rodeway_inn_suites_pacific_coast_highway_2",
"sofitel_la_at_beverly_hills",
"sunshine_suites_at_main_st_2",
"the_inn_at_venice_beach",
"the_topaz_luxury_penthouse__a_live_luxe_property",
"van_ness_by_stay_city_rentals",
"venice_beach_vacation_ven_studio_a_rud_82208_2",
"venice_beach_vacation_ven_studio_b_rud_82209",
"venice_beach_vacation_ven_studio_c_rud_82210",
"vintage_two_bedroom_la_vacation_rentals_unit_1_rud_82186",
"vintage_two_bedroom_la_vacation_rentals_unit_2_rud_82195",
"vintage_two_bedroom_la_vacation_rentals_unit_3_rud_82196",
"vintage_two_bedroom_la_vacation_rentals_unit_4_rud_82197",
"vintage_two_bedroom_la_vacation_rentals_unit_5_rud_82198",
"vintage_two_bedroom_la_vacation_rentals_unit_7_rud_82200",
"wilshire_vista_one_bedroom_vacation_house_rud_82201"
]
},
"debug": {
"api_endpoint": {
"endpoint": "api/content/v1/hotel_ids_by_filter",
"is_active": true,
"is_limited": true,
"remaining": 299,
"requests_number": 300,
"reset": "2025-12-10T14:00:00",
"seconds_number": 600
},
"request": {
"updated_since": null,
"country": [
59,
201
],
"serp_filter": null,
"star_rating": [
3,
4,
5
],
"kind": [
"Hotel",
"Mini-hotel"
],
"supplier_type": null,
"preferable": null,
"top": null
},
"method": "POST",
"real_ip": "2001:0DB8:1111:0012::0001:1231",
"request_id": "58e1c52a510f9b8741b27ec123",
"key_id": 1,
"api_key_id": 1,
"utcnow": "2025-12-10T13:55:00.457294"
}
}Errors
The error field has the value specified in the headers below.
invalid_params
One or more input parameters are incorrect. For more details, see the response field debug validation_error.
no_hotel_ids
An internal search error. Has 500 status code.