Welcome to the documentation for the YWeatherAPI library. This library provides an easy-to-use API to fetch weather data using the Yahoo Weather API service. With YWeatherAPI, you can retrieve current weather conditions, forecasts, and more for any location around the world.


To get started with YWeatherAPI, follow the installation steps below:

  1. Install YWeatherAPI via CocoaPods:
    pod 'YWeatherAPI'
  2. Import the YWeatherAPI module in your project:
    #import <YWeatherAPI/YWeatherAPI.h>


To use the YWeatherAPI library, follow the steps below:

Step 1: Authentication

The YWeatherAPI does not require any authentication or API keys. You can directly use the library to fetch weather data.

Step 2: Fetching current weather conditions

To fetch the current weather conditions for a specific location, use the following method:

[YWAPI fetchCurrentConditionsForLocation:location
completion:^(NSError *error, YWCondition *condition) {
if (error) {
// Handle error
} else {
// Use the condition object to access weather data

Note: Replace location with the target location for which you want to fetch weather conditions.

Step 3: Fetching weather forecasts

To fetch weather forecasts for a specific location, use the following method:

[YWAPI fetchForecastsForLocation:location
completion:^(NSError *error, NSArray *forecasts) {
if (error) {
// Handle error
} else {
// Use the forecasts array to access weather forecast data

Note: Replace location with the target location for which you want to fetch weather forecasts.

Step 4: Additional functionality

The YWeatherAPI library provides several additional methods to access various weather-related data and features. Some of these include:

  • Fetching weather conditions for multiple locations
  • Converting temperature units
  • Retrieving localized weather condition descriptions
  • Accessing weather image icons

Consult the API documentation or the library’s header files for a complete list of methods and functionality provided by the YWeatherAPI library.


If you encounter any issues while using the YWeatherAPI library, consider the following troubleshooting tips:

  • Ensure you have a stable internet connection
  • Check if you have correctly imported the YWeatherAPI module
  • Verify that the target device has internet connectivity
  • Make sure you are using the latest version of YWeatherAPI
  • Review the library’s documentation and header files for proper implementation
  • Contact the library’s support team or community for further assistance


You should now have a good understanding of how to use the YWeatherAPI library to fetch weather data for any location. Explore the library’s documentation and experiment with various methods to enhance your weather-related applications!