Ambee

DATA · DATA & ANALYTICS

Air quality, pollen, weather, and wildfire data for any place they ask about.

Connect Ambee with Fabriq Developer

Your user pastes their Ambee credential on a page Agentic Fabriq hosts, so it never reaches your backend and never becomes one shared key across all of your users. Same call as OAuth, one more argument.

from af_sdk import AgenticFabriq

af = AgenticFabriq()                      # reads AF_APP_ID / AF_APP_SECRET

url = await af.initiate_connection(request, provider="ambee", method="api_key")
return redirect(url)                      # an AF-hosted page, not yours

async with await af.for_user(request) as session:
    tools = await session.get_tools()     # only what this user granted

Provider names are surfaces, not vendors, and the authoritative list is the capabilities endpoint rather than any page including this one — an unknown name returns 400 with the valid list. Fabriq Developer is free to start and needs no provider paperwork. Start free or read the quickstart.

Connecting Ambee in practice

Ambee splits "you are going too fast" from "you have used up your plan" into two different status codes — 429 for rate limit and 422 for Quota exceeded — and adds 403 when the key simply is not licensed for that dataset. Three quite different problems all present as a failed call, and the fix differs each time.

Worth knowing

403 means "the API key doesn’t have the permissions" for that product, so a key that works against Air Quality can fail against Pollen with no change in how it is used.
History endpoints require `from` and `to` in the exact format "YYYY-MM-DD hh:mm:ss", not ISO 8601, so a naive timestamp serialisation is rejected.
aqiStandard defaults to EPA, so an agent reporting air quality outside the United States reports it on the wrong scale unless it explicitly passes IN, UK, CN or CA.
Ambee publishes no numeric per-plan rate limits in the API documentation, only the 429 and 422 codes and advice to reduce frequency or upgrade, so the ceiling has to be measured.

Checked against Ambee API overview (2026-09-29), Ambee Air Quality API (2026-09-29)

Acts as the person, not as itself

Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.

Credentials never touch the agent

Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.

Every call on the record

Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.

What an agent can do

Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.

ambee_get_disasters_by_eventidREAD

One disaster event, addressed by Ambee's own event id.

api

ambee_get_disasters_historyREAD

Natural-disaster events recorded worldwide from a point in time.

api

ambee_get_disasters_history_by_continentREAD

Natural-disaster events recorded across a continent over a time window.

api

ambee_get_disasters_history_by_country_codeREAD

Natural-disaster events recorded in a country over a time window.

api

ambee_get_disasters_history_by_lat_lngREAD

Natural-disaster events recorded near a latitude/longitude over a time window.

api

ambee_get_disasters_history_by_source_eventidREAD

The historical record for one disaster event, addressed by the identifier its upstream source gave it.

api

ambee_get_disasters_latest_by_continentREAD

Natural-disaster events currently reported across a continent, optionally narrowed to one country.

api

ambee_get_disasters_latest_by_country_codeREAD

Natural-disaster events currently reported in a country.

api

ambee_get_disasters_latest_by_lat_lngREAD

Natural-disaster events currently reported near a latitude/longitude.

api

ambee_get_disasters_latest_by_source_eventidREAD

The current record for one disaster event, addressed by the identifier its upstream source gave it.

api

ambee_get_elevation_latest_by_lat_lngREAD

Ground elevation at a latitude/longitude.

api

ambee_get_elevation_latest_by_placeREAD

Ground elevation at a named place.

api

ambee_get_fire_latest_by_lat_lngREAD

Wildfires detected near a latitude/longitude.

api

ambee_get_fire_latest_by_placeREAD

Wildfires detected near a named place.

api

ambee_get_fire_risk_by_lat_lngREAD

Wildfire risk outlook for a latitude/longitude.

api

ambee_get_fire_risk_by_placeREAD

Wildfire risk outlook for a named place.

api

ambee_get_forecast_aq_by_lat_lngREAD

Forecast air quality for a latitude/longitude.

api

ambee_get_geocode_by_placeREAD

Resolve a free-text place name to coordinates.

api

ambee_get_geocode_reverse_by_lat_lngREAD

Resolve a latitude/longitude to a place.

api

ambee_get_history_by_lat_lngREAD

Historical air-quality readings for a latitude/longitude over a time window.

api

ambee_get_history_by_postal_codeREAD

Historical air-quality readings for a postal code over a time window.

api

ambee_get_ili_forecast_by_lat_lngREAD

Influenza-like-illness (ILI) forecast for a latitude/longitude.

api

ambee_get_latest_by_cityREAD

Latest air-quality reading for a named city.

api

ambee_get_latest_by_country_codeREAD

Latest air-quality readings for a country, by ISO country code.

api

ambee_get_latest_by_lat_lngREAD

Latest air-quality reading -- AQI plus pollutant concentrations -- for a latitude/longitude.

api

ambee_get_latest_by_postal_codeREAD

Latest air-quality reading for a postal code within a country.

api

ambee_get_v3_pollen_forecast_120hrsREAD

Pollen forecast for the next 120 hours. Address the location EITHER with lat and lng OR with place.

api

ambee_get_v3_pollen_forecast_48hrsREAD

Pollen forecast for the next 48 hours. Address the location EITHER with lat and lng OR with place.

api

ambee_get_v3_pollen_historyREAD

Historical pollen counts over a time window. Address the location EITHER with lat and lng OR with place.

api

ambee_get_v3_pollen_latestREAD

Latest pollen counts and risk levels. Address the location EITHER with lat and lng OR with place -- Ambee's own examples show both and neither is required on its own.

api

ambee_get_weather_forecast_by_lat_lngREAD

Weather forecast for a latitude/longitude.

api

ambee_get_weather_history_by_lat_lngREAD

Historical weather for a latitude/longitude over a time window.

api

ambee_get_weather_latest_by_lat_lngREAD

Current weather conditions for a latitude/longitude.

api