User Tools

Site Tools


version_2:get_values

Requesting entities values

This interface lists all the possible values of the user’s entities and their number of occurrence that are assigned to the given type and key. As an optional filter, start and end can be used to request only the keys of a specific timeframe.

Authentication required

Yes, please take a look at Authentication. To keep it simple, only the data parameter is mentioned on this page, but keep in mind that the other parameters are also necessary.

Response

JSON

Method

GET

Resource URL

Parameters

The sent JSON object data should contain the following parameters:

type

The service knows a fixed number of types. One has to be selected here.

key

The key of the entities of which you want to have the values.

start

An optional timestamp to only request a certain time frame.

end

An optional timestamp to only request a certain time frame.

Example

Request

data={
   "type":"APPSTART",
   "key":"app",
   "start":1370353514,
   "end":1370847439
}

Response

{
   "APIVersion":2,
   "result":1,
   "values":[
      {
         "value":"9GAG",
         "count":"72"
      },
      {
         "value":"Android System",
         "count":"6"
      },
      {
         "value":"Authenticator",
         "count":"5"
      },
      {
         "value":"BeautifulWidgets",
         "count":"4"
      },
      {
         "value":"BigBrother",
         "count":"26"
      },
      {
         "value":"Calendar",
         "count":"10"
      },
      {
         "value":"Chrome Beta",
         "count":"94"
      },
      {
         "value":"Clock",
         "count":"34"
      },
      {
         "value":"Contacts",
         "count":"42"
      },
      {
         "value":"Document Viewer",
         "count":"14"
      },
      {
         "value":"Dropbox",
         "count":"6"
      },
      {
         "value":"ES File Explorer",
         "count":"32"
      },
      {
         "value":"FreeCell",
         "count":"4"
      },
      {
         "value":"Gallery",
         "count":"7"
      },
      {
         "value":"Gmail",
         "count":"30"
      },
      {
         "value":"Google Play Store",
         "count":"12"
      },
      {
         "value":"Google Search",
         "count":"8"
      },
      {
         "value":"Google+",
         "count":"16"
      },
      {
         "value":"Hangouts",
         "count":"70"
      },
      {
         "value":"IMDb",
         "count":"4"
      },
      {
         "value":"JEFIT",
         "count":"2"
      },
      {
         "value":"Latitude CheckIn",
         "count":"2"
      },
      {
         "value":"Light Flow",
         "count":"2"
      },
      {
         "value":"Maps",
         "count":"64"
      },
      {
         "value":"MensaPlaner",
         "count":"4"
      },
      {
         "value":"Messaging",
         "count":"25"
      },
      {
         "value":"NICHTLUSTIG",
         "count":"2"
      },
      {
         "value":"NewsRob",
         "count":"70"
      },
      {
         "value":"Package installer",
         "count":"2"
      },
      {
         "value":"Phone",
         "count":"24"
      },
      {
         "value":"Plume",
         "count":"48"
      },
      {
         "value":"QuickDic",
         "count":"4"
      },
      {
         "value":"RealCalc",
         "count":"4"
      },
      {
         "value":"Screen On",
         "count":"12"
      },
      {
         "value":"SeriesGuide X",
         "count":"12"
      },
      {
         "value":"Settings",
         "count":"20"
      },
      {
         "value":"System UI",
         "count":"6"
      },
      {
         "value":"Threema",
         "count":"14"
      },
      {
         "value":"TuneIn Radio Pro",
         "count":"14"
      },
      {
         "value":"Usage Timelines Free",
         "count":"4"
      },
      {
         "value":"You Are Your Own Gym",
         "count":"4"
      },
      {
         "value":"imo",
         "count":"6"
      }
   ]
}

In case of an error, a different response is sent. Please take a look at Error Responses.

version_2/get_values.txt · Last modified: 01.05.2016 21:57 (external edit)