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.

Certain datasources will provide a list of suggestions, if the input provided was not valid. These suggestions will be found in the processedInput response field.

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. If the access parameter is not provided, the value of 'default graph access' on the settings page of the authenticated user is used.

Possible Values:
  • public 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>
  <graphsCreated>1</graphsCreated>
  <graphsFound>1</graphsFound>
  <datasetsRemaining>9</datasetsRemaining>
  <datasetsMax>10</datasetsMax>
  <dataSource>
    <id>115</id>
    <name>Twitter Search</name>
    <description>Track the number of statuses containing a given keyword or phrase on an hourly basis.</description>
    <isFeaturedPartner>true</isFeaturedPartner>
    <inputProcessor>
      <name>TwitterSearch</name>
      <alias>TwitterSearch</alias>
      <description>TwitterSearch.description</description>
    </inputProcessor>
  </dataSource>
  <graphs>
    <graph>
      <title>trendrr (Number of Matching Twitter Posts per Hour)</title>
      <createdOn>2009-06-09T15:44:11</createdOn>
      <id>408224</id>
      <link>http://www.trendrr.com/timeseries/trendrr_(Number_of_Matching_Twitter_Posts_per_Hour)__408224</link>
      <creator>dustin</creator>
      <graphType>overlay</graphType>
      <graphScale>absolute</graphScale>
      <timeFrameStart>2009-06-16T17:08:06</timeFrameStart>
      <timeFrameEnd>2009-07-16T17:08:06</timeFrameEnd>
      <numDatasets>1</numDatasets>
      <datasets>
        <dataset>
          <dataSourceName>Number of Matching Twitter Posts per Hour</dataSourceName>
          <lastUpdated>2009-07-16T13:03:32</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>536700</id>
          <totalPoints>5633</totalPoints>
          <drawTrendLine>false</drawTrendLine>
          <values />
          <dataStartedCollecting>2008-11-06T20:12:09</dataStartedCollecting>
        </dataset>
      </datasets>
    </graph>
    <graph>
      <title>trendrr (Number of Matching Twitter Posts per Day)</title>
      <createdOn>2009-06-09T15:44:11</createdOn>
      <id>408225</id>
      <link>http://www.trendrr.com/timeseries/trendrr_(Number_of_Matching_Twitter_Posts_per_Day)__408225</link>
      <creator>dustin</creator>
      <graphType>overlay</graphType>
      <graphScale>absolute</graphScale>
      <timeFrameStart>2009-06-16T17:08:11</timeFrameStart>
      <timeFrameEnd>2009-07-16T17:08:11</timeFrameEnd>
      <numDatasets>1</numDatasets>
      <datasets>
        <dataset>
          <dataSourceName>Number of Matching Twitter Posts per Day</dataSourceName>
          <lastUpdated>2009-07-16T00:15:23</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>536701</id>
          <totalPoints>246</totalPoints>
          <drawTrendLine>false</drawTrendLine>
          <values />
          <dataStartedCollecting>2008-11-06T20:12:09</dataStartedCollecting>
        </dataset>
      </datasets>
    </graph>
  </graphs>
  <processedInput>
    <id>708</id>
    <input1>trendrr</input1>
    <alias>trendrr</alias>
    <suggestions />
  </processedInput>
  <resultCode>1</resultCode>
  <resultMessage>Successfully started tracking &lt;i&gt;trendrr&lt;/i&gt; on &lt;i&gt;Twitter Search&lt;/i&gt;&lt;br /&gt;Found  2 graphs in your account that match this input.</resultMessage>

</result>