api
/api/account/start_tracking
June 18, 2008 5:31 PM
Use this to start tracking using any of the available trendrr datasources. Returns list of all the graphs that were created.

authentication is required

params:
return This value specifies how you would like the response sent back (either a success message or an error message).

Possible Values:
  • xml (Default) an xml feed
  • json returns the feed in JSON format
input1 (required) this is the input for the Data Source. ex. if the Data Source is twitter users, then the input would be the twitter username.
input2 Some Data Sources take more then one input. Ex. monster job listings requires a query (input1) and city (input2)
tags (required) Each tracked item requires at least one tag. This should be a url encoded string where each tag is separated by a space.
datasource_id (required) The id of the Data Source you would like to track. For a list of all the available data sources and their id's visit (you must be logged in to see the ids):
http://www.trendrr.com/dataSourceList.seam

Or you may obtain the list through the api call:
/api/account/data_sources
access Defines who is able to view the graphs/ data.

Possible Values:
  • public (Default) available to all
  • private private to your account
  • my friends All your friends

additionally you can use a comma seperated list of individual users or groups.


Example: 
http://www.trendrr.com/api/account/start_tracking?auth={authentication}&input1=trendrr&datasource_id=115&tags=trendrr,awesome


<?xml version="1.0" encoding="UTF-8"?>

<result>
  <datasetsRemaining>17</datasetsRemaining>
  <dataSource>
    <id>115</id>
    <name>Twitter Search</name>
  </dataSource>
  <graphs>
    <graph>
      <title>trendrr (Number of Matching Twitter Posts per Hour)</title>
      <createdOn>2008-11-13T22:55:44</createdOn>
      <id>408446</id>
      <link>http://www.trendrr.com/timeseries/trendrr_(Number_of_Matching_Twitter_Posts_per_Hour)__408446</link>
      <creator>dustismo</creator>
      <creatorUrl>http://www.trendrr.com/user/dustismo</creatorUrl>
      <graphType>overlay</graphType>
      <graphScale>absolute</graphScale>
      <timeFrameStart>2008-10-14T22:55:47</timeFrameStart>
      <timeFrameEnd>2008-11-13T22:55:47</timeFrameEnd>
      <numDatasets>1</numDatasets>
      <datasets>
        <dataset>
          <dataSourceName>Number of Matching Twitter Posts per Hour</dataSourceName>
          <lastUpdated>2008-11-13T17:09:30</lastUpdated>
          <dataStartedCollecting>2008-11-06T20:12:09</dataStartedCollecting>
          <color>99CC00</color>
          <input>http://search.twitter.com/search?q=trendrr</input>
          <legendText>trendrr</legendText>
          <renderType>line</renderType>
          <invert>false</invert>
          <id>536938</id>
          <totalPoints>86</totalPoints>
          <drawTrendLine>false</drawTrendLine>
          <values></values>
          <dataStartedCollecting>2008-11-06T20:12:09</dataStartedCollecting>
        </dataset>
      </datasets>
    </graph>
    <graph>
      <title>trendrr (Number of Matching Twitter Posts per Day)</title>
      <createdOn>2008-11-13T22:55:45</createdOn>
      <id>408447</id>
      <link>http://www.trendrr.com/timeseries/trendrr_(Number_of_Matching_Twitter_Posts_per_Day)__408447</link>
      <creator>dustismo</creator>
      <creatorUrl>http://www.trendrr.com/user/dustismo</creatorUrl>
      <graphType>overlay</graphType>
      <graphScale>absolute</graphScale>
      <timeFrameStart>2008-10-14T22:55:47</timeFrameStart>
      <timeFrameEnd>2008-11-13T22:55:47</timeFrameEnd>
      <numDatasets>1</numDatasets>
      <datasets>
        <dataset>
          <dataSourceName>Number of Matching Twitter Posts per Day</dataSourceName>
          <lastUpdated>2008-11-13T00:04:59</lastUpdated>
          <dataStartedCollecting>2008-11-06T20:12:09</dataStartedCollecting>
          <color>3366FF</color>
          <input>http://search.twitter.com/search?q=trendrr</input>
          <legendText>trendrr</legendText>
          <renderType>line</renderType>
          <invert>false</invert>
          <id>536939</id>
          <totalPoints>1</totalPoints>
          <drawTrendLine>false</drawTrendLine>
          <values></values>
          <dataStartedCollecting>2008-11-06T20:12:09</dataStartedCollecting>
        </dataset>
      </datasets>
    </graph>
  </graphs>
  <resultCode>1</resultCode>
  <resultMessage>Successfully added new Data Set. Data will starting gathering within 24 hours.</resultMessage>

</result>