Enter API key here:
OR
Request an API key
API usage guidelines:
Authentication

To get your API Key, see Request an API Key. Once obtained, you can pass it in your requests with the X-API-KEY-TOKEN header. It has a perpetual validity.

Note that upon successful login in this page, API key is automatically added to your requests

Want to integrate Foobot API in your application? We also implemented OAuth2 so you can retrieve and manage user authentication tokens. Let us know about your plans!

HTTP methods

Foobot API supports GET and POST methods.

Security

Although the API is available in plain HTTP, we strongly recommend using HTTPS. And that, for both accessing this page (where you can try the endpoints) and calling the API with your preferred HTTP client.

Your API key is strictly personal and should be kept in a safe place, as you would do with a password.

Output formats

The main output format is JSON. Some endpoints are able to return data in CSV (see Data point API). In that case you can add a 'Accept:text/csv' header to your request.

Responses are encoded in UTF-8, and so must be your requests.

For performance purposes, we also support gzip encoding of the response: add 'Accept-Encoding:gzip' header to your request to get a compressed response body.

Quotas & throttling

API keys are issued with a 200 requests/device/day quota. So if you have 2 Foobots, you're allowed to query the API 400 times.

We can apply throttling in case of excessive requests number. We generally do not allow more than 1 request per second.

Best practices

A Foobot sends data every 5 minutes. It is therefore useless to request datapoints more often.

Request only few datapoints per request. If you provide a wide time range, the response will be slower. A valid example would be to issue a call every hour, with start time being current time minus 1 hour.

Release notes

2019-01-07: Outdoor pollution data API added.

2018-01-25: Added filtering based on sensor type, A list of sensors can be specified in the request to the API.

2016-09-05: simplify authentication, API key is now the only authentication token required in the requests.