datakoot-com Weather & Geo API
The Weather & Geo API from datakoot-com — 6 operation(s) for weather & geo.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/datakoot-com:datakoot-com-weather-geo-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Datakoot x402 data Weather & Geo API
version: 2.8.0
x-guidance: 'Call POST /api/<tool> with a JSON body of the tool''s arguments (GET with a query string also works). Without payment you get HTTP 402 with an x402 v2 challenge (PAYMENT-REQUIRED header and JSON body): pay $0.01 USDC on Base (eip155:8453) to the listed payTo using the exact scheme, then retry with the PAYMENT-SIGNATURE header. Datakoot verifies the payment, runs the tool, and settles only if the tool succeeds; a tool error returns 422 with charged:false. Successful responses are plain JSON matching each operation''s 200 schema, with the on-chain receipt in PAYMENT-RESPONSE. Start with cve_lookup, package_health, financials, country_profile or domain_report. MCP clients can use /mcp; every tool is also free for 100 calls/day at <server>.datakoot.com/mcp.'
description: 48 live public-data tools (security, packages, SEC filings, economy, FX, weather, domains, Federal Register, Base) plus 4 Koot briefing tools that combine many lookups into one answer, for AI agents. $0.01 USDC per call (every tool and every Koot brief) on Base via x402, charged only on success. The same tools are free for 100 calls/day via MCP at .datakoot.com/mcp.
contact:
email: hello@datakoot.com
url: https://datakoot.com
servers:
- url: https://x402.datakoot.com
tags:
- name: Weather & Geo
paths:
/api/geocode:
post:
operationId: geocode
summary: Geocode (Weather & Geo)
description: 'Convert a US street address OR a city/town name into latitude/longitude coordinates, using US Census data. Accepts both ''1600 Pennsylvania Ave NW, Washington DC'' and ''Chicago, IL'' - a place name returns the centroid of the city. Call this first whenever you have a location as text and need coordinates for the weather or elevation tools. US locations only. PAID: $0.01 USDC per call via x402 (charged only on success).'
tags:
- Weather & Geo
x-payment-info:
price:
currency: USD
mode: fixed
amount: '0.01'
protocols:
- x402:
scheme: exact
network: eip155:8453
asset: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
payTo: '0x3de7b2de531053340cf132d29b837e5a0e924177'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
address:
type: string
description: A US street address ('1600 Pennsylvania Ave NW, Washington DC') or a city or town ('Chicago, IL', 'Springdale, Arkansas')
required:
- address
example:
address: 1600 Pennsylvania Ave NW, Washington, DC
responses:
'200':
description: Tool result (charged)
content:
application/json:
schema:
type: object
properties:
query: {}
matched_by: {}
matches: {}
source: {}
additionalProperties: true
'402':
description: 'Payment required: x402 challenge in the PAYMENT-REQUIRED header and body'
'422':
description: Tool error (not charged)
/api/weather_forecast:
post:
operationId: weather_forecast
summary: Weather Forecast (Weather & Geo)
description: 'Get a multi-day weather forecast for a US location by latitude/longitude (National Weather Service). Returns named periods (Today, Tonight, ...) with temperature, wind, and a short + detailed forecast. Use geocode first if you only have an address. PAID: $0.01 USDC per call via x402 (charged only on success).'
tags:
- Weather & Geo
x-payment-info:
price:
currency: USD
mode: fixed
amount: '0.01'
protocols:
- x402:
scheme: exact
network: eip155:8453
asset: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
payTo: '0x3de7b2de531053340cf132d29b837e5a0e924177'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
lat:
type: number
description: Latitude in decimal degrees, e.g. 36.1867. US coverage only (National Weather Service).
lon:
type: number
description: Longitude in decimal degrees, negative in the western hemisphere, e.g. -94.1288.
hourly:
type: boolean
description: If true, return the hourly forecast instead of daily periods.
default: false
required:
- lat
- lon
example:
lat: 40.27
lon: -76.88
responses:
'200':
description: Tool result (charged)
content:
application/json:
schema:
type: object
properties:
location: {}
timezone: {}
type: {}
periods: {}
source: {}
additionalProperties: true
'402':
description: 'Payment required: x402 challenge in the PAYMENT-REQUIRED header and body'
'422':
description: Tool error (not charged)
/api/weather_current:
post:
operationId: weather_current
summary: Weather Current (Weather & Geo)
description: 'Get the latest observed weather conditions for a US location by latitude/longitude, from the nearest NWS observation station: temperature, humidity, wind, and text description. PAID: $0.01 USDC per call via x402 (charged only on success).'
tags:
- Weather & Geo
x-payment-info:
price:
currency: USD
mode: fixed
amount: '0.01'
protocols:
- x402:
scheme: exact
network: eip155:8453
asset: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
payTo: '0x3de7b2de531053340cf132d29b837e5a0e924177'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
lat:
type: number
description: Latitude in decimal degrees, e.g. 36.1867. US coverage only (National Weather Service).
lon:
type: number
description: Longitude in decimal degrees, negative in the western hemisphere, e.g. -94.1288.
required:
- lat
- lon
example:
lat: 40.27
lon: -76.88
responses:
'200':
description: Tool result (charged)
content:
application/json:
schema:
type: object
properties:
location: {}
station: {}
observed: {}
description: {}
temperature: {}
humidity: {}
wind: {}
source: {}
additionalProperties: true
'402':
description: 'Payment required: x402 challenge in the PAYMENT-REQUIRED header and body'
'422':
description: Tool error (not charged)
/api/weather_alerts:
post:
operationId: weather_alerts
summary: Weather Alerts (Weather & Geo)
description: 'List active NWS weather alerts (warnings, watches, advisories) for a US state or marine area. Pass a two-letter state code like CA, TX, FL. Returns event type, severity, headline, affected area and expiry. PAID: $0.01 USDC per call via x402 (charged only on success).'
tags:
- Weather & Geo
x-payment-info:
price:
currency: USD
mode: fixed
amount: '0.01'
protocols:
- x402:
scheme: exact
network: eip155:8453
asset: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
payTo: '0x3de7b2de531053340cf132d29b837e5a0e924177'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
area:
type: string
description: Two-letter US state code, e.g. PA, TX, CA (full state names such as Pennsylvania are also accepted).
required:
- area
example:
area: PA
responses:
'200':
description: Tool result (charged)
content:
application/json:
schema:
type: object
properties:
area: {}
active_count: {}
alerts: {}
source: {}
additionalProperties: true
'402':
description: 'Payment required: x402 challenge in the PAYMENT-REQUIRED header and body'
'422':
description: Tool error (not charged)
/api/earthquakes:
post:
operationId: earthquakes
summary: Earthquakes (Weather & Geo)
description: 'List recent earthquakes worldwide from the USGS feed. Filter by minimum magnitude, look-back window in days, and optionally a bounding box or a point+radius (km). Returns magnitude, place, time, depth and coordinates. PAID: $0.01 USDC per call via x402 (charged only on success).'
tags:
- Weather & Geo
x-payment-info:
price:
currency: USD
mode: fixed
amount: '0.01'
protocols:
- x402:
scheme: exact
network: eip155:8453
asset: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
payTo: '0x3de7b2de531053340cf132d29b837e5a0e924177'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
min_magnitude:
type: number
default: 4.5
description: Only return quakes at or above this magnitude.
days:
type: integer
description: Look back this many days (default 7, max 30).
default: 7
lat:
type: number
description: Optional center latitude for a radius search.
lon:
type: number
description: Optional center longitude for a radius search.
radius_km:
type: number
description: Radius in km around lat/lon (requires lat+lon).
limit:
type: integer
default: 20
description: Maximum number of quakes to return.
required: []
example:
min_magnitude: 4.5
days: 3
limit: 5
responses:
'200':
description: Tool result (charged)
content:
application/json:
schema:
type: object
properties:
count: {}
criteria: {}
earthquakes: {}
source: {}
additionalProperties: true
'402':
description: 'Payment required: x402 challenge in the PAYMENT-REQUIRED header and body'
'422':
description: Tool error (not charged)
/api/elevation:
post:
operationId: elevation
summary: Elevation (Weather & Geo)
description: 'Get the ground elevation at a latitude/longitude within the US, from the USGS Elevation Point Query Service. Returns elevation in feet and meters. PAID: $0.01 USDC per call via x402 (charged only on success).'
tags:
- Weather & Geo
x-payment-info:
price:
currency: USD
mode: fixed
amount: '0.01'
protocols:
- x402:
scheme: exact
network: eip155:8453
asset: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
payTo: '0x3de7b2de531053340cf132d29b837e5a0e924177'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
lat:
type: number
description: Latitude in decimal degrees, e.g. 39.5883. US coverage only (USGS).
lon:
type: number
description: Longitude in decimal degrees, negative in the western hemisphere, e.g. -105.6438.
required:
- lat
- lon
example:
lat: 39.7392
lon: -104.9903
responses:
'200':
description: Tool result (charged)
content:
application/json:
schema:
type: object
properties:
lat: {}
lon: {}
elevation_m: {}
elevation_ft: {}
source: {}
additionalProperties: true
'402':
description: 'Payment required: x402 challenge in the PAYMENT-REQUIRED header and body'
'422':
description: Tool error (not charged)