Contact Us
Company
  • Proven Superior Accuracy
  • About AccuWeather
  • Digital Advertising
  • Careers
  • Press
  • Privacy
  • Terms of Use
  • Brand Guidelines
Products & Services
  • For Business
  • For Partners
  • For Advertising
  • AccuWeather Enterprise APIs
  • AccuWeather Connect
  • Personal Weather Stations
Subscription Services
  • AccuWeather Premium
  • AccuWeather Professional
Apps & Downloads
  • iPhone App
  • Android App
  • See all Apps & Downloads

© 2025 AccuWeather, Inc.

xXfacebookFacebookinstagramInstagram
  • Home
  • Documentation
  • Core Weather API
  • MinuteCastâ„¢ API
  • Pricing
  • FAQ
Current Conditions
    Location Key
      Current conditions by location keyget
    Top Cities
      Current conditions for top citiesget
    Historical
      Historical current conditions for past 24 hours by location keygetHistorical current conditions for past 6 hours by location keyget
Daily Forecasts
    Location Key
      1 day by location keyget5 days by location key get7 days by location key get10 days by location key get15 days by location key get
Hourly Forecasts
    Location Key
      1 hour by location key get12 hours by location key get24 hours by location key get72 hours by location keyget120 hours by location key get
Alerts
    Location Key
      Goverment-issued alerts by location keyget
Locations
    Location Key
      Neighboring location data by location keygetLocation search by location keyget
    List
      Top 50 cities listgetTop 100 cities listgetTop 150 cities listgetTop cities list by regiongetCountries list by region codegetCountries listgetRegion listgetCountry by region code and country codegetAdministrative area list by country codegetAdministrative area list get
    Autocomplete
      Autocomplete by country codegetAutocomplete for cities and points of interest getAutocomplete for points of interest by country codegetAutocomplete for points of interestgetAutocomplete for cities by country codegetAutocomplete for citiesget
    Text Search
      City search by country code and administrative codegetCity search by country codegetCity searchgetLocation search by country code and administrative codegetLocation search by country codegetLocation searchgetPostal code search by country codegetPostal code searchgetPoint of interest by country code and administrative codegetPoint of interest by country codegetPoint of interest searchgetRegion searchgetAdministrative area search by country code and text stringgetAdministrative area search by text stringgetAdministrative area search by country code and administrative area codeget
    Geoposition
      Cities search by geopositiongetLocation search by geopositiongetPoint of interest by latitude, longitudeget
    IP Address
      Cities search by IP addressget
Indices
    1 Day
      1 day by location key and group Idget1 day by location keyget1 day by location key and index Idget
    5 Days
      5 days by location key and group id get5 days by location keyget5 days by location key and index id get
    10 Days
      10 days by location key and group idget10 days by location keyget10 days by location key and index idget
    15 Days
      15 days by location key and group idget15 days by location keyget15 days by location key and index idget
    Metadata
      Index groupsgetIndex metadata by group idgetIndex metadatagetIndex metadata by index Idget
Tropical
    Active
      Active government-issued storms by basin and government IdgetActive government-issued stormsgetActive government-issued storms by basinget
    Search
      Government-issued storms by year, basin, and government IdgetGovernment-issued storms by yeargetGovernment-issued storms by year and basingetStatuses for government-issued stormsgetStatuses for government-issued storms by basinget
    Position
      Current position of government-issued storm by year, basin, and government IdgetPositions of government-issued storm by year, basin, and government Idget
    Forecast
      Forecasts of government-issued storm by year, basin, and government Idget
Alarms
    Location Key
      1 day by location keyget5 days by location keyget10 days by location keyget15 days by location keyget
Imagery Maps
    Location Key
      480x480 radar and satellite images by location keyget640x480 radar and satellite images by location keyget1024x1024 radar and satellite images by location keyget
Translations
    Groups
      Translations by group idgetTranslation groupsget
    Languages
      Supported languagesgetLanguage id by language codegetLanguage code by language idget
Schemas
Core Weather
Core Weather

Autocomplete

Endpointhttps://dataservice.accuweather.com

Autocomplete by country code

GET
https://dataservice.accuweather.com
/locations/v1/{countryCode}/autocomplete

