{"uid":"cap_G5W2NhlLwPNiJWJbyDrOU","slug":"aeml-air-quality-gauge-us-aqi-pm2-5-by-location-75b284eb","name":"AEML Air Quality Gauge — US AQI + PM2.5 by Location","description":"Add-on, air quality for one location: US AQI category and PM2.5 reading from EPA and CAMS official feeds. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. Every record carries an offline-recomputable record_hash.","url":"https://aeml-x402.zeabur.app/gauge/air","method":"GET","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["loc"],"properties":{"loc":{"type":"string","examples":["us-stlouis","us-memphis","us-losangeles","us-fresno","us-phoenix","us-denver"],"description":"required - location id; full list at free /gauge/preview","x-accepted-values":{"all":"https://api.truthbear.co/schemas/gauge-air.input.json","shown":6,"total":12}}},"additionalProperties":false}}},"output":{"type":"object","required":["type"],"properties":{"type":{"const":"json"}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_REGO4A6-KguXCNZREMXFs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current US AQI and PM2.5 readings (EPA/CAMS sources) for a specified location, with trend and change data.","exampleAgentPrompt":"What's the current US AQI and PM2.5 level in St. Louis right now, including whether it's been rising or falling recently?","exampleUseCases":[{"title":"Outdoor event health safety check","prompt":"Can you check the current air quality AQI and PM2.5 for us-chicago before our outdoor event this afternoon — I want to know if conditions are safe and whether it's been getting better or worse?"},{"title":"Asthma patient daily air check","prompt":"My doctor told me to avoid going outside when AQI is above 100 — what's the current air quality reading and PM2.5 level for us-losangeles, and has it been trending up or down?"},{"title":"Environmental journalist city comparison","prompt":"I'm writing a piece on air pollution — can you pull the current US AQI and PM2.5 readings for us-houston, including the data source and any trend over the past week?"}],"resultDescription":"Returns a structured JSON object with a readings array containing: current US AQI and PM2.5 values sourced from EPA/CAMS, previous-period values, 7-day trend data points, change delta and direction (rising/falling/stable), data grade disclosure (e.g. screening-level), source attribution with weights and timestamps, and a nature statement clarifying this is observational gauge data (not a forecast or recommendation).","failureModes":["Invalid or unsupported loc code returns an error or empty readings","Location outside US coverage area may return no data or partial results","Upstream EPA/CAMS data delays may result in stale as_of timestamps","Payment failure (x402) blocks access before data is returned","Truncated response schema fields if signal not applicable for location"],"whenToPreferThis":"Use this endpoint when you need current, source-attributed US AQI and PM2.5 air quality readings for a specific US city or region, especially when you need trend context (7-day) and honest data-grade disclosures. Prefer this over generic weather APIs that may not include AQI or PM2.5, and over forecast-only services when you need observational ground truth from EPA/CAMS sources.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:51:22.128Z","isFirstParty":false}