WeatherAPI.com Getting Started: API Key & First Request (2026)

Getting started overview

Integrating WeatherAPI.com into an application involves a series of steps to ensure proper access and data retrieval. The fundamental process includes creating an account, acquiring an API key, and successfully executing a first API call. This guide focuses on these initial steps to provide a direct path to accessing WeatherAPI.com's services, such as real-time, forecast, and historical weather data.

WeatherAPI.com's Developer Plan offers a free tier, enabling users to test functionalities with up to 5,000 calls per month and access to a 3-day forecast WeatherAPI.com pricing details. This plan is suitable for initial development and testing before committing to paid tiers like the Startup Plan, which provides 250,000 calls per month and a 14-day forecast WeatherAPI.com plan comparison.

The API provides data primarily in JSON format, facilitating parsing and integration into various programming environments WeatherAPI.com API documentation. Authentication for all requests relies on a unique API key, which must be included as a query parameter in each API call.

Here is a quick reference table summarizing the key steps:

Create an account and get keys

Before making any API calls, you must create an account on WeatherAPI.com. This process is standard for most web services that require authentication via an API key, as outlined by general API security practices AWS API Gateway API key usage. Follow these steps to set up your account and retrieve your API key:

1. Navigate to the Signup Page: Go to the official WeatherAPI.com signup page.
2. Complete Registration: Fill out the required fields, including your email address and a secure password. Agree to the terms of service.
3. Verify Email (if prompted): Some services require email verification to activate the account. Check your inbox for a verification link and follow the instructions.
4. Log In: Once registered, log in to your new account using your credentials.
5. Locate API Key: Upon logging in, you will be directed to your dashboard. Your unique API key should be prominently displayed on this page. It is a string of alphanumeric characters. Copy this key, as it will be required for every API request you make.

It is important to keep your API key secure and avoid exposing it in client-side code or public repositories. Treat your API key like a password to prevent unauthorized usage Google Maps API key best practices.

Your first request

With your API key in hand, you can now make your first request to WeatherAPI.com. This example demonstrates how to fetch current weather data for a specific location. The API provides various endpoints, but the current.json endpoint is a good starting point for testing WeatherAPI.com current weather endpoint.

The base URL for API requests is https://api.weatherapi.com/v1/.

To get current weather data, you will use the current.json endpoint. This endpoint requires two main query parameters:

• key: Your API key.
• q: The location for which you want weather data (e.g., 'London', 'New York', '48.8566,2.3522').

Example using cURL:

cURL is a command-line tool and library for transferring data with URLs, commonly used for making initial API requests cURL man page. Replace YOUR_API_KEY with your actual API key and London with your desired location.

curl "https://api.weatherapi.com/v1/current.json?key=YOUR_API_KEY&q=London"

Executing this command in your terminal will return a JSON object containing current weather conditions for London. The response will include data points such as temperature, humidity, wind speed, and weather description.

Example using Python:

Python's requests library simplifies making HTTP requests. Ensure you have it installed (pip install requests).

import requests
import json

api_key = "YOUR_API_KEY"
location = "New York"

url = f"https://api.weatherapi.com/v1/current.json?key={api_key}&q={location}"

try:
    response = requests.get(url)
    response.raise_for_status()  # Raise an HTTPError for bad responses (4xx or 5xx)
    data = response.json()
    print(json.dumps(data, indent=4))
except requests.exceptions.RequestException as e:
    print(f"An error occurred: {e}")

This Python script will print the formatted JSON response to your console, providing an easily readable output of the current weather in New York.

Common next steps

After successfully making your first request, several common next steps can enhance your integration with WeatherAPI.com:

1. Explore Other Endpoints: WeatherAPI.com offers various other endpoints beyond current weather, including forecast, historical, astronomy, time zone, and sports data WeatherAPI.com available APIs. Review the official documentation to identify which endpoints are most relevant to your application's needs.
2. Implement Error Handling: Incorporate robust error handling in your code to gracefully manage API rate limits, invalid requests, or network issues. The API returns specific error codes and messages that can be used for debugging WeatherAPI.com error codes.
3. Parameterize Requests: Instead of hardcoding locations, allow users to input locations or use geolocation services to dynamically fetch weather data based on their current position.
4. Data Parsing and Display: Develop logic to parse the JSON response and extract the specific data points you need. Then, design how this information will be displayed within your application's user interface.
5. Optimize API Calls: Consider caching strategies for weather data that doesn't change frequently to reduce the number of API calls and stay within your plan's limits.
6. Upgrade Your Plan: If your application's usage exceeds the free Developer Plan limits or requires more extensive forecast data (e.g., 14-day forecast), consider upgrading to a paid plan WeatherAPI.com pricing options.

Troubleshooting the first call

Encountering issues during your first API call is common. Here are some troubleshooting tips for WeatherAPI.com requests:

• Invalid API Key: Double-check that your API key is correctly copied and included in the key query parameter. An incorrect key will typically result in an authentication error.
• Incorrect Endpoint or URL: Verify that the base URL (https://api.weatherapi.com/v1/) and the specific endpoint (e.g., current.json) are spelled correctly.
• Missing or Malformed Parameters: Ensure all required parameters, such as q for location, are present and correctly formatted. For instance, locations with spaces might need URL encoding if not handled automatically by your HTTP client.
• Rate Limit Exceeded: If you make too many requests within a short period, you might hit the rate limit for your plan. The API will return an error indicating this. Wait a few minutes before trying again or review your usage dashboard.
• Network Issues: Check your internet connection. A lack of connectivity will prevent any API call from succeeding.
• JSON Parsing Errors: If the API call succeeds but your application fails to process the response, there might be an issue with how you are parsing the JSON. Use a JSON validator tool to inspect the raw response and ensure it's well-formed.
• Refer to Documentation: The WeatherAPI.com documentation provides detailed information on error codes and common issues. Consult it for specific error messages you receive.