Ambient Weather API

Name: Ambient Weather API
Brand: Ambient Weather API
Availability: InStock

✓ Official Vendor SpecIOTSensor DataapiKey2 EndpointsREST

For Agents

Lets agents list a user's Ambient Weather stations and pull historical readings (temperature, wind, rain, humidity, UV) from a specific station by MAC address using paired applicationKey and apiKey query parameters.

Install Jentic One Beta

Connect the Ambient Weather API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Ambient Weather API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Ambient Weather API.

List every Ambient Weather station registered to a user account along with its MAC address and metadata

Pull historical observations from a single station identified by MAC address over a chosen end-date window

Aggregate readings across multiple personal stations belonging to the same account

GET STARTED

Start building with Ambient Weather API

Explore with Jentic

View OpenAPI Document

The Ambient Weather API exposes data from personal weather stations connected to the Ambient Weather network. Two GET endpoints let an integration list the stations linked to an account and pull historical or near-real-time observations from a specific station by MAC address. Authentication uses paired query-string keys (applicationKey identifying the integration plus apiKey identifying the user) sent against rt.ambientweather.net/v1. Typical consumers are home-automation dashboards, hyperlocal weather services, and research projects that piggyback on the network's hardware.

Use Cases

Patterns agents use Ambient Weather API for, with concrete tasks.

★ Hyperlocal Weather Dashboard

Owners of Ambient Weather stations can build a personal dashboard that polls GET /devices for their station list, then iterates through GET /devices/{macAddress} to chart temperature, humidity, wind, and rain over the last day. The two-call flow keeps the integration trivial — each call needs only the paired applicationKey and apiKey. Most home dashboards are wired in within an afternoon.

Call GET /devices to list stations, then call GET /devices/{macAddress} for the first station and return the latest tempf and humidity values

Hyperlocal Forecast Augmentation

Hyperlocal weather services and research projects can supplement model forecasts with ground-truth observations from Ambient Weather's network of personal stations. A single GET /devices/{macAddress} call returns the station's recent observation history, which the service can ingest alongside other sensor feeds to refine micro-climate predictions for a neighbourhood or property.

Call GET /devices/{macAddress} with endDate set to the current ISO timestamp and return the last 12 observation records

Smart-Home Irrigation and Outdoor Automations

Smart-home platforms can use a backyard Ambient Weather station to skip a sprinkler cycle when rain has already fallen or to retract awnings when wind picks up. The agent polls the device endpoint at a fixed interval, reads the rain and windgustmph fields, and triggers the right home rule. The two-endpoint surface keeps the polling loop simple.

Poll GET /devices/{macAddress} every 10 minutes and trigger an irrigation skip rule when the dailyrainin value is greater than 0.25

AI Agent Weather Sensor Lookups

Smart-home or operations agents can query Ambient Weather through Jentic without storing the user's apiKey or the integration's applicationKey. The agent searches Jentic for a station-data intent, loads the operation schema, and Jentic injects both keys at execution time. Useful when the same agent already calls calendar, climate-control, or notification APIs.

Search Jentic for 'list my Ambient Weather stations', execute the operation backed by GET /devices, and return the macAddress for the station named 'Backyard'

Key Endpoints

2 endpoints — the ambient weather api exposes data from personal weather stations connected to the ambient weather network.

METHOD

PATH

DESCRIPTION

GET

/devices

List all stations on the user's account

GET

/devices/{macAddress}

Get historical observations for a specific station

GET

/devices

List all stations on the user's account

GET

/devices/{macAddress}

Get historical observations for a specific station

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Ambient Weather applicationKey and apiKey pair is stored encrypted in the Jentic vault. Agents receive scoped execution capability — neither key enters the agent's context, prompts, or logs.

Intent-based discovery

Agents search Jentic by intent (e.g. 'list my weather stations' or 'get station observations') and Jentic returns the matching Ambient Weather operation with its input schema, so the agent calls the right endpoint without browsing the apiary docs.

Time to first call

Direct Ambient Weather integration: 2-4 hours for key handling, polling, and rate-limit management. Through Jentic: under 15 minutes — search, load schema, execute.

FAQs

Specific to using Ambient Weather API through Jentic.

What authentication does the Ambient Weather API use?

Ambient Weather uses a paired-key scheme: applicationKey (issued to the integration) and apiKey (issued to the end user) both sent as query parameters on every request. There is no OAuth flow. Through Jentic, both keys are stored encrypted in the vault and injected at execution time, so the agent never sees them.

Can I list all the weather stations on my account?

Yes. GET /devices returns the array of stations linked to the apiKey, including each station's MAC address, info block, and the latest observations. Use that MAC address to call GET /devices/{macAddress} for historical detail.

What are the rate limits for the Ambient Weather API?

Ambient Weather caps at 1 request per second per applicationKey and apiKey pair. Bursts above that return HTTP 429. Plan polling intervals around this — most home dashboards poll every 30-60 seconds, well under the limit.

How do I get a station's recent observations through Jentic?

Search Jentic for 'get Ambient Weather station observations'. Jentic returns the operation backed by GET /devices/{macAddress}, you load the schema (the only required input is the macAddress), and execute. Jentic injects the applicationKey and apiKey from the vault. Sign up at https://app.jentic.com/sign-up.

How far back does the historical observation window go?

GET /devices/{macAddress} accepts an endDate parameter and returns up to 288 records ending at that timestamp (one record every 5 minutes, ~24 hours). To pull older history, page backwards by setting endDate to the earliest timestamp from the previous call.

Does the Ambient Weather API include weather forecasts?

No. This API exposes observations from personal weather stations only — there is no forecast endpoint. Pair it with a forecast provider (OpenWeatherMap, WeatherAPI) when you need predictions alongside ground-truth station data.