UnifyAPI
← Back to catalog

opensensemap.sensor_timeseries

mock data$0.002 / call

OpenSenseMap Sensor Time-Series Data

Retrieve historical time-series measurements for a specific sensor on an OpenSenseMap station. Returns up to 10,000 measurement points (value + ISO 8601 timestamp) in reverse-chronological order (newest first). Specify box_id and sensor_id (both from box_search or sensors_latest), and optionally narrow the window with from_date/to_date in ISO 8601 format. Sensors on active stations record every 1–10 minutes, so a 24-hour window for a station with 5-min intervals yields ~288 data points. Useful for charting pollution spikes, computing daily averages, building climate datasets, or triggering alerts on threshold crossings. Supports any sensor type: PM2.5 (µg/m³), temperature (°C), relative humidity (%), air pressure (hPa), UV intensity, CO₂ (ppm), and more. Source: OpenSenseMap, PDDL 1.0 public domain.

Weatherprovider: Opensensemap#opensensemap#weather

Input schema

limit

Maximum number of measurements to return, newest first (1–10000, default 100).

integer
box_idrequired

OpenSenseMap station (box) ID — the 24-character MongoDB ObjectId from box_search or box_detail results (e.g. "578207d56fea661300861f3b").

string
to_date

End of time range in ISO 8601 format (e.g. "2024-01-02T00:00:00.000Z"). Defaults to now.

string
from_date

Start of time range in ISO 8601 format (e.g. "2024-01-01T00:00:00.000Z"). Defaults to 2 days ago.

string
sensor_idrequired

Sensor ID within the station — the 24-character MongoDB ObjectId found in sensors_latest or box_detail sensor list (e.g. "578207d56fea661300861f3d").

string

Call via REST

curl -X POST https://unifyapi.pro/api/call/opensensemap.sensor_timeseries \
  -H "Authorization: Bearer uak_live_..." \
  -H "Content-Type: application/json" \
  -d '{"limit":100,"box_id":"<box_id>","to_date":"<to_date>","from_date":"<from_date>","sensor_id":"<sensor_id>"}'

Try it

Paste a UnifyAPI key (create one in the dashboard) and run a real call.