Search for locations with a country code and an incomplete city name. Use the q parameter to search any partial name.

Autocomplete by country code › path Parameters

countryCode
string

A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.

Example: US

Autocomplete by country code › query Parameters

q
string · required

A string that indicates a partial city or point of interest name to search by.

Example: New York
language
string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us
includeAliases
boolean

A boolean indicating whether or not to include alias location results.

Default: false
format
string

A string value that specifies what type of format to provide the response.

Default: json

Autocomplete by country code › Headers

Authorization
string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Autocomplete by country code › Responses

OK

object[]
Version
integer · int32 · required

Current version of the API

Key
string · minLength: 1 · required

Unique ID to search a location

Type
string · minLength: 1 · required

Location type such as City, PostalCode, POI or LatLong

Rank
integer · int32 · required

Number applied to locations set by factors such as population, political importance, and geographic size

LocalizedName
string · minLength: 1 · required

Display name in local dialect set with language code in URL. Default is US English (us-en)

object · required
object · required
GET/locations/v1/{countryCode}/autocomplete
curl --request GET \
  --url 'https://dataservice.accuweather.com/locations/v1/:countryCode/autocomplete?q=%3Cstring%3E' \
  --header 'Authorization: Bearer YOUR_API_KEY'
shell
Example Responses
[
  {
    "Version": 0,
    "Key": "Key",
    "Type": "Type",
    "Rank": 0,
    "LocalizedName": "LocalizedName",
    "Country": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "AdministrativeArea": {
      "Level": 0,
      "LocalizedType": {},
      "EnglishType": {},
      "CountryID": "CountryID",
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    }
  }
]
json
application/json

Autocomplete for cities and points of interest

GET
https://dataservice.accuweather.com
/locations/v1/autocomplete

Search for cities or points of interest around the world with an incomplete text string. Use the q parameter to search any partial name.

The Autocomplete feature enhances the user experience by enabling intelligent and responsive location search capabilities:

  • Fully supports all language localizations.
  • Optimized for Latin-based languages to ensure the most accurate results.
  • Returns the top 10 verified city results, ordered by relevance rank.
  • Responses are truncated for Autocomplete queries to maintain speed and clarity.

Autocomplete for cities and points of interest › query Parameters

q
string · required

A string that indicates a partial city or point of interest name to search by.

Example: New York
language
string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us
countryCode
string

A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.

Example: US
includeAliases
boolean

A boolean indicating whether or not to include alias location results.

Default: false
format
string

A string value that specifies what type of format to provide the response.

Default: json

Autocomplete for cities and points of interest › Headers

Authorization
string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Autocomplete for cities and points of interest › Responses

OK

object[]
Version
integer · int32 · required

Current version of the API

Key
string · minLength: 1 · required

Unique ID to search a location

Type
string · minLength: 1 · required

Location type such as City, PostalCode, POI or LatLong

Rank
integer · int32 · required

Number applied to locations set by factors such as population, political importance, and geographic size

LocalizedName
string · minLength: 1 · required

Display name in local dialect set with language code in URL. Default is US English (us-en)

object · required
object · required
GET/locations/v1/autocomplete
curl --request GET \
  --url 'https://dataservice.accuweather.com/locations/v1/autocomplete?q=%3Cstring%3E' \
  --header 'Authorization: Bearer YOUR_API_KEY'
shell
Example Responses
[
  {
    "Version": 0,
    "Key": "Key",
    "Type": "Type",
    "Rank": 0,
    "LocalizedName": "LocalizedName",
    "Country": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "AdministrativeArea": {
      "Level": 0,
      "LocalizedType": {},
      "EnglishType": {},
      "CountryID": "CountryID",
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    }
  }
]
json
application/json

Autocomplete for points of interest by country code

GET
https://dataservice.accuweather.com
/locations/v1/poi/{countryCode}/autocomplete

Filter by country code and search for points of interest (POIs) using an incomplete text string. Use the q parameter to search any partial name.

A point of interest (POI) typically refers to a business location, tourist attraction, or other well-known site. Common examples include:

  • Airports
  • Stadiums
  • Parks

The Autocomplete feature enhances the user experience by enabling intelligent and responsive location search capabilities:

  • Fully supports all language localizations.
  • Optimized for Latin-based languages to ensure the most accurate results.
  • Returns the top 10 verified city results, ordered by relevance rank.
  • Responses are truncated for Autocomplete queries to maintain speed and clarity.

Autocomplete for points of interest by country code › path Parameters

countryCode
string

A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.

Example: US

Autocomplete for points of interest by country code › query Parameters

q
string · required

A string that indicates a partial point of interest name to search by.

Example: New York
language
string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us
includeAliases
boolean

A boolean indicating whether or not to include alias location results.

Default: false
format
string

A string value that specifies what type of format to provide the response.

Default: json

Autocomplete for points of interest by country code › Headers

Authorization
string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Autocomplete for points of interest by country code › Responses

OK

object[]
Version
integer · int32 · required

Current version of the API

Key
string · minLength: 1 · required

Unique ID to search a location

Type
string · minLength: 1 · required

Location type such as City, PostalCode, POI or LatLong

Rank
integer · int32 · required

Number applied to locations set by factors such as population, political importance, and geographic size

LocalizedName
string · minLength: 1 · required

Display name in local dialect set with language code in URL. Default is US English (us-en)

object · required
object · required
GET/locations/v1/poi/{countryCode}/autocomplete
curl --request GET \
  --url 'https://dataservice.accuweather.com/locations/v1/poi/:countryCode/autocomplete?q=%3Cstring%3E' \
  --header 'Authorization: Bearer YOUR_API_KEY'
shell
Example Responses
[
  {
    "Version": 0,
    "Key": "Key",
    "Type": "Type",
    "Rank": 0,
    "LocalizedName": "LocalizedName",
    "Country": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "AdministrativeArea": {
      "Level": 0,
      "LocalizedType": {},
      "EnglishType": {},
      "CountryID": "CountryID",
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    }
  }
]
json
application/json

Autocomplete for points of interest

GET
https://dataservice.accuweather.com
/locations/v1/poi/autocomplete

Search for points of interest (POIs) using an incomplete text string. Use the q parameter to search any partial name.

A point of interest (POI) typically refers to a business location, tourist attraction, or other well-known site. Common examples include:

  • Airports
  • Stadiums
  • Parks

The Autocomplete feature enhances the user experience by enabling intelligent and responsive location search capabilities:

  • Fully supports all language localizations.
  • Optimized for Latin-based languages to ensure the most accurate results.
  • Returns the top 10 verified city results, ordered by relevance rank.
  • Responses are truncated for Autocomplete queries to maintain speed and clarity.

Autocomplete for points of interest › query Parameters

q
string · required

A string that indicates a partial point of interest name to search by.

Example: New York
language
string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us
countryCode
string

A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.

Example: US
includeAliases
boolean

A boolean indicating whether or not to include alias location results.

Default: false
format
string

A string value that specifies what type of format to provide the response.

Default: json

Autocomplete for points of interest › Headers

Authorization
string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Autocomplete for points of interest › Responses

OK

object[]
Version
integer · int32 · required

Current version of the API

Key
string · minLength: 1 · required

Unique ID to search a location

Type
string · minLength: 1 · required

Location type such as City, PostalCode, POI or LatLong

Rank
integer · int32 · required

Number applied to locations set by factors such as population, political importance, and geographic size

LocalizedName
string · minLength: 1 · required

Display name in local dialect set with language code in URL. Default is US English (us-en)

object · required
object · required
GET/locations/v1/poi/autocomplete
curl --request GET \
  --url 'https://dataservice.accuweather.com/locations/v1/poi/autocomplete?q=%3Cstring%3E' \
  --header 'Authorization: Bearer YOUR_API_KEY'
shell
Example Responses
[
  {
    "Version": 0,
    "Key": "Key",
    "Type": "Type",
    "Rank": 0,
    "LocalizedName": "LocalizedName",
    "Country": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "AdministrativeArea": {
      "Level": 0,
      "LocalizedType": {},
      "EnglishType": {},
      "CountryID": "CountryID",
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    }
  }
]
json
application/json

Autocomplete for cities by country code

GET
https://dataservice.accuweather.com
/locations/v1/cities/{countryCode}/autocomplete

Specify a country code and search for cities around the world with a incomplete text string. Use the q parameter to search any partial name.

The Autocomplete feature enhances the user experience by enabling intelligent and responsive location search capabilities:

  • Fully supports all language localizations.
  • Optimized for Latin-based languages to ensure the most accurate results.
  • Returns the top 10 verified city results, ordered by relevance rank.
  • Responses are truncated for Autocomplete queries to maintain speed and clarity.

Autocomplete for cities by country code › path Parameters

countryCode
string

A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.

Example: US

Autocomplete for cities by country code › query Parameters

q
string · required

A string that indicates a partial city name to search by.

Example: New York
language
string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us
includeAliases
boolean

A boolean indicating whether or not to include alias location results.

Default: false
format
string

A string value that specifies what type of format to provide the response.

Default: json

Autocomplete for cities by country code › Headers

Authorization
string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Autocomplete for cities by country code › Responses

OK

object[]
Version
integer · int32 · required

Current version of the API

Key
string · minLength: 1 · required

Unique ID to search a location

Type
string · minLength: 1 · required

Location type such as City, PostalCode, POI or LatLong

Rank
integer · int32 · required

Number applied to locations set by factors such as population, political importance, and geographic size

LocalizedName
string · minLength: 1 · required

Display name in local dialect set with language code in URL. Default is US English (us-en)

object · required
object · required
GET/locations/v1/cities/{countryCode}/autocomplete
curl --request GET \
  --url 'https://dataservice.accuweather.com/locations/v1/cities/:countryCode/autocomplete?q=%3Cstring%3E' \
  --header 'Authorization: Bearer YOUR_API_KEY'
shell
Example Responses
[
  {
    "Version": 0,
    "Key": "Key",
    "Type": "Type",
    "Rank": 0,
    "LocalizedName": "LocalizedName",
    "Country": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "AdministrativeArea": {
      "Level": 0,
      "LocalizedType": {},
      "EnglishType": {},
      "CountryID": "CountryID",
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    }
  }
]
json
application/json

Autocomplete for cities

GET
https://dataservice.accuweather.com
/locations/v1/cities/autocomplete

Search for cities around the world with an incomplete text string. Use the q parameter to search any partial name.

The Autocomplete feature enhances the user experience by enabling intelligent and responsive location search capabilities:

  • Fully supports all language localizations.
  • Optimized for Latin-based languages to ensure the most accurate results.
  • Returns the top 10 verified city results, ordered by relevance rank.
  • Responses are truncated for Autocomplete queries to maintain speed and clarity.

Autocomplete for cities › query Parameters

q
string · required

A string that indicates a partial city name to search by.

Example: New York
language
string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us
countryCode
string

A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.

Example: US
includeAliases
boolean

A boolean indicating whether or not to include alias location results.

Default: false
format
string

A string value that specifies what type of format to provide the response.

Default: json

Autocomplete for cities › Headers

Authorization
string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Autocomplete for cities › Responses

OK

object[]
Version
integer · int32 · required

Current version of the API

Key
string · minLength: 1 · required

Unique ID to search a location

Type
string · minLength: 1 · required

Location type such as City, PostalCode, POI or LatLong

Rank
integer · int32 · required

Number applied to locations set by factors such as population, political importance, and geographic size

LocalizedName
string · minLength: 1 · required

Display name in local dialect set with language code in URL. Default is US English (us-en)

object · required
object · required
GET/locations/v1/cities/autocomplete
curl --request GET \
  --url 'https://dataservice.accuweather.com/locations/v1/cities/autocomplete?q=%3Cstring%3E' \
  --header 'Authorization: Bearer YOUR_API_KEY'
shell
Example Responses
[
  {
    "Version": 0,
    "Key": "Key",
    "Type": "Type",
    "Rank": 0,
    "LocalizedName": "LocalizedName",
    "Country": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "AdministrativeArea": {
      "Level": 0,
      "LocalizedType": {},
      "EnglishType": {},
      "CountryID": "CountryID",
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    }
  }
]
json
application/json
ListText Search