Documentation

Getting Started

Getting Support

Please post your questions, comments, and feature requests in the ThingSpeak Forum.

Channels

Channels are where your application stores and retrieves any type of data. Each channel has a Private View and a Public View. The Private View is only accessible by signing into your ThingSpeak.com user account. The Public View is what other viewers will see when they visit your ThingSpeak Channel. You can have different info on each view, customize the view with Plugins, and even disable the Public View.

ThingSpeak Channel Public View

Channel Views have the following features:

  • Channel Watch
  • Share via Social Networks
  • Developer Info
  • Ability to embed ThingSpeak Plugins
  • Drag-and-drop Organization
  • Tags
  • Comments

Channels API

To read and write to a ThingSpeak Channel, your application must make requests to the ThingSpeak API using HTTP requests. Each ThingSpeak Channel allows for 8 fields of data (both numeric and alphanumeric formats), location information, and a status update. Each entry is stored with a date and time stamp and is assigned a unique Entry ID (entry_id). After the data is stored, you can retrieve the data by time selection or by Entry ID. In addition to storing and retrieving numeric and alphanumeric data, the ThingSpeak API allows for numeric data processing such as timescaling, averaging, median, summing, and rounding. The channel feeds supports JSON, XML, and CSV formats for integration into applications.

Charts API

Use the Charts API to present numerical data stored in ThingSpeak Channels on charts. Supported chart types are line, bar, column, and step. Options include size, color, and labels.

Open Source API

The ThingSpeak API is available on GitHub and includes the complete ThingSpeak API for processing HTTP requests, storing numeric and alphanumeric data, numeric data processing, location tracking, and status updates.  The open source version follows the same documentation as the ThingSpeak hosted service.

Apps

ThingSpeak Apps are apps that make it easier for devices to access resources on the web such as social networks, web services, and APIs.

ThingTweet

ThingTweet is a Twitter Proxy that allows a device to send status updates to Twitter via simple API calls to the ThingTweet App.

ThingHTTP

ThingHTTP is for connecting things to web services via HTTP requests. ThingHTTP supports GET, POST, PUT, and DELETE methods, HTTP/1.0, HTTP/1.1, SSL, custom HTTP headers, and Basic Authentication.

TweetControl

TweetControl allows you to monitor your Twitter stream for a specific hashtag and associate it with a control action. The TweetControl App uses the Twitter Stream API and operates in real-time. You can create social controls via Twitter without having to run a dedicated server listening to the Twitter firehouse.

React

Reacts allow you to trigger a ThingHTTP request or send a tweet using ThingTweet when your ThingSpeak Channel meets a certain condition. For example, you can have your thermostat turn on by the time you get home from work by creating a Geo Location React.

Plugins

Plugins are way to create your applications natively on the ThingSpeak platform. You can create applications using HTML, CSS, and JavaScript to create mashups of ThingSpeak services with other web services. Plugins can either be private or public. Private plugins can only be viewed from a private ThingSpeak Channel view. Public Plugins can be embedded on your website or added to a ThingSpeak Channel view.

Example Plug In

Display a Google Gauge Visualization using ThingSpeak Plugins [Source Code]

Devices

The Devices tab in ThingSpeak is a place to store information about your devices such as an Arduino, Netduino, mBed, Spinneret, or an ioBridge device. The information you can store is name, model, public IP address, and public port number. The IP and port number will be used for a future dynamic DNS app and are optional.

By registering a device with ThingSpeak, you have access to the MAC Address App.  You can either generate a random MAC address or create a unique MAC address. The random MAC address generator simply generates a random hexadecimal MAC address. If you generate a unique MAC address, the generated MAC will be globally unique from our MAC Address pool. You may need a unique MAC address if you put more than one device on the same network.

Importer

Using the ThingSpeak Importer, you are able to import data from a CSV file directly into a ThingSpeak Channel. The access the Importer, select a Channel, and click Import Data.

The format for the CSV should be the following:

datetime,field1,field2,field3,field4,field5,field6,field7,field8,latitude,longitude,elevation,status

Here is an example CSV file: Sample CSV File

You only have to send a date time stamp and at least one field. The date time stamp can be in many formats such as epoch, ISO 8601, or MySQL time. If the date time includes a GMT/UTC offset, we will use that to properly import the data. If your date time stamps do not have a GMT / UTC offset, you can specify a time zone that the data was logged in.

  • Twitter
  • Facebook
  • Google Bookmarks
  • del.icio.us
  • StumbleUpon
  • Reddit
  • Digg
  • Add to favorites

4 comments

  1. How big of a csv file can be uploaded? I have tried 1.4MB and it won’t upload. Can it be gzipped or zipped?

    THanks,
    Joe

    • @joe

      We have not tested an upper size, so I don’t have specifics for you. The Data importer only works with *.csv right now, so ZIP is not going to help in this case. We will check deeper into the limits.

  2. How many tweets an hour can be triggered from Iobridge?

    Thanks

    Andy

Leave a comment