Build on the Internet of Things
Thingful is a search engine for the internet of things (IoT), providing a unique geographical index of connected objects around the world, including energy, radiation, weather, and air quality devices as well as seismographs, iBeacons, ships, aircraft and even animal trackers. Thingful’s powerful search capabilities enable you to find and use connected objects, sensors, datasets and realtime data sources across many popular Internet of Things networks.
Why use Thingful's API?
Thingful's RESTful API enables you to search for IoT/connected objects that you have authorisation to find near a specified geolocation. If you don't have access to any private things that Thingful knows about, you will only be able to discover public resources. You can retrieve both a snapshot of the data generated by the objects as well as the direct URL to query those devices directly. In future, you will also be able to use the API to retrieve real-time data, but that feature is limited at the moment.
Examples using Thingful
You might use Thingful data for analysis, visualisation, triggers, notifications or citizen-centric 'smart city' apps, among other things. Here are some examples:
- Thingful embed functionality in Wired's Connective iPad/Kindle special IoT publication
- Should I cycle today? – open source mobile web app that uses Thingful API to find air quality, weather, transportation and bike availability data along a route in order to make a holistic recommendation of the best current means of transport.
The Thingful API currently exposes its data via two protocols: JSON and Hypercat. Both specifications are basically JSON documents over HTTP, but where they differ is that Hypercat is very much intended to be a simple discovery mechanism by which IOT resources can be listed as a first step to making use of these resources, whereas our full API provides richer capabilities for interacting with the resources listed.
It's early days, so we are still gearing up to support other developers in using the Thingful API but these should help you get going:
- Thingful - IoT search engine - main website
- Quickstart / API base URL - returns a list of all endpoints
- API Documentation
- Hypercat 3.0 library - Python
- Hypercat 3.0 library - Go
- Sample query
Get in touch
We would love to help, so please drop us a line with any questions or feedback.
- Email: firstname.lastname@example.org
... or leave us a comment below.