Moon and Moon Phase
Get moonrise and moonset and hourly moon phase data for the next 60 days at any location worldwide.
Request URL
https://api.qweather.com/v7/astronomy/moon?[params]
For Free subscription, change the API Host to devapi.qweather.com
. See data available for Free subscription.
Request Parameters
All parameters are separated by &
. If no optional parameters are set, the default value will be used.
-
key
(required)API authentication key, please refer to How To Get Your Key. Support Signature Authentication. Example:key=12334567890ABC
-
location
(required)The location to be queried, support LocationID or comma-separated longitude and latitude (decimal, up to 2 decimal places), LocationID can be obtained by GeoAPI. Example:location=101010100
orlocation=116.41,39.92
-
date
(required)Set the date, up to 60 days in the future (including today). The date format is yyyyMMdd. Example:date=20200531
-
lang
Multi-language setting, see Language code for available value. If data does not match the language you set, it will return results in English or its native language.
Request Example
Moon rise, moon set and moon phase on 2021-11-20 for Beijing, replace date=20211120
with next 60 days.
curl -L -X GET --compressed 'https://api.qweather.com/v7/astronomy/moon?location=101010100&date=20211120&key=YOUR_KEY'
Response
The response is in JSON format and is Gzip compressed, all fields are Strings.
{
"code": "200",
"updateTime": "2021-11-15T17:00+08:00",
"fxLink": "http://hfx.link/2ax1",
"moonrise": "2021-11-20T17:25+08:00",
"moonset": "2021-11-21T07:42+08:00",
"moonPhase": [
{
"fxTime": "2021-11-20T00:00+08:00",
"value": "0.51",
"name": "亏凸月",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T01:00+08:00",
"value": "0.51",
"name": "亏凸月",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T02:00+08:00",
"value": "0.51",
"name": "亏凸月",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T03:00+08:00",
"value": "0.51",
"name": "亏凸月",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T04:00+08:00",
"value": "0.52",
"name": "亏凸月",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T05:00+08:00",
"value": "0.52",
"name": "亏凸月",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T06:00+08:00",
"value": "0.52",
"name": "亏凸月",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T07:00+08:00",
"value": "0.52",
"name": "亏凸月",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T08:00+08:00",
"value": "0.52",
"name": "亏凸月",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T09:00+08:00",
"value": "0.52",
"name": "亏凸月",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T10:00+08:00",
"value": "0.52",
"name": "亏凸月",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T11:00+08:00",
"value": "0.52",
"name": "亏凸月",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T12:00+08:00",
"value": "0.53",
"name": "亏凸月",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T13:00+08:00",
"value": "0.53",
"name": "亏凸月",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T14:00+08:00",
"value": "0.53",
"name": "亏凸月",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T15:00+08:00",
"value": "0.53",
"name": "亏凸月",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T16:00+08:00",
"value": "0.53",
"name": "亏凸月",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T17:00+08:00",
"value": "0.53",
"name": "亏凸月",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T18:00+08:00",
"value": "0.53",
"name": "亏凸月",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T19:00+08:00",
"value": "0.53",
"name": "亏凸月",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T20:00+08:00",
"value": "0.54",
"name": "亏凸月",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T21:00+08:00",
"value": "0.54",
"name": "亏凸月",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T22:00+08:00",
"value": "0.54",
"name": "亏凸月",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T23:00+08:00",
"value": "0.54",
"name": "亏凸月",
"illumination": "98",
"icon": "805"
}
],
"refer": {
"sources": [
"QWeather"
],
"license": [
"QWeather Developers License"
]
}
}
-
code
See Status Code -
updateTime
API last update time -
fxLink
Responsive web page of this data, for embedded in website or APP -
moonrise
Moonrise time of current day. Maybe null -
moonset
Moonset time of current day. Maybe null -
moonPhase.fxTime
Moon phase forecast time -
moonPhase.value
Moon phase value -
moonPhase.name
Moon phase name -
moonPhase.icon
Icon code for moon phase. See also QWeather Icons -
moonPhase.illumination
Moon illuminance in percent -
refer.sources
Data source and other statements, may be null -
refer.license
Data license, may be null