Skip to content

Weather API Config Guide

⚠️ Important: API Domain Change

QWeather has enabled a new API Host system, and old public domains will stop service:

  • devapi.qweather.com - Service ends on January 1, 2026
  • api.qweather.com - Service ends on June 1, 2026

Be sure to configure your private API Host to ensure service continuity!

Configuration Steps

Step 1: Register QWeather Account

  1. Visit the QWeather Developer Platform: https://dev.qweather.com.
  2. Click "Sign Up" or "Login" in the top-right corner.
  3. Complete account registration (supports email, phone numbers, etc.).

Step 2: Create App to get API Key

  1. After logging in, enter the "Console".
  2. Click "App Management" → "My Apps" in the left menu.
  3. Click the "Create App" button.
  4. Fill in the app info:
    • App Name: Anything you like, e.g., "Mixstart Weather".
    • Select KEY Type: Select "Web API" ⚠️ (Important: Must be Web API).
    • Data Encryption: Select "No".
    • Subscription Plan: Select "Free Subscription" (1000 calls per day).
  5. Click "Create".

Step 3: Get API Host

  1. In the console page, click the avatar in the top-right corner.
  2. Select "Settings".
  3. In the "API Host" section, copy your private domain.
  4. The format is similar to: abc123.def456.qweatherapi.com.

Step 4: Configure in Mixstart

  1. Open the Mixstart main window.
  2. Click the "Settings" icon (⚙️) in the top-right.
  3. In the settings window, select the "Weather Settings" tab.
  4. Fill in:
    • API Host: Paste your private domain (e.g., abc123.def456.qweatherapi.com).
    • API Key: Paste your 32-character API Key.
  5. Click "Save".

Step 5: Use Weather Widget

  1. Go to the "Desktop Widgets" category.
  2. Click "Add Widget".
  3. Select "Weather" type.
  4. Configure city name (e.g., "New York", "London", "Tokyo").
  5. Select temperature unit (Celsius/Fahrenheit).
  6. Click "Create".
  7. Click "Push to Desktop".

Features

  • ✅ Real-time weather data (temperature, humidity, wind, etc.)
  • ✅ Auto-refresh (every 30 minutes)
  • ✅ Error prompts and caching mechanism
  • ✅ Supports both Chinese and English city names

FAQ

Q: Why does it say "Please configure weather API key first"?

A: You need to configure your QWeather API Key and API Host in settings first.

Q: What if a 404 error occurs?

A: Please check:

  • Whether an API Host is configured (Required!).
  • Whether the key type is "Web API".
  • Whether the API Host format is correct (xxx.xxx.qweatherapi.com).
  • Whether the key is complete (32 characters).

Q: What are the limits of the free version?

A: The free version of QWeather provides 1,000 API calls per day, which is perfectly sufficient for personal use. Mixstart uses a 30-minute caching mechanism, so the actual number of calls will be much fewer.

Q: Is my data safe?

A: Completely! The API Key and API Host are only stored in your local configuration files and will not be uploaded to any server.

City Name Support

  • Major Global Cities: New York, London, Tokyo, Paris, Berlin, etc.
  • Chinese Cities: Beijing, Shanghai, Guangzhou, Shenzhen, etc.
  • International Regions: Hong Kong, Macao, Taipei, etc.
  • City Name input supports English and Chinese.