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.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/aristocles-com-au:aristocles-com-au-weather-alerts-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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: 3.2.0
info:
title: Aristocles Data Weather Alerts API
description: 'Four Australian data APIs on one key — subscriptions, trade pricing, PBS drugs, and rental prices.
---
## Quick start
**1. Get your API key** — register in one request:
```
POST /v1/auth/register
{"email": "you@example.com", "name": "Your Name"}
```
Copy the `api_key` from the response.
**2. Authenticate** — add your key to every request as a header:
```
X-API-Key: ar_live_xxxxxxxxxxxx
```
**3. Run the discovery endpoint** — returns all available slugs, example calls, and your account limits:
```
GET /v1/discovery
```
**4. Make your first call:**
```
GET /v1/prices/netflix?country=AU
GET /v1/trades/electrician/prices?state=NSW&country=AU
GET /v1/pbs/metformin
GET /v1/rental/VIC/Richmond
```
---
## Four data domains
| Domain | Base path | What it covers |
|---|---|---|
| **Subscription Pricing** | `/v1/prices`, `/v1/services` | 50+ SaaS & streaming services: Netflix, Spotify, Adobe, etc. |
| **Contractor Trades** | `/v1/trades` | Plumbers, electricians, painters across AU, US, UK, CA, NZ |
| **PBS Drug Pricing** | `/v1/pbs` | 14,000+ medications on Australia''s Pharmaceutical Benefits Scheme |
| **Rental Market** | `/v1/rental` | Median weekly rent by suburb and postcode across Australia |
| **RBA Economic Data** | `/v1/rba` | Cash rate, AUD FX rates, CPI inflation, mortgage rates, credit aggregates |
---
## MCP Server
All four data domains are also available as MCP tools at:
```
https://api.aristocles.com.au/mcp/
```
Connect any MCP-compatible AI agent (Claude, GPT, Gemini) to get structured data without writing API calls.'
version: 2.1.0
tags:
- name: Weather Alerts
description: 'Active public weather alerts issued by the U.S. National Weather Service, including tornado, hurricane, flood, winter storm, red flag and extreme heat warnings. Each alert carries the event type, affected area description, severity, urgency, certainty and the time window it applies to. Logistics platforms, insurers, field-service schedulers and operations agents use it to reroute work and warn staff before conditions hit. Source: Source: NOAA / National Weather Service, api.weather.gov.. Licence: Public Domain (U.S. Government work, 17 U.S.C. 105). Base path: /v1/data/united-states-severe-weather-alerts. Requires an API key (X-API-Key).'
paths:
/v1/data/united-states-severe-weather-alerts:
get:
tags:
- Weather Alerts
summary: List United States Severe Weather Alerts records
description: 'List United States Severe Weather Alerts records with optional filters and pagination.
**Source:** Source: NOAA / National Weather Service, api.weather.gov. (Public Domain (U.S. Government work, 17 U.S.C. 105)).
**Fields returned:**
- `alert_id` (str) — Unique National Weather Service alert identifier
- `event` (str) — Alert type, e.g. Tornado Warning or Flood Watch
- `headline` (str) — One-line human readable headline for the alert
- `area_description` (str) — Counties, zones or regions covered by the alert
- `severity` (str) — Extreme, Severe, Moderate, Minor or Unknown
- `urgency` (str) — Immediate, Expected, Future, Past or Unknown
- `certainty` (str) — Observed, Likely, Possible, Unlikely or Unknown
- `status` (str) — Actual, Exercise, Test or Draft
- `message_type` (str) — Alert, Update or Cancel
- `sender_name` (str) — Issuing weather forecast office
- `effective_at` (date) — When the alert takes effect
- `expires_at` (date) — When the alert expires
**Example:** `GET /v1/data/united-states-severe-weather-alerts?limit=10&event=example`'
operationId: list_endpoint_v1_data_united_states_severe_weather_alerts_get
parameters:
- name: limit
in: query
required: false
schema:
type: integer
maximum: 100
minimum: 1
description: Max records to return (1-100).
default: 25
title: Limit
description: Max records to return (1-100).
- name: offset
in: query
required: false
schema:
type: integer
minimum: 0
description: Records to skip, for pagination.
default: 0
title: Offset
description: Records to skip, for pagination.
- name: event
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Alert type, e.g. Tornado Warning or Flood Watch
examples:
- example
title: Event
description: Alert type, e.g. Tornado Warning or Flood Watch
- name: severity
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Extreme, Severe, Moderate, Minor or Unknown
examples:
- example
title: Severity
description: Extreme, Severe, Moderate, Minor or Unknown
- name: urgency
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Immediate, Expected, Future, Past or Unknown
examples:
- example
title: Urgency
description: Immediate, Expected, Future, Past or Unknown
- name: status
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Actual, Exercise, Test or Draft
examples:
- example
title: Status
description: Actual, Exercise, Test or Draft
- name: sender_name
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Issuing weather forecast office
examples:
- example
title: Sender Name
description: Issuing weather forecast office
- name: X-API-Key
in: header
required: true
schema:
type: string
title: X-Api-Key
responses:
'200':
description: A page of United States Severe Weather Alerts records with pagination metadata.
content:
application/json:
schema: {}
example:
data:
items:
- alert_id: example
event: example
headline: example
area_description: example
severity: example
urgency: example
certainty: example
status: example
message_type: example
sender_name: example
effective_at: '2026-01-01'
expires_at: '2026-01-01'
total: 1
limit: 25
offset: 0
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/data/united-states-severe-weather-alerts/search:
get:
tags:
- Weather Alerts
summary: Search United States Severe Weather Alerts by area_description
description: 'Search United States Severe Weather Alerts records by `area_description` (partial, case-insensitive).
**Example:** `GET /v1/data/united-states-severe-weather-alerts/search?q=exa`'
operationId: search_endpoint_v1_data_united_states_severe_weather_alerts_search_get
parameters:
- name: q
in: query
required: true
schema:
type: string
minLength: 2
maxLength: 100
description: Case-insensitive partial match on area_description.
examples:
- exa
title: Q
description: Case-insensitive partial match on area_description.
- name: limit
in: query
required: false
schema:
type: integer
maximum: 100
minimum: 1
description: Max records to return (1-100).
default: 25
title: Limit
description: Max records to return (1-100).
- name: X-API-Key
in: header
required: true
schema:
type: string
title: X-Api-Key
responses:
'200':
description: Matching United States Severe Weather Alerts records.
content:
application/json:
schema: {}
example:
data:
items:
- alert_id: example
event: example
headline: example
area_description: example
severity: example
urgency: example
certainty: example
status: example
message_type: example
sender_name: example
effective_at: '2026-01-01'
expires_at: '2026-01-01'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/data/united-states-severe-weather-alerts/{key}:
get:
tags:
- Weather Alerts
summary: Get one United States Severe Weather Alerts record by alert_id
description: 'Fetch a single United States Severe Weather Alerts record by its `alert_id`.
**Example:** `GET /v1/data/united-states-severe-weather-alerts/example`'
operationId: get_endpoint_v1_data_united_states_severe_weather_alerts__key__get
parameters:
- name: key
in: path
required: true
schema:
type: string
description: The alert_id value to look up (case-insensitive).
examples:
- example
title: Key
description: The alert_id value to look up (case-insensitive).
- name: X-API-Key
in: header
required: true
schema:
type: string
title: X-Api-Key
responses:
'200':
description: A single United States Severe Weather Alerts record.
content:
application/json:
schema: {}
example:
data:
alert_id: example
event: example
headline: example
area_description: example
severity: example
urgency: example
certainty: example
status: example
message_type: example
sender_name: example
effective_at: '2026-01-01'
expires_at: '2026-01-01'
'404':
content:
application/json:
example:
error:
code: NOT_FOUND
message: No United States Severe Weather Alerts record for '...'.
description: Not Found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError