List Channels

List public channels with HTTP GET

Request

HTTP Method

GET

URL

https://api.thingspeak.com/channels/public.<format>

Input Arguments

Name	Description
<format>	(Required) Format for the HTTP response, specified as json or xml.

Example: https://api.thingspeak.com/channels/public.json

Query String Parameters

There are no available parameters for this request.

Response

Success

HTTP Status Code

200 OK

Body

 JSON Example

GET https://api.thingspeak.com/channels/public.json

The response is a JSON object of public channels, for example: { "pagination": { "current_page": 1, "per_page": 15, "total_entries": 653 }, "channels": [ { "id": 9, "name": "my_house", "description": "Netduino Plus connected to sensors around the house", "latitude": "40.44", "longitude": "-79.996", "created_at": "2010-12-13T20:20:06-05:00", "elevation": "", "last_entry_id": 6062691, "ranking" :100, "username":"iothans", "tags": [ { "id": 9, "name": "temp" },{ "id": 25, "name": "light" } ] }, { "id": 5683, "name": "Residential Data Points", "description": "Arduino Uno + Ethernet Shield", "latitude": "35.664548", "longitude": "-78.654972", "created_at": "2013-05-15T12:33:57-04:00", "elevation": "100", "last_entry_id": 731713, "ranking": 100, "username": "samlro", "tags": [ { "id": 950, "name": "Analog Inputs" } ] } ] }

 XML Example

GET https://api.thingspeak.com/channels/public.xml

The response is an XML object of public channels, for example: <?xml version="1.0" encoding="UTF-8"?> <response> <pagination> <current-page type="WillPaginate::PageNumber">1</current-page> <per-page type="integer">15</per-page> <total-entries type="integer">654</total-entries> </pagination> <channels type="array"> <channel> <id type="integer">9</id> <name>my_house</name> <description> Netduino Plus connected to sensors around the house </description> <latitude type="decimal">40.44</latitude> <longitude type="decimal">-79.996</longitude> <created-at type="dateTime">2010-12-13T20:20:06-05:00</created-at> <elevation/> <last-entry-id type="integer">6062720</last-entry-id> <ranking type="integer">100</ranking> <username>iothans</username> <tags type="array"> <tag> <id type="integer">9</id> <name>temp</name> </tag> <tag> <id type="integer">25</id> <name>light</name> </tag> </tags> </channel> <channel> <id type="integer">5683</id> <name>Residential Data Points</name> <description>Arduino Uno + Ethernet Shield</description> <latitude type="decimal">35.664548</latitude> <longitude type="decimal">-78.654972</longitude> <created-at type="dateTime">2013-05-15T12:33:57-04:00</created-at> <elevation>100</elevation> <last-entry-id type="integer">731720</last-entry-id> <ranking type="integer">100</ranking> <username>samlro</username> <tags type="array"> <tag> <id type="integer">950</id> <name>Analog Inputs</name> </tag> </tags> </channel> </channels> </response>

Error

For the full list, see Error Codes.

Examples

List Channels in JSON Format

https://api.thingspeak.com/channels/public.json

You can use your web browser to complete GET HTTP requests to the RESTful API for ThingSpeak™. To see the format for an HTTP response, click the link or copy it to your browser.

List Channels in XML Format

https://api.thingspeak.com/channels/public.xml

You can use your web browser to complete GET HTTP requests to the RESTful API for ThingSpeak. To see the format for an HTTP response, click the link or copy it to your browser.