Quickstart Guide
All registered users, whether on a free or paid plan, can use our Quickstart Guide to explore the full range of API functionalities with just one click.
- Existing users: Access the Quickstart Guide below.
- New users: Create an account and get started right away.
Get onboarded with the Weatherstack API and start retrieving weather data in just a few minutes!
Step 1: Get Your API Access Key
Sign up for a free account to start using the Weatherstack API. Once registered, your personal API Access Key
will be available in the Dashboard. This key is required to authenticate all API requests—keep it secure. You can reset it anytime from your Account Dashboard.
Step 2: API Endpoints
Weatherstack provides several endpoints to access different types of weather data:
Current Weather
: Retrieve current weather conditions.Historical Weather
: Access past weather data for a specific date.Historical Time-Series
: Retrieve weather data over a range of dates.Weather Forecast
: Get forecasts for up to 14 days.Location Lookup
: Look up one or multiple locations.
Base URL: All API requests start with:
You can also get started quickly with Postman by forking the official Weatherstack API Postman Collection.
Step 3: Make API Requests
Try simple requests for current, historical, and forecast weather data. Append your access_key
and query parameters
.
Current Weather
Historical Weather
Historical Weather Time-Series
Weather Forecast
For more details on optional parameters and full API functionality, refer to the API Documentation.
Step 4: First API Call
We recommend starting with the Current Weather endpoint, as it is the primary method for retrieving real-time weather data. Simply attach your desired location to the endpoint as shown in the example above.
This is just the beginning of what the Weatherstack API can do. For advanced integration guides, code examples, and additional features, refer to the official API Documentation.
Support & Resources
- For any questions or issues, contact our support team.
- Explore commonly used API calls and examples to get the most out of your integration.