Moon and Moon Phase

Platform: API iOS Android

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 or location=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
langMulti-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": [
      "commercial license"
    ]
  }
}

code API status code, please refer to 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, 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