Users




Response in: TEXTJSONXML

Get User Information


To get a user's information, send an HTTP GET to https://api.thingspeak.com/users/USERNAME.json.xml , replacing USERNAME with the person's username.

Valid parameters:
  • api_key (string) - User's API Key which, if provided, will show private information such as email addresses. (optional)

Example GET:
GET https://api.thingspeak.com/users/hans.json.xml

The response will be a webpage with information about the user.
The response will be a JSON object of the user, for example:
{
  "id": 4,
  "login": "hans",
  "created_at": "2010-12-03T09:17:52-05:00",
  "bio": "Web Developer @iobridge, @thingspeak",
  "website": "http://www.iamshadowlord.com"
}
The response will be an XML object of the user, for example:
<?xml version="1.0" encoding="UTF-8"?>
<user>
  <id type="integer">4</id>
  <login>hans</login>
  <created-at type="dateTime">2010-12-03T09:17:52-05:00</created-at>
  <bio>Web Developer @iobridge, @thingspeak</bio>
  <website>http://www.iamshadowlord.com</website>
</user>

Response in: TEXTJSONXML

List User's Channels


To get a list of a user's Channels, send an HTTP GET to https://api.thingspeak.com/users/USERNAME/channels.json.xml , replacing USERNAME with the person's username.

Valid parameters:
  • api_key (string) - User's API Key which, if provided, will also show private channels. (optional)

Example GET:
GET https://api.thingspeak.com/users/hans/channels.json.xml

The response will be a webpage with a list of the user's Channels.
The response will be a JSON object of the user's Channels, for example:
{
  "channels":
  [
    {
      "id": 3,
      "name": "ioBridge Server",
      "description": "ioBridge IO-204 connected to web server",
      "latitude": null,
      "longitude": null,
      "created_at": "2010-12-03T09:26:23-05:00",
      "elevation": "",
      "last_entry_id": 163690,
      "ranking": 85,
      "username": "hans",
      "tags":
      [
        {
          "id": 24,
          "name": "temperature"
        }
      ]
    },
    {
      "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": 6062844,
      "ranking": 100,
      "username": "hans",
      "tags":
      [
        {
          "id": 9,
          "name": "temp"
        },
        {
          "id": 25,
          "name": "light"
        }
      ]
    }
  ]
}
The response will be an XML object of the user's Channels, for example:
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <channels type="array">
    <channel>
      <id type="integer">3</id>
      <name>ioBridge Server</name>
      <description>ioBridge IO-204 connected to web server</description>
      <latitude nil="true"/>
      <longitude nil="true"/>
      <created-at type="dateTime">2010-12-03T09:26:23-05:00</created-at>
      <elevation/>
      <last-entry-id type="integer">163690</last-entry-id>
      <ranking type="integer">85</ranking>
      <username>hans</username>
      <tags type="array">
        <tag>
          <id type="integer">24</id>
          <name>temperature</name>
        </tag>
      </tags>
    </channel>
    <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">6062860</last-entry-id>
      <ranking type="integer">100</ranking>
      <username>hans</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>
  </channels>
</response>