Getting Started

Quick Start

1. Sign Up for a ThingSpeak account
2. Create a new Channel by going to your Channels page and clicking Create New Channel
3. Update your Channel via URL:
   <%= @ssl_api_domain %>update?api_key=YOUR_CHANNEL_API_KEY&field1=7
4. View your Channel feed:
   <%= @ssl_api_domain %>channels/YOUR_CHANNEL_ID/feeds.json
5. Follow a tutorial for common devices and applications

Support

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

Open Source

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.

• GitHub Repository for ThingSpeak
• ThingSpeak README and Setup Instructions

HTTP Headers

If you would like to reduce the number of HTTP headers sent by our application, please add the parameter headers=false to any HTTP request.

API keys can optionally be sent via HTTP headers by setting the header name to <%= HTTP_HEADER_API_KEY_NAME %> and the header value to the API key.

Time Zones Reference

Time zones can be specified for any request by adding the timezone parameter with a value corresponding to any identifier found below. Identifier names are case-sensitive, and should be URL-encoded in HTTP GET requests, for example:

GET <%= @ssl_api_domain %>channels/9/fields/1/last.json?timezone=America%2FNew_York

The most common time zone identifiers are listed below. ThingSpeak supports all IANA Time Zone Database identifers; a human-readable list is also available.

<% @timezones.each do |identifier, hash| %> <% end %>

Identifier	Description	Current Offset
<%= identifier %>	<%= raw(hash[:description]) %>	UTC <%= hash[:offset] %>