The Best Weather API: How to Use It to Create a Stunning Weather App

by | May 26, 2023

People worldwide are increasingly using weather apps to plan activities, prepare for weather conditions, and stay informed about the ever-changing climate. Thus, the demand for high-performance and accurate weather apps is increasing. If you’re a developer looking to create a weather app, you know using a weather API to integrate weather data into your app is the best option. By using the best weather API, you can integrate highly accurate and detailed weather data into your app with the need to collect the data from various sources, verify its accuracy and parse it manually.

In this article, we will explore the step-by-step process of building a stunning weather app using the best weather API called weatherstack.

Weatherstack API is renowned for its comprehensive and reliable weather data. It offers many features, including real-time weather data, weather forecasts, historical weather data, and more. 

By leveraging this best weather API, we can create a weather app that delivers accurate and up-to-date information and incorporates beautiful visualizations and intuitive user interfaces. The API is trusted by more than 75,000 companies worldwide, including Microsoft, Deloitte, Schneider, and Ericsson.

By the end of this tutorial, you will have the knowledge and skills to build your stunning weather app equipped with the best weather API available. So, let’s dive in and learn how to create a weather app that will captivate users with its functionality and aesthetics.

Setting up the Development Environment

Setting up the Development Environment for creating a weather app using the best weather API

Before building our weather app, we must ensure our development environment is properly set up. Here are the necessary tools and dependencies you’ll need to install:

  • Choose a code editor you’re comfortable with, such as Visual Studio Code, Sublime Text, or Atom.
  • Install Node.js, which includes the Node Package Manager (npm), from the official Node.js website. This will allow us to manage our project dependencies.
  • Install the React Native command-line interface globally by running the following command in your terminal.npm install -g react-native-cli.
  • Depending on whether you’re targeting web, Android or iOS, install the required environment, such as Android Studio or Xcode.

What Is Weatherstack API?

homepage of weatherstack, the best weather API

Weatherstack is one of the most trusted weather APIs for real-time & historical weather data. It can help you retrieve accurate and detailed weather data instantly. Moreover, the API provides global coverage, allowing you to retrieve accurate weather information for any desired location worldwide. 

Weatherstack returns data in lightweight and easy-to-understand JSON format and has detailed documentation. This makes the integration quicker and easier.

 Let’s explore its features and available endpoints.


  • Real-time, historical, and weather forecast data
  • Rock-solid uptime and lightning-fast response time 
  • Covers millions of locations worldwide
  • Offers a free plan so you can start for free and upgrade later as required
  • Bank-level security with 256-bit HTTPS (SSL) encryption
  • Extensive API documentation
  • Scalable infrastructure
  • Flexible location lookup
  • Reliable data sources

Available Endpoints

Here are the endpoints available at the Weatherstack API.

Current Weather

This endpoint gives you real-time weather data for any targeted location.

? access_key = YOUR_ACCESS_KEY

& query = New York

Historical Weather

This endpoint helps you to get the historical data back to 2008.

   ? access_key = YOUR_ACCESS_KEY

    & query = New York

    & historical_date = 2015-01-21

    & hourly = 1

Historical Time Series

You can use this endpoint with historical_date_start and historical_date_end parameters set to valid values.

   ? access_key = YOUR_ACCESS_KEY

    & query = New York

    & historical_date_start = 2015-01-21

    & historical_date_end = 2015-01-25

Weather Forecast

This endpoint can help you get weather forecasts up to 14 days.

   ? access_key = YOUR_ACCESS_KEY

    & query = New York

    & forecast_days = 1

    & hourly = 1

Location Lookup

It can help you to pinpoint one or more specific locations:

   ? access_key = YOUR_ACCESS_KEY

    & query = london

How to Design the User Interface of Your Weather Apps?

Creating your app's interface

Before diving into the implementation, it’s essential to sketch the layout of your weather app. Use pen and paper or design tools like Sketch or Figma to create a rough wireframe.

Selecting an appealing colour scheme and typography is crucial in creating a stunning user interface. Consider the mood and vibe you want your weather app to convey.

Break down your app’s functionality into components and screens. Identify the core features and determine the hierarchy of information. For example, you might have separate screens for the current weather, hourly forecast, and extended forecast.

Remember to keep the user interface clean, visually appealing, and focused on delivering weather information efficiently.

How to Build a Weather App: Key Steps

Getting your API Key

You first need to get your weatherstack free API key to integrate the best weather API into your app. Here’s how you can obtain your unique API key:

  • Go to the Weatherstack official page and navigate to the “Sign Up Free” section.
Signing up for weatherstack API, the best weather API
  • Click the sign-up button and enter the required information, such as your name, email address, and password. 
  • Choose a subscription plan that suits your app’s requirements. Weatherstack offers both free and paid plans. 
  • Once you’ve created an account, you’ll find your API key in your weatherstack dashboard. The API key is a unique string of characters that serves as your authentication token.

Also read: Integrating Real-Time Weather Data with a Weather REST API: A Developer’s Guide

Setting up the Project Structure

Begin by setting up the project structure for your weather app. Create the necessary directories and files to organize your code. Consider separating components, screens, utilities, and API-related files for better maintainability. Tools like Create React App or Expo can automatically scaffold the initial project structure.

Creating the Main Application Component

Create the main application component that serves as the entry point for your weather app. This component will encapsulate the overall structure of the app and handle the navigation between screens and components.

Implementing the Weather Functionality

Let’s focus on implementing the core functionality of displaying weather forecasts using the Weatherstack API.

Making API Requests for Current Weather Data

Utilize the Weatherstack API to request the current weather data of a specific location. Use libraries like axios or fetch to perform HTTP requests. Ensure you include your API key in the authentication requests. Here is the Weatherstack API endpoint.

   ? access_key = YOUR_ACCESS_KEY

    & query = New York

Adding Historical Weather Data Functionality

Extend the functionality of your weather app to include historical weather data retrieval and visualization. Use the following Weatherstack endpoint:

   ? access_key = YOUR_ACCESS_KEY

    & query = New York

    & historical_date = 2015-01-21

    & hourly = 1

Integrating Weather Forecast Data using the Best Weather API

Utilize weatherstack’s forecast endpoint to integrate weather forecasts into your app using the best weather API:

    ? access_key = YOUR_ACCESS_KEY

    & query = New York

    & forecast_days = 1

    & hourly = 1

Displaying the Weather Information

Once you receive the weather data from the API, parse and format the necessary information to display in your app. Create components to showcase the current temperature, weather conditions, humidity, wind speed, and other relevant details.

You can use charts, graphs, or other suitable visual elements to represent temperature variations, precipitation levels, or relevant historical data points.

Building a Weather Web App Using the Best Weather API

Here, we’ll show you how to create a simple weather app using the best weather API (weatherstack) and React. Since we’re creating an example app, we’re keeping everything on the client side. However, it’s best to use Node.js for the backend for weather app development. Using Node.js for the server side helps handle API keys securely and manage server-side logic.

Create a React App

Set up a new React app using create-react-app to create a weather app.

Install Axios

We’ll use Axios to handle API requests:

npm install axios

Creating Components

Now, we’ll create our app component. 

Note: We recommend to store the Weatherstack API key in environment variables 


import React, { useState } from 'react';
import WeatherForm from './components/WeatherForm';
import WeatherDisplay from './components/WeatherDisplay';
import axios from 'axios';

function App() {
  const [weatherData, setWeatherData] = useState(null);

  const fetchWeather = async (location, forecast) => {
    const endpoint = forecast ? 'forecast' : 'current';
    const apiKey = process.env.REACT_APP_WEATHERSTACK_API_KEY;
    const url = `${endpoint}?access_key=${apiKey}&query=${location}`;

    try {
      const response = await axios.get(url);
      const data =;

      if (data.error) {
        console.error('Error fetching weather data:',;
      } else {
        setWeatherData(data.current || data.forecast);
    } catch (error) {
      console.error('Error fetching weather data:', error);

  return (
    <div className="App">
      <h1>Weather App</h1>
      <WeatherForm onSubmit={fetchWeather} />
      <WeatherDisplay weatherData={weatherData} />

export default App;


import React, { useState } from 'react';

const WeatherForm = ({ onSubmit }) => {
  const [location, setLocation] = useState('');
  const [forecast, setForecast] = useState(false);

  const handleSubmit = (e) => {
    onSubmit(location, forecast);

  return (
    <form onSubmit={handleSubmit}>
            onChange={(e) => setLocation(}
            onChange={(e) => setForecast(}
      <button type="submit">Get Weather</button>

export default WeatherForm;


import React from 'react';

const WeatherDisplay = ({ weatherData }) => {
  if (!weatherData) {
    return <div>No data to display</div>;

  const { temperature, humidity, precip, weather_descriptions, pressure } = weatherData;

  return (
      <h2>Weather Information</h2>
      <p>Temperature: {temperature}°C</p>
      <p>Humidity: {humidity}%</p>
      <p>Precipitation: {precip}mm</p>
      <p>Description: {weather_descriptions.join(', ')}</p>
      <p>Pressure: {pressure} mb</p>

export default WeatherDisplay;

.env (React)


Also read: Show Weather Forecast Data Based on Users’ Location.


This tutorial explored the step-by-step process of building a stunning weather app using the Weatherstack API, the best weather API available.

We covered setting up the development environment, understanding the Weatherstack API endpoints and features, designing an appealing user interface, and implementing weather forecasts and historical data functionalities.

By following this tutorial, you’ll learn how to create a weather app that delivers accurate forecasts and captivates users with its visual appeal. 

Start building your stunning weather app today with weatherstack!


What is the most accurate weather API?

Weatherstack is a leading weather API trusted for its high data accuracy, scalability, and robust infrastructure.

What is the best weather API for free?

Weatherstack is the best free weather API that offers a generous free plan and various budget-friendly pricing plans.

Who has the most accurate weather?

Weatherstack is one of the best weather APIs that offer highly accurate real-time, historical, and weather forecast data. The API is trusted by more than 75,000 companies worldwide.