Retrieve point of interest dump

ETG API V3

B2B API

https://api.worldota.net/api/b2b/v3/hotel/poi/dump

The call returns a dump with a list of hotels by various locations along with nearby points of interest (POI).

⚠️

Content indexing isn’t allowed.

Request example

curl --user '<KEY_ID>:<API_KEY>' 'https://api.worldota.net/api/b2b/v3/hotel/poi/dump' \
--header 'Content-Type: application/json' \
--data '{
  "language": "en"
}'

Response

Expand this| Collapse this

language Int required or optional

The language.

ℹ️

The possible values:

ar — Arabic.
bg — Bulgarian.
cs — Czech.
da — Danish.
de — German.
el — Greek.
en — English.
es — Spanish.
fi — Finnish.
fr — French.
he — Hebrew.
hu — Hungarian.
it — Italian.
ja — Japanese.
kk — Kazakh.
ko — Korean.
nl — Dutch.
no — Norwegian Bokmål.
pl — Polish.
pt — Portuguese.
pt_PT — European Portuguese.
ro — Romanian.
ru — Russian.
sq — Albanian.
sr — Serbian.
sv — Swedish.
th — Thai.
tr — Turkish.
uk — Ukrainian.
vi — Vietnamese.
zh_CN — Simplified Chinese.
zh_TW — Traditional Chinese.

Response

Expand this| Collapse this

url String

The URL for downloading the dump.

last_update DateTime

The last date and time of updating the dump.

Response example

{
  "data": {
    "url": "https://partner-feedora.s3.eu-central-1.amazonaws.com/pois/feed_pois_en_v3.json.zst",
    "last_update": "2025-09-15T04:47:20Z"
  },
  "debug": {
    "api_endpoint": {
      "endpoint": "api/b2b/v3/hotel/poi/dump",
      "is_active": true,
      "is_limited": true,
      "remaining": 98,
      "requests_number": 100,
      "reset": "2025-09-17T00:00:00",
      "seconds_number": 86400
    },
    "request": {
      "language": "en"
    },
    "method": "POST",
    "real_ip": "104.30.161.77",
    "request_id": "3234913e4c9dc04f843410ecd098a596",
    "key_id": 1234,
    "api_key_id": 1234,
    "utcnow": "2025-09-16T16:14:50.755175"
  },
  "status": "ok",
  "error": null
}

Dump file structure

The file available at the url contains the following structure:

[
  {
    "id": "string",
    "hid": 12345,
    "pois": [
      {
        "poi_name": "string",
        "poi_name_en": "string",
        "poi_type": "string",
        "poi_subtype": "string",
        "distance": 321
      }
    ]
  }
]

Field details

Expand this| Collapse this

hotel [Object]

Describes a hotel, providing its unique identifiers together with a list of associated points of interest (POI).

id [String]

The unique hotel ID in the legacy string format.

ℹ️

Either this field or the hid field is required.

hid Int

The unique hotel ID in the new numeric format.

ℹ️

Each ID is an integer no longer than 10 digits.
We are gradually migrating all clients to use this format.

pois [Object]

The list of nearby points of interest (POI) associated with this hotel.

poi_name String

The name of the point of interest in the local language.

poi_name_en String

The name of the point of interest in English.

poi_type String

The main category or type of the point of interest (e.g., beach, airport, attraction).

ℹ️

The possible values:

Unspecified,
Continent.
Country.
Multi-Region (within a country).
Province (State).
Multi-City (Vicinity).
City.
Airport.
Bus Station.
Railway Station.
Subway (Entrace).
Neighborhood.
Point of Interest.
Multi-Railway Station.
Main Railway Station.

poi_subtype String

A more specific category or subtype of the point of interest.

ℹ️

The possible values:

unspecified,
administrative_center.
arenas_and_stadiums.
bars_and_restaurants.
beach.
buddist_temple.
business_center.
cableway.
casino_and_gambling.
church.
concerts_and_performances.
educational_objects.
entertainment_and_games.
harbor.
historical_poi.
hospital.
library.
mosque.
museum.
park.
shopping.
ski.
theater.
viewpoint.
water_parks_and_amusement_parks.
zoos_and_aquariums.

distance Int

The distance from the hotel to the point of interest, in meters.

Errors

The error field has the value specified in the headers below.

`dump_not_ready`

The dump is in processing. Try to send the request later.