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

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

Your Ambient Weather applicationKey and apiKey are stored once, encrypted, by your own Jentic One instance and injected at execution time. Neither key enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as '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 reference docs.

Time to first call

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. Run it through Jentic One, the self-hosted execution layer.

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.

Can I limit what my agent is allowed to do with the Ambient Weather API?

Yes. Because you run Jentic One yourself, your own rules decide which Ambient Weather operations your agent may call and which credentials it may use. Since the device id sits in the URL path (GET /devices/{macAddress}), you can pin the agent to a single station so it reads observations for that MAC address and nothing else. You also choose whether to expose the station-listing call (GET /devices), so the full account device list stays out of reach unless you add it.