QWeather Geo Top City

1 credits/call
ae_qweather_geo_top_city

Get a list of popular cities worldwide, optionally filtered by country.

Maps
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
langstringNoLanguage code.—
rangestringNoTop city range selector.—
numberintegerNoMaximum number of cities.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_qweather_geo_top_city' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "location": "上海"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": "200",
  "refer": {
    "license": [
      "QWeather Developers License"
    ],
    "sources": [
      "QWeather"
    ]
  },
  "topCityList": [
    {
      "adm1": "北京市",
      "adm2": "北京",
      "country": "中国",
      "id": "101010100",
      "name": "北京",
      "type": "city"
    }
  ]
}

This example shows part of the response. Copied content is valid JSON.