WEwego
Places

Resolve travel locations

Changed on

Resolves a free-text location query to canonical Wego places (cities, airports, states, districts, hotels) with codes and coordinates, for use in later flight and hotel searches. When metadata.hasAmbiguity is true, clarify with the user before proceeding.

get/v1/places

Request

  • Base URL
    https://api.wego.com
  • Auth
    • OAuth 2
      Authorization codehttps://auth.wego.com/user-auth/v2/users/oauth/authorize
      Token URLhttps://auth.wego.com/user-auth/v2/users/oauth/token
    • or HTTP bearer
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Query parameters

querystring required
Example:dubai

Free text to resolve to typed places with codes. A place-name search (city, airport, district, hotel).

typesstring[]

Place types to resolve; repeat or comma-separate to mix.

localestring

Language tag for localized place names (e.g. en, ar). Omitted, the search is language-neutral: the query matches names in any language (sent upstream as the locale wildcard) and results carry canonical English names. Pass a tag to localize the returned names instead. getNearbyPlaces, by contrast, defaults to en.

pageinteger

Page number, 1-based (max 100). Defaults to 1.

pageSizeinteger

Results per page (1-50). Defaults to 10.

Response

Matching places plus pagination/ambiguity metadata.

Changes

  • 10fbc4e6f532Revision changes
    • warning

      added the new rates_require_hotel_search enum value to the response property for the response status

    • warning

      added the new rates_require_hotel_search enum value to the response property for the response status

    • warning

      added the new rates_require_hotel_search enum value to the response property for the response status

    • warning

      added the new rates_require_hotel_search enum value to the response property for the response status

    • warning

      added the new rates_require_hotel_search enum value to the response property for the response status