Moon and Moon Phase
Moon and Moon Phase API for getting the last 60 days of moonrise, moonset and moon phase data for cities around the world.
Request URL
-
Pro
https://api.qweather.com/v7/astronomy/moon?[params]
-
Dev
https://devapi.qweather.com/v7/astronomy/moon?[params]
Request Parameters
All parameters are separated by &
. If no optional parameters are set, the default value will be used.
key
API authentication key, please refer to How To Get Your Key. Support Signature Authentication.
For example: key=12334567890ABC
location
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.
For example: location=101010100
or location=116.41,39.92
date
Set the date, up to 60 days in the future (including today). The date format is yyyyMMdd
For example: date=20200531
lang
Multi-language setting, if data does not match the language you set, it will return results in English or its native language.
zh
Chinese, defaulten
Englishfr
Frenches
Spanishja
Japaneseko
Korean- See more language code
Response
// New York moon rise, moon set and moon phase on 2021-11-20
// Pro API https://api.qweather.com/v7/astronomy/moon?location=1E98E&date=20211120&lang=en&key=YOUR_KEY
// Dev API https://devapi.qweather.com/v7/astronomy/moon?location=1E98E&date=20211120&lang=en&key=YOUR_KEY
// Replace date=20211120 with next 60 days
{
"code": "200",
"updateTime": "2021-11-15T04:00-05:00",
"fxLink": "http://hfx.link/20ag1",
"moonrise": "2021-11-20T17:23-05:00",
"moonset": "2021-11-21T07:59-05:00",
"moonPhase": [
{
"fxTime": "2021-11-20T00:00-05:00",
"value": "0.51",
"name": "Waning gibbous",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T01:00-05:00",
"value": "0.51",
"name": "Waning gibbous",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T02:00-05:00",
"value": "0.51",
"name": "Waning gibbous",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T03:00-05:00",
"value": "0.51",
"name": "Waning gibbous",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T04:00-05:00",
"value": "0.52",
"name": "Waning gibbous",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T05:00-05:00",
"value": "0.52",
"name": "Waning gibbous",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T06:00-05:00",
"value": "0.52",
"name": "Waning gibbous",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T07:00-05:00",
"value": "0.52",
"name": "Waning gibbous",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T08:00-05:00",
"value": "0.52",
"name": "Waning gibbous",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T09:00-05:00",
"value": "0.52",
"name": "Waning gibbous",
"illumination": "100",
"icon": "805"
},
{
"fxTime": "2021-11-20T10:00-05:00",
"value": "0.52",
"name": "Waning gibbous",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T11:00-05:00",
"value": "0.52",
"name": "Waning gibbous",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T12:00-05:00",
"value": "0.53",
"name": "Waning gibbous",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T13:00-05:00",
"value": "0.53",
"name": "Waning gibbous",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T14:00-05:00",
"value": "0.53",
"name": "Waning gibbous",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T15:00-05:00",
"value": "0.53",
"name": "Waning gibbous",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T16:00-05:00",
"value": "0.53",
"name": "Waning gibbous",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T17:00-05:00",
"value": "0.53",
"name": "Waning gibbous",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T18:00-05:00",
"value": "0.53",
"name": "Waning gibbous",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T19:00-05:00",
"value": "0.53",
"name": "Waning gibbous",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T20:00-05:00",
"value": "0.54",
"name": "Waning gibbous",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T21:00-05:00",
"value": "0.54",
"name": "Waning gibbous",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T22:00-05:00",
"value": "0.54",
"name": "Waning gibbous",
"illumination": "99",
"icon": "805"
},
{
"fxTime": "2021-11-20T23:00-05:00",
"value": "0.54",
"name": "Waning gibbous",
"illumination": "98",
"icon": "805"
}
],
"refer": {
"sources": [
"QWeather"
],
"license": [
"commercial license"
]
}
}
Parameters | Description |
---|---|
code |
API status code, please refer to Status Code |
updateTime |
|
fxLink |
Responsive web page of this data, for embedded in website or APP |
moonrise |
Moonrise time |
moonset |
Moonrise time |
moonPhase.fxTime |
Moon phase forecast time |
moonPhase.value |
Moon phase value |
moonPhase.name |
Moon Phase Name |
moonPhase.icon |
Icon code for moon phase, free to download 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 |