AGagentkey
weather

Daily weather forecast for a coordinate or QWeather location id. Returns a normalized Forecast.

3–30 day forecast for a point (lat / lon) or a QWeather LocationID (location_id). City names are not resolved — geocode first. Metric units (°C, mm, km/h); condition / wind texts follow lang (default Chinese).

Fixed price: 0.1 credits per successful call, whichever provider serves it.

post/v2/ops/weather.forecast

Request

  • Base URL
    https://api.agentkey.app
  • URL
    https://api.agentkey.app/v2/ops/weather.forecast
  • Auth
    HTTP bearer

Request body

days3 | 7 | 10 | 15 | 30

Forecast length in days (QWeather granularities).

fieldsstring[]

Projection: keep only these dotted paths of data, e.g. ["items.id", "items.text"].

include_rawboolean

Attach the raw upstream payload as raw (not a stable contract; truncated above 256 KB).

langstring

BCP 47 language for condition / wind texts, e.g. en, zh-Hans; default is the provider's (Chinese).

latnumber

Latitude in decimal degrees. Required unless location_id is given.

location_idstring

QWeather LocationID (e.g. 101010100 for Beijing) from the QWeather geo API. Give either lat / lon or location_id, not both.

lonnumber

Longitude in decimal degrees. Required unless location_id is given.

providerstring

Shorthand for routing.only = [provider].

Response

Success envelope

credits_chargednumber required

Credits charged for this call (the method's fixed price).

opstring required

Method name.

op_versioninteger required

Method version that served the call.

providerstring required

Provider that actually served the call.

rawunknown
raw_truncatedboolean
request_idstring required

Correlation id; quote it in support requests.

took_msinteger required
unsupported_fieldsstring[] required

Output paths this provider structurally does not supply; such fields are null for a different reason than 'missing on this record'.

Changes

No recorded changes to this operation across all 1 revision of this API.