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.