Weather API Documentation
Integrate accurate, reliable weather data into your applications with our comprehensive REST API.
Overview
The WeatherCast Pro API provides developers with access to current weather conditions, forecasts, historical data, and specialized weather information for locations worldwide.
Global Coverage
Weather data for over 200,000 cities worldwide with precise location-based information.
High Performance
99.9% uptime with average response times under 100ms for all API requests.
Secure & Reliable
Enterprise-grade security with API key authentication and encrypted data transmission.
Scalable
Handles millions of requests with automatic scaling to meet your application’s needs.
Authentication
All API requests require authentication using an API key. You can obtain your API key by signing up for a developer account.
Include your API key as a query parameter in all requests to the API.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Yes | Your unique API key |
| q | string | Yes | City name, ZIP code, or coordinates |
Alternatively, you can include the API key in the request header:
GET /v1/current?q=London HTTP/1.1
Host: api.weathercastpro.com
X-API-Key: YOUR_API_KEYQuick Start
Get started with the WeatherCast Pro API in just a few minutes. Here’s a simple example using JavaScript to fetch current weather data.
// Get current weather for London
const apiKey = 'YOUR_API_KEY';
const city = 'London';
fetch(`https://api.weathercastpro.com/v1/current?key=${apiKey}&q=${city}`)
.then(response => response.json())
.then(data => {
console.log(`Current temperature in ${data.location.name}: ${data.current.temp_c}°C`);
console.log(`Condition: ${data.current.condition.text}`);
})
.catch(error => console.error('Error:', error));Example Response
{
"location": {
"name": "London",
"region": "City of London, Greater London",
"country": "United Kingdom",
"lat": 51.52,
"lon": -0.11,
"localtime": "2023-10-15 14:30"
},
"current": {
"last_updated": "2023-10-15 14:00",
"temp_c": 15.0,
"temp_f": 59.0,
"condition": {
"text": "Partly cloudy",
"icon": "//cdn.weathercastpro.com/weather/64x64/day/116.png"
},
"wind_mph": 9.4,
"wind_kph": 15.1,
"humidity": 72,
"cloud": 25,
"feelslike_c": 14.2,
"feelslike_f": 57.6
}
}Current Weather
Get current weather conditions for any location worldwide. Returns detailed information including temperature, humidity, wind, and atmospheric conditions.
Retrieve current weather data for a specific location.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | Yes | City name, ZIP code, or coordinates (lat,lon) |
| lang | string | No | Language code for condition texts (default: en) |
Forecast
Access weather forecasts for any location. Get daily or hourly forecasts for up to 14 days with detailed meteorological information.
Retrieve weather forecast data for a specific location.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | Yes | City name, ZIP code, or coordinates |
| days | integer | No | Number of forecast days (1-14, default: 3) |
| hourly | boolean | No | Include hourly forecast data (default: false) |
Pricing
Choose the plan that fits your needs. All plans include access to our complete API with no hidden fees.
- 1,000 requests/month
- Current weather only
- Standard support
- No historical data
- No air quality data
- 50,000 requests/month
- All weather data types
- 7-day forecast
- Historical data (30 days)
- Air quality data
- 500,000 requests/month
- All weather data types
- 14-day forecast
- Historical data (1 year)
- Priority support
HTTP Status Codes
The API uses standard HTTP status codes to indicate the success or failure of requests.
Support
Need help integrating our API or have questions about our services? Our support team is here to help.
Get in Touch
Contact our developer support team for technical assistance or sales inquiries.
api@weathercastpro.comWe typically respond to all inquiries within 24 hours.