Moon and Moon Phase

Get moonrise and moonset and hourly moon phase data for the next 60 days at any location worldwide.

Endpoint#

GET /v7/astronomy/moon

Parameters#

Query parameters

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
lang Multi-language setting, please see Language to find out how our multi-language works and how to set up.

Request example#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/v7/astronomy/moon?location=116.41%2C39.92&date=20200531&lang=en'

Replace your_token and your_api_host with your JWT Authentication and API Host

Try it

Response#

{
  "code": "200",
  "updateTime": "2021-11-15T17:00+08:00",
  "fxLink": "https://www.qweather.com",
  "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": "Waning gibbous",
      "illumination": "100",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T01:00+08:00",
      "value": "0.51",
      "name": "Waning gibbous",
      "illumination": "100",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T02:00+08:00",
      "value": "0.51",
      "name": "Waning gibbous",
      "illumination": "100",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T03:00+08:00",
      "value": "0.51",
      "name": "Waning gibbous",
      "illumination": "100",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T04:00+08:00",
      "value": "0.52",
      "name": "Waning gibbous",
      "illumination": "100",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T05:00+08:00",
      "value": "0.52",
      "name": "Waning gibbous",
      "illumination": "100",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T06:00+08:00",
      "value": "0.52",
      "name": "Waning gibbous",
      "illumination": "100",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T07:00+08:00",
      "value": "0.52",
      "name": "Waning gibbous",
      "illumination": "100",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T08:00+08:00",
      "value": "0.52",
      "name": "Waning gibbous",
      "illumination": "100",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T09:00+08:00",
      "value": "0.52",
      "name": "Waning gibbous",
      "illumination": "100",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T10:00+08:00",
      "value": "0.52",
      "name": "Waning gibbous",
      "illumination": "99",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T11:00+08:00",
      "value": "0.52",
      "name": "Waning gibbous",
      "illumination": "99",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T12:00+08:00",
      "value": "0.53",
      "name": "Waning gibbous",
      "illumination": "99",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T13:00+08:00",
      "value": "0.53",
      "name": "Waning gibbous",
      "illumination": "99",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T14:00+08:00",
      "value": "0.53",
      "name": "Waning gibbous",
      "illumination": "99",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T15:00+08:00",
      "value": "0.53",
      "name": "Waning gibbous",
      "illumination": "99",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T16:00+08:00",
      "value": "0.53",
      "name": "Waning gibbous",
      "illumination": "99",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T17:00+08:00",
      "value": "0.53",
      "name": "Waning gibbous",
      "illumination": "99",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T18:00+08:00",
      "value": "0.53",
      "name": "Waning gibbous",
      "illumination": "99",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T19:00+08:00",
      "value": "0.53",
      "name": "Waning gibbous",
      "illumination": "99",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T20:00+08:00",
      "value": "0.54",
      "name": "Waning gibbous",
      "illumination": "99",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T21:00+08:00",
      "value": "0.54",
      "name": "Waning gibbous",
      "illumination": "99",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T22:00+08:00",
      "value": "0.54",
      "name": "Waning gibbous",
      "illumination": "99",
      "icon": "805"
    },
    {
      "fxTime": "2021-11-20T23:00+08:00",
      "value": "0.54",
      "name": "Waning gibbous",
      "illumination": "98",
      "icon": "805"
    }
  ],
  "refer": {
    "sources": [
      "https://developer.qweather.com/attribution.html"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}

code string Status code
updateTime date-time API latest update time
fxLink uri Responsive web page of this data, for embedded in website or APP
moonrise string Moonrise time of current day. Maybe null
moonset string Moonset time of current day. Maybe null
moonPhase array Moon phase data list
- fxTime date-time Moon phase forecast time
- value string Moon phase value
- name string Moon phase name
- illumination string Moon illuminance in percent
- icon string Icon code for moon phase. See also QWeather Icons
refer object Data sources and licensing information
- sources array Data source and other statements, may be null
- license array Data license, may be null