The AccuWeather connector lets your AI agent act in each user's AccuWeather account. Each user connects their own AccuWeather access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 30 tools.
- Tools
- 30
- What they doRead · write · destructive
- 30 · 0 · 030 read0 write0 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the AccuWeather connection
In AgentKit > Connections, create an AccuWeather connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'accuweather'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize AccuWeather:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'accuweather_get_top_cities_current_conditions',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "accuweather"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize AccuWeather:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="accuweather_get_top_cities_current_conditions",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their AccuWeather credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolaccuweather_autocomplete_citiesSuggest AccuWeather cities that match partial text, for type-ahead search.Read-onlyAutocomplete Cities
Suggest AccuWeather cities that match partial text, for type-ahead search. Returns up to 10 cities ranked by relevance, each with its location key, name, administrative area and country (a shortened record). Use this for incomplete names as a user types. Use accuweather_search_cities for a full city name with filters and paging, and accuweather_autocomplete_locations to include points of interest.
Inputs
qstringrequired- Partial city name to complete. Example: San Fr
country_codestring- Two-letter ISO 3166-1 country code that restricts results to one country. Example: US
include_aliasesboolean- Set to true to include alias (alternative) place names in the matches. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
accuweather_autocomplete_locationsSuggest AccuWeather cities and points of interest that match partial text, for type-ahead search.Read-onlyAutocomplete Locations
Suggest AccuWeather cities and points of interest that match partial text, for type-ahead search. Returns up to 10 matches ranked by relevance, each with its location key, type, name, administrative area and country (a shortened record). Use this when the user may be typing a landmark as well as a city. Use accuweather_autocomplete_cities for cities only.
Inputs
qstringrequired- Partial city or point-of-interest name to complete. Example: Golden Ga
country_codestring- Two-letter ISO 3166-1 country code that restricts results to one country. Example: US
include_aliasesboolean- Set to true to include alias (alternative) place names in the matches. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
accuweather_get_current_conditionsGet the current observed weather for one AccuWeather location.Read-onlyGet Current Conditions
Get the current observed weather for one AccuWeather location. Returns the observation time, weather text and icon, temperature, RealFeel temperature, whether it is day, and precipitation flags; with details=true it adds humidity, wind, UV index, visibility, cloud cover, pressure and past-24-hour summaries. Use this for weather right now. Use accuweather_get_historical_conditions for the past 24 hours and accuweather_get_hourly_forecast for the coming hours. Requires a location key from a location search tool such as accuweather_search_cities.
Inputs
location_keystringrequired- AccuWeather location key for the place. Get it from the Key field returned by accuweather_search_cities, accuweather_search_by_postal_code, accuweather_search_by_geoposition or accuweather_autocomplete_cities. Example: 349727 (New York, NY).
detailsboolean- Set to true to include extended information in each result. Defaults to false.
get_photosboolean- Set to true to include photos that represent the location and the current weather. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
accuweather_get_daily_forecastGet the daily weather forecast for one AccuWeather location for 1, 5, 7, 10 or 15 days.Read-onlyGet Daily Forecast
Get the daily weather forecast for one AccuWeather location for 1, 5, 7, 10 or 15 days. Returns a headline plus one entry per day with minimum and maximum temperature and day and night weather text and icons; with details=true it adds RealFeel, wind, precipitation amounts and probability, sun and moon times, air quality and hours of sun. Use this for day-by-day outlooks. Use accuweather_get_hourly_forecast for hour-by-hour detail and accuweather_get_current_conditions for weather right now. Requires a location key from a location search tool such as accuweather_search_cities.
Inputs
location_keystringrequired- AccuWeather location key for the place. Get it from the Key field returned by accuweather_search_cities, accuweather_search_by_postal_code, accuweather_search_by_geoposition or accuweather_autocomplete_cities. Example: 349727 (New York, NY).
detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
metricboolean- Set to true to return metric units (Celsius, km/h, millimeters). False or omitted returns imperial units (Fahrenheit, mph, inches).
periodstring- Number of forecast days to return. One of 1day, 5day, 7day, 10day, 15day. Defaults to 5day. Longer periods need a higher AccuWeather plan; a key whose plan does not include the period gets a 403 error. Example: 5dayone of
1day5day7day10day15daydefault5day
accuweather_get_daily_indexGet one AccuWeather daily lifestyle or health index for one location over 1, 5, 10 or 15 days.Read-onlyGet Daily Index
Get one AccuWeather daily lifestyle or health index for one location over 1, 5, 10 or 15 days. Returns one entry per day with the index name, value, category (for example Good or Poor) and a short text. Use this for a single index such as Running (1) or Arthritis Pain (21). Use accuweather_get_daily_indices for all indices and accuweather_list_indices to find index ids. Requires a location key from a location search tool such as accuweather_search_cities.
Inputs
index_idstringrequired- Id of the index, as returned in the ID field of accuweather_list_indices. Some ids are negative, such as -10 for Air Quality. Example: 1 (Running)
location_keystringrequired- AccuWeather location key for the place. Get it from the Key field returned by accuweather_search_cities, accuweather_search_by_postal_code, accuweather_search_by_geoposition or accuweather_autocomplete_cities. Example: 349727 (New York, NY).
detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
periodstring- Number of days of index values to return. One of 1day, 5day, 10day, 15day. Defaults to 1day. Longer periods need a higher AccuWeather plan; a key whose plan does not include the period gets a 403 error. Example: 1dayone of
1day5day10day15daydefault1day
accuweather_get_daily_index_groupGet one group of related AccuWeather daily indices for one location over 1, 5, 10 or 15 days.Read-onlyGet Daily Index Group
Get one group of related AccuWeather daily indices for one location over 1, 5, 10 or 15 days. Returns one entry per index per day for every index in the group, with the index name, value, category and a short text. Use this for a theme such as allergies or outdoor sports. Use accuweather_list_index_groups to find group ids and accuweather_get_daily_index for a single index. Requires a location key from a location search tool such as accuweather_search_cities.
Inputs
group_idstringrequired- Id of the index group, as returned in the ID field of accuweather_list_index_groups. Example: 1
location_keystringrequired- AccuWeather location key for the place. Get it from the Key field returned by accuweather_search_cities, accuweather_search_by_postal_code, accuweather_search_by_geoposition or accuweather_autocomplete_cities. Example: 349727 (New York, NY).
detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
periodstring- Number of days of index values to return. One of 1day, 5day, 10day, 15day. Defaults to 1day. Longer periods need a higher AccuWeather plan; a key whose plan does not include the period gets a 403 error. Example: 1dayone of
1day5day10day15daydefault1day
accuweather_get_daily_indicesGet every AccuWeather daily lifestyle and health index for one location over 1, 5, 10 or 15 days.Read-onlyGet Daily Indices
Get every AccuWeather daily lifestyle and health index for one location over 1, 5, 10 or 15 days. Returns one entry per index per day with the index name and id, value, category (for example Good or Poor) and a short text; indices cover activities like running and golf, health like arthritis and allergies, and travel like flight delays. Use this to see all indices at once. Use accuweather_get_daily_index for a single index and accuweather_get_daily_index_group for one group of related indices. Requires a location key from a location search tool such as accuweather_search_cities.
Inputs
location_keystringrequired- AccuWeather location key for the place. Get it from the Key field returned by accuweather_search_cities, accuweather_search_by_postal_code, accuweather_search_by_geoposition or accuweather_autocomplete_cities. Example: 349727 (New York, NY).
detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
periodstring- Number of days of index values to return. One of 1day, 5day, 10day, 15day. Defaults to 1day. Longer periods need a higher AccuWeather plan; a key whose plan does not include the period gets a 403 error. Example: 1dayone of
1day5day10day15daydefault1day
accuweather_get_historical_conditionsGet the hourly observed weather for one AccuWeather location over the past 24 hours.Read-onlyGet Historical Conditions
Get the hourly observed weather for one AccuWeather location over the past 24 hours. Returns one observation per hour with time, weather text and icon, temperature and precipitation flags; with details=true each observation adds humidity, wind, UV index, visibility, pressure and more. Use this for recent past weather. Use accuweather_get_current_conditions for the latest observation only. Requires a location key from a location search tool such as accuweather_search_cities.
Inputs
location_keystringrequired- AccuWeather location key for the place. Get it from the Key field returned by accuweather_search_cities, accuweather_search_by_postal_code, accuweather_search_by_geoposition or accuweather_autocomplete_cities. Example: 349727 (New York, NY).
detailsboolean- Set to true to include extended information in each result. Defaults to false.
get_photosboolean- Set to true to include photos that represent the location and the current weather. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
accuweather_get_hourly_forecastGet the hour-by-hour weather forecast for one AccuWeather location for the next 1, 12, 24, 72 or 120 hours.Read-onlyGet Hourly Forecast
Get the hour-by-hour weather forecast for one AccuWeather location for the next 1, 12, 24, 72 or 120 hours. Returns one entry per hour with time, weather text and icon, temperature, and precipitation probability; with details=true it adds RealFeel, wind, humidity, UV index, visibility, cloud cover and precipitation amounts. Use this for the coming hours. Use accuweather_get_daily_forecast for day-by-day outlooks and accuweather_get_current_conditions for weather right now. Requires a location key from a location search tool such as accuweather_search_cities.
Inputs
location_keystringrequired- AccuWeather location key for the place. Get it from the Key field returned by accuweather_search_cities, accuweather_search_by_postal_code, accuweather_search_by_geoposition or accuweather_autocomplete_cities. Example: 349727 (New York, NY).
detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
metricboolean- Set to true to return metric units (Celsius, km/h, millimeters). False or omitted returns imperial units (Fahrenheit, mph, inches).
periodstring- Number of forecast hours to return. One of 1hour, 12hour, 24hour, 72hour, 120hour. Defaults to 12hour. Longer periods need a higher AccuWeather plan; a key whose plan does not include the period gets a 403 error. Example: 12hourone of
1hour12hour24hour72hour120hourdefault12hour
accuweather_get_locationGet the AccuWeather location record for one location key.Read-onlyGet Location
Get the AccuWeather location record for one location key. Returns the location's name, type, administrative area, country, region, coordinates, elevation and time zone; with details=true it adds data sources and supplemental administrative areas. Use this to describe a location key you already have. Use the search tools, such as accuweather_search_cities, to find a location key.
Inputs
location_keystringrequired- AccuWeather location key for the place. Get it from the Key field returned by accuweather_search_cities, accuweather_search_by_postal_code, accuweather_search_by_geoposition or accuweather_autocomplete_cities. Example: 349727 (New York, NY).
detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
accuweather_get_radar_satellite_mapsGet radar and satellite map images centered on one AccuWeather location.Read-onlyGet Radar and Satellite Maps
Get radar and satellite map images centered on one AccuWeather location. Returns lists of image URLs with their timestamps for radar and satellite frames (satellite only where radar is not available), which can be shown in order as an animation. Use this to show a weather map. Use accuweather_get_current_conditions for observed weather as data. Requires a location key from a location search tool such as accuweather_search_cities.
Inputs
location_keystringrequired- AccuWeather location key for the place. Get it from the Key field returned by accuweather_search_cities, accuweather_search_by_postal_code, accuweather_search_by_geoposition or accuweather_autocomplete_cities. Example: 349727 (New York, NY).
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
sizestring- Image size in pixels: 480x480, 640x480 or 1024x1024. Defaults to 640x480. Example: 1024x1024one of
480x480640x4801024x1024default640x480
accuweather_get_top_cities_current_conditionsGet the current weather for the world's 50, 100 or 150 largest cities in one call.Read-onlyGet Top Cities Current Conditions
Get the current weather for the world's 50, 100 or 150 largest cities in one call. Returns one entry per city with its location key, name, country, time zone, observation time, weather text and icon, and temperature. Use this for a global snapshot. Use accuweather_get_current_conditions for one specific location.
Inputs
countstring- How many of the world's largest cities to include: 50, 100 or 150. Defaults to 50. Example: 100one of
50100150default50 languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
accuweather_get_tropical_storm_current_positionGet the latest position of one government-issued tropical cyclone.Read-onlyGet Tropical Storm Current Position
Get the latest position of one government-issued tropical cyclone. Returns the storm's latitude and longitude, status, maximum sustained wind and gusts, minimum pressure, direction and speed of movement, and distances to nearby landmarks. Use this for where a storm is now. Use accuweather_get_tropical_storm_forecast for its predicted track. Requires the year, basin and storm number from accuweather_list_active_tropical_storms.
Inputs
basinstringrequired- Ocean basin code of the storm, as returned in the basinId field of accuweather_list_active_tropical_storms: AL Atlantic, CP Central Pacific, EP Eastern Pacific, NI North Indian Ocean, NP Northwest Pacific, SI South Indian Ocean, SP Southwest Pacific. Example: ALone of
ALCPEPNINPSISP gov_idintegerrequired- Government-issued storm number within the basin and year, as returned in the govId field of accuweather_list_active_tropical_storms. Example: 2
yearintegerrequired- Four-digit year the storm formed in, as returned in the year field of accuweather_list_active_tropical_storms. Example: 2026
detailsboolean- Set to true to include extended information in each result. Defaults to false.
include_landmarksboolean- Set to false to leave out distances to nearby landmarks. Defaults to true.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
radii_geometryboolean- Set to true to include wind radii summary data (how far winds of each strength extend). Defaults to false.
accuweather_get_tropical_storm_forecastGet the forecast track of one government-issued tropical cyclone.Read-onlyGet Tropical Storm Forecast
Get the forecast track of one government-issued tropical cyclone. Returns one entry per forecast time with the predicted position, status, maximum sustained wind and gusts; window and wind radii geometry are added on request. Use this for where a storm is heading. Use accuweather_get_tropical_storm_current_position for where it is now. Requires the year, basin and storm number from accuweather_list_active_tropical_storms.
Inputs
basinstringrequired- Ocean basin code of the storm, as returned in the basinId field of accuweather_list_active_tropical_storms: AL Atlantic, CP Central Pacific, EP Eastern Pacific, NI North Indian Ocean, NP Northwest Pacific, SI South Indian Ocean, SP Southwest Pacific. Example: ALone of
ALCPEPNINPSISP gov_idintegerrequired- Government-issued storm number within the basin and year, as returned in the govId field of accuweather_list_active_tropical_storms. Example: 2
yearintegerrequired- Four-digit year the storm formed in, as returned in the year field of accuweather_list_active_tropical_storms. Example: 2026
detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
radii_geometryboolean- Set to true to include wind radii summary data (how far winds of each strength extend). Defaults to false.
window_geometryboolean- Set to true to include the forecast uncertainty window (cone) geometry. Defaults to false.
accuweather_get_weather_alarmsGet AccuWeather weather alarms for one location over 1, 5, 10 or 15 days.Read-onlyGet Weather Alarms
Get AccuWeather weather alarms for one location over 1, 5, 10 or 15 days. An alarm is raised when the daily forecast meets an AccuWeather threshold for extreme temperature, heavy rain, snow, ice or high wind. Returns one entry per day that has alarms, with each alarm's type and forecast values for the day and night; an empty list means no alarms. Use this for forecast-based extreme weather flags. Use accuweather_get_weather_alerts for official government warnings. Requires a location key from a location search tool such as accuweather_search_cities.
Inputs
location_keystringrequired- AccuWeather location key for the place. Get it from the Key field returned by accuweather_search_cities, accuweather_search_by_postal_code, accuweather_search_by_geoposition or accuweather_autocomplete_cities. Example: 349727 (New York, NY).
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
periodstring- Number of days to check for alarms. One of 1day, 5day, 10day, 15day. Defaults to 1day. Longer periods need a higher AccuWeather plan; a key whose plan does not include the period gets a 403 error. Example: 1dayone of
1day5day10day15daydefault1day
accuweather_get_weather_alertsGet active severe weather alerts for one AccuWeather location, issued by government meteorological agencies and other alert providers.Read-onlyGet Weather Alerts
Get active severe weather alerts for one AccuWeather location, issued by government meteorological agencies and other alert providers. Returns each alert's id, category, priority, description, issuing source, and the areas and time window it covers; an empty list means no active alerts. Use this for official warnings and watches. Use accuweather_get_weather_alarms for AccuWeather's own forecast-threshold alarms. Requires a location key from a location search tool such as accuweather_search_cities.
Inputs
location_keystringrequired- AccuWeather location key for the place. Get it from the Key field returned by accuweather_search_cities, accuweather_search_by_postal_code, accuweather_search_by_geoposition or accuweather_autocomplete_cities. Example: 349727 (New York, NY).
detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
accuweather_list_active_tropical_stormsList all active government-issued tropical cyclones (hurricanes, typhoons and tropical storms) across every ocean basin.Read-onlyList Active Tropical Storms
List all active government-issued tropical cyclones (hurricanes, typhoons and tropical storms) across every ocean basin. Returns each storm's name, year, basin id and government storm number, and whether it is still active. Use this to find current storms. Use accuweather_get_tropical_storm_current_position and accuweather_get_tropical_storm_forecast for one storm's details.
Inputs
This tool takes no inputs.
accuweather_list_admin_areasList the administrative areas (states, provinces or regions) of one country in AccuWeather.Read-onlyList Administrative Areas
List the administrative areas (states, provinces or regions) of one country in AccuWeather. Returns each area's code, localized and English name, level and country. Use this to find an admin_code for accuweather_search_cities or accuweather_search_locations. Use accuweather_list_countries to find country codes.
Inputs
country_codestringrequired- Two-letter ISO 3166-1 code of the country whose areas to list. Example: US
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
offsetinteger- Page of results to return. Results come in sets of 25: 0 returns the first 25, 1 the next 25, and so on. Omit to return the API's default result set. Example: 0
accuweather_list_countriesList the countries AccuWeather covers, optionally for one region.Read-onlyList Countries
List the countries AccuWeather covers, optionally for one region. Returns each country's two-letter code, localized name and English name. Use this to find a country_code for the search tools. Use accuweather_list_admin_areas for states and provinces within a country.
Inputs
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
region_codestring- Region code that restricts the list to one region: AFR Africa, ANT Antarctica, ARC Arctic, ASI Asia, CAC Central America, EUR Europe, MEA Middle East, NAM North America, OCN Oceania, SAM South America. Example: EURone of
AFRANTARCASICACEURMEANAMOCNSAM
accuweather_list_index_groupsList the groups that AccuWeather daily indices are organized into.Read-onlyList Index Groups
List the groups that AccuWeather daily indices are organized into. Returns each group's id, name and description. Use this to find a group id for accuweather_get_daily_index_group. Use accuweather_list_indices for individual index ids.
Inputs
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
accuweather_list_indicesList every AccuWeather daily index with its metadata.Read-onlyList Indices
List every AccuWeather daily index with its metadata. Returns each index's id, name, description and whether a higher value is better. Use this to find an index id for accuweather_get_daily_index. Use accuweather_list_index_groups for group ids.
Inputs
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
accuweather_list_languagesList the languages AccuWeather can return text in.Read-onlyList Languages
List the languages AccuWeather can return text in. Returns each language's id, ISO code (for example en-us), name, display name and localized name. Use this to find a value for the language input of the other AccuWeather tools.
Inputs
This tool takes no inputs.
accuweather_list_neighboring_citiesList the cities that neighbor one AccuWeather city location.Read-onlyList Neighboring Cities
List the cities that neighbor one AccuWeather city location. Returns nearby cities with their location key, name, administrative area, country and coordinates. Use this to suggest nearby places for a city you already have. Use accuweather_search_by_geoposition to find the city at a coordinate. Requires a city location key from a location search tool such as accuweather_search_cities.
Inputs
location_keystringrequired- AccuWeather location key for the place. Get it from the Key field returned by accuweather_search_cities, accuweather_search_by_postal_code, accuweather_search_by_geoposition or accuweather_autocomplete_cities. Example: 349727 (New York, NY).
detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
accuweather_list_top_citiesList the world's 50, 100 or 150 largest cities as AccuWeather locations.Read-onlyList Top Cities
List the world's 50, 100 or 150 largest cities as AccuWeather locations. Returns each city with its location key, name, administrative area, country, coordinates and time zone. Use this for a ready-made list of major city location keys. Use accuweather_get_top_cities_current_conditions to get the current weather for the same cities.
Inputs
countstring- How many of the world's largest cities to list: 50, 100 or 150. Defaults to 50. Example: 100one of
50100150default50 detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
accuweather_search_by_geopositionFind the AccuWeather city location nearest to a latitude and longitude.Read-onlySearch by Coordinates
Find the AccuWeather city location nearest to a latitude and longitude. Returns one location with its location key, name, administrative area, country, coordinates and time zone. Use this when you have GPS coordinates. Use accuweather_search_cities for a city name and accuweather_search_city_by_ip for an IP address.
Inputs
latitudenumberrequired- Latitude in decimal degrees, from -90 to 90. Example: 40.779
longitudenumberrequired- Longitude in decimal degrees, from -180 to 180. Example: -73.969
detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
top_levelboolean- Set to true to return the highest-ranked location for the point (for example the city rather than the neighborhood inside it). Defaults to false.
accuweather_search_by_postal_codeLook up AccuWeather locations by ZIP or postal code.Read-onlySearch by Postal Code
Look up AccuWeather locations by ZIP or postal code. Returns matching postal code locations with their location key, name, administrative area, country and coordinates. Use this when you have a postal code. Use accuweather_search_cities for a city name and accuweather_search_by_geoposition for coordinates.
Inputs
postal_codestringrequired- ZIP or postal code to look up. Some codes exist in several countries, so add country_code to narrow the match. Example: 10001
country_codestring- Two-letter ISO 3166-1 country code that restricts results to one country. Example: US
detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
accuweather_search_citiesSearch AccuWeather for cities by name, optionally narrowed to a country or state.Read-onlySearch Cities
Search AccuWeather for cities by name, optionally narrowed to a country or state. Returns matching cities with their location key, localized name, administrative area, country, coordinates and time zone. Use this to turn a city name into a location key. Use accuweather_autocomplete_cities for partial text as a user types, accuweather_search_by_postal_code for a ZIP or postal code, and accuweather_search_by_geoposition for coordinates.
Inputs
qstringrequired- City name to search for. Add a country_code or admin_code to disambiguate common names. Example: Springfield
admin_codestring- Administrative area code (state, province or region) that restricts results to one area. Use it together with country_code. accuweather_list_admin_areas lists the codes for a country. Example: NY
aliasinteger- How to treat alias (alternative) place names: 0 always include alias matches, 1 never include them, 2 include an alias only when no official name matches (the API default). Example: 2one of
012 country_codestring- Two-letter ISO 3166-1 country code that restricts results to one country. Example: US
detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
offsetinteger- Page of results to return. Results come in sets of 25: 0 returns the first 25, 1 the next 25, and so on. Omit to return the API's default result set. Example: 0
accuweather_search_city_by_ipFind the AccuWeather city location for an IP address.Read-onlySearch City by IP Address
Find the AccuWeather city location for an IP address. Returns one location with its location key, name, administrative area, country, coordinates and time zone. Use this to locate a user from their IP address. Use accuweather_search_by_geoposition when you have coordinates.
Inputs
ip_addressstringrequired- Public IPv4 address to locate. Example: 38.103.173.150
detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
accuweather_search_locationsSearch all AccuWeather location types (cities, postal codes and points of interest) with one text query.Read-onlySearch Locations
Search all AccuWeather location types (cities, postal codes and points of interest) with one text query. Returns matching locations with their location key, type, name, administrative area, country and coordinates. Use this when the text could be a city, a postal code or a landmark. Use accuweather_search_cities for cities only and accuweather_search_points_of_interest for landmarks only.
Inputs
qstringrequired- City name, postal code or point of interest to search for. Example: Central Park
admin_codestring- Administrative area code (state, province or region) that restricts results to one area. Use it together with country_code. accuweather_list_admin_areas lists the codes for a country. Example: NY
aliasinteger- How to treat alias (alternative) place names: 0 always include alias matches, 1 never include them, 2 include an alias only when no official name matches (the API default). Example: 2one of
012 country_codestring- Two-letter ISO 3166-1 country code that restricts results to one country. Example: US
detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
offsetinteger- Page of results to return. Results come in sets of 25: 0 returns the first 25, 1 the next 25, and so on. Omit to return the API's default result set. Example: 0
accuweather_search_points_of_interestSearch AccuWeather points of interest, such as airports, stadiums and parks, by name.Read-onlySearch Points of Interest
Search AccuWeather points of interest, such as airports, stadiums and parks, by name. Returns matching points of interest with their location key, name, type, administrative area, country and coordinates. Use this for landmarks. Use accuweather_search_cities for cities and accuweather_search_locations to search every location type at once.
Inputs
qstringrequired- Name of the point of interest to search for. Example: JFK Airport
admin_codestring- Administrative area code (state, province or region) that restricts results to one area. Use it together with country_code. accuweather_list_admin_areas lists the codes for a country. Example: NY
all_languagesboolean- Set to true to also match translated names of the point of interest. Defaults to false.
country_codestring- Two-letter ISO 3166-1 country code that restricts results to one country. Example: US
detailsboolean- Set to true to include extended information in each result. Defaults to false.
languagestring- Language for text in the response, as a language code. Defaults to en-us. accuweather_list_languages lists the supported codes. Example: fr-fr
typestring- Point-of-interest type to restrict results to, as listed on AccuWeather's point-of-interest types page (for example airport, park or stadium). Example: airport
No tools match.
