Representational state transfer (REST) is an architectural style designed as a request-response model that communicates over HTTP. ThingSpeak, an IoT platform, uses the REST API calls GET, POST, PUT, and DELETE to create and delete channels, read and write channel data, and clear the data in a channel. A web browser or client sends a request to the server, which responds with data in the requested format. Web browsers use this interface to retrieve web pages or to send data to remote servers.
You can also use REST API calls with Act on Data which let you interact with social media, web services, and devices.
REST API Reference
|Read data from all fields in channel with HTTP GET|
|Read data from single field of channel with HTTP GET|
|Read status field of channel with HTTP GET|
|Read last entry in channel with HTTP GET|
|Read last entry in channel field with HTTP GET|
|Read last status of channel with HTTP GET|
|Update channel data with HTTP GET or POST|
|Write many entries to channel in JSON format with single HTTP POST|
|Write many entries to channel in CSV format with single HTTP POST|
|Write channel image with HTTP POST|
|Delete image from channel with HTTP DELETE|
|Read status of image request with HTTP GET|
View Channels and Channel Settings
|List channels for username with HTTP GET|
|List your channels with HTTP GET|
|List public channels with HTTP GET|
|Read channel settings with HTTP GET|
|Update channel settings with HTTP PUT|
Create and Delete
|Create new channel with HTTP POST|
|Clear all data from channel with HTTP DELETE|
|Delete channel with HTTP DELETE|
Read Entry Age
|Read number of seconds since last entry in channel with HTTP GET|
|Read number of seconds since last entry in field with HTTP GET|
|Add TalkBack command to TalkBack queue|
|Get TalkBack command from TalkBack queue|
|Get all TalkBack commands from TalkBack queue|
|Get last executed TalkBack command from TalkBack queue|
|Update command in TalkBack queue|
|Execute next TalkBack command in TalkBack queue|
|Update channel data with HTTP GET or POST and execute TalkBack command|
|Delete TalkBack command from TalkBack queue|
|Delete all TalkBack commands in TalkBack queue|
- Choose Between REST API and MQTT API
Learn when to use REST and MQTT to update a channel.
- Bulk-Update Using an Arduino or an ESP8266
This example shows how to use either an Arduino® MKR1000 board or an ESP8266 board connected to a Wi-Fi® network to continuously collect Wi-Fi signal strength and bulk-update a ThingSpeak™ channel.
- Bulk-Update a ThingSpeak Channel Using a Particle Photon Board
This example shows how to use a Particle Photon board connected to a Wi-Fi® network to bulk-update a ThingSpeak™ channel.
- Bulk-Update Using a Raspberry Pi Board
This example shows how to collect data using a Wi-Fi-connected Raspberry Pi board running Python 2.7.
- Time Zones Reference
Add time zone parameter to your HTTP request.
See the details of ThingSpeak REST API error messages and corresponding HTTP status codes.