Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

WeatherAPI Geo API

Location, IP lookup, timezone, astronomy

WeatherAPI Geo API is one of 7 APIs that WeatherAPI publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Geo. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and code examples.

This API exposes 4 operations across 4 paths, and defines 7 schemas. It is described by OpenAPI 3.1.0, at version 1.0.2.

Requests are made against 2 base URLs: https://api.weatherapi.com/v1, http://api.weatherapi.com/v1.

4 operations 4 paths 7 schemas 4 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.2
Base URL
https://api.weatherapi.com/v1
Authentication
API Key
Resource Areas
1

Authentication & Security 1

WeatherAPI Geo API declares 1 security scheme for authenticating requests. An API key is passed in the query as key (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — API key obtained from https://www.weatherapi.com/my/. Pass as ?key=YOURAPIKEY query parameter.

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 4 GET. Each is listed below with its method, path, parameters, and response codes.

Geo 4

Location, IP lookup, timezone, astronomy

GET
/search.json
WeatherAPI Search / Autocomplete Locations
searchLocations 2 params → 200400401
GET
/ip.json
WeatherAPI IP Lookup
ipLookup 2 params → 200400401
GET
/timezone.json
WeatherAPI Time Zone
getTimezone 2 params → 200400401
GET
/astronomy.json
WeatherAPI Astronomy
getAstronomy 3 params → 200400401

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are IpLookupResponse (15 properties), AstroElement (8 properties), Location (8 properties), SearchLocation (7 properties). Each schema is shown below with its type and property counts.

Location
object
Location metadata returned with every weather response.
8 properties
SearchLocation
object
7 properties
AstronomyResponse
object
2 properties
TimezoneResponse
object
1 property
IpLookupResponse
object
15 properties
AstroElement
object
8 properties
ErrorResponse
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

weatherapi-geo-api-openapi.yml Raw ↑

Other APIs WeatherAPI publishes across the network.

WeatherAPI Alerts API
WeatherAPI Future API
WeatherAPI History API
WeatherAPI Marine API
WeatherAPI Sports API
WeatherAPI Weather API