targetVol

Historics Preview targetVol type returns the number of times the specified target appeared in the results. This value is computed in hourly intervals. This type of preview will work with most targets. You can use it to quickly estimate the size (and cost) of a full-size Historics query job. To do that, add the hourly values reported by targetVol and multiply the result by 100. The targetVol preview is also useful when you want to find out how many interactions out of all interactions include specific information like geolocation or the numer of retweets, which lets you find out if the chosen dataset contains a significant amount of retweets.

Sample targets

Sample output data

The following example shows output for the top ten results of a targetVol preview on interaction.source (interaction.source,targetVol):

{
    "id": "4ffaee9aebd52ba37a7f",
    "name": "preview",
    "progress": 100,
    "status": "succeeded",
    "feeds": "twitter",
    "sample": 1,
    "end": 1359936000,
    "created_at": 1364305436,
    "start": 1359849600,
    "user": "12635",
    "parameters": "interaction.source,targetVol,hour",
    "hash": "c2307b18e06254647a52d7a9c0bcfe59",
    "data": [
        {
            "target": "interaction.source",
            "analysis": "targetVol",
            "output": {
                "2013/02/03 21:00:00": 3785,
                "2013/02/03 04:00:00": 3651,
                "2013/02/03 01:00:00": 3583,
                "2013/02/03 20:00:00": 3863,
                "2013/02/03 16:00:00": 4206,
                "2013/02/03 00:00:00": 3551,
                "2013/02/03 07:00:00": 2633,
                "2013/02/03 23:00:00": 4502,
                "2013/02/03 14:00:00": 4407,
                "2013/02/03 19:00:00": 3735,
                "2013/02/03 05:00:00": 3318,
                "2013/02/03 13:00:00": 4008,
                "2013/02/03 15:00:00": 4248,
                "2013/02/03 08:00:00": 2535,
                "2013/02/03 11:00:00": 3120,
                "2013/02/03 10:00:00": 2771,
                "2013/02/03 12:00:00": 3538,
                "2013/02/03 02:00:00": 3710,
                "2013/02/03 09:00:00": 2546,
                "2013/02/03 22:00:00": 4063,
                "2013/02/03 03:00:00": 3749,
                "2013/02/03 18:00:00": 3828,
                "2013/02/03 06:00:00": 2966,
                "2013/02/03 17:00:00": 4060
            },
            "interval": "hour"
        }
    ]
}

The following example shows output for a targetVol preview on twitter.user.friends_count (interaction.source,targetVol) and the results of a freqDist preview on interaction.source computed at hourly intervals:

{
    "id": "4ffaee9aebd52ba37a7f",
    "name": "preview",
    "progress": 100,
    "status": "succeeded",
    "feeds": "twitter",
    "sample": 1,
    "end": 1359936000,
    "created_at": 1364305436,
    "start": 1359849600,
    "user": "12635",
    "parameters": "interaction.source,targetVol,hour;interaction.source,freqDist,10",
    "hash": "c2307b18e06254647a52d7a9c0bcfe59",
    "data": [
        {
            "target": "interaction.source",
            "analysis": "targetVol",
            "output": {
                "2013/02/03 21:00:00": 3785,
                "2013/02/03 04:00:00": 3651,
                "2013/02/03 01:00:00": 3583,
                "2013/02/03 20:00:00": 3863,
                "2013/02/03 16:00:00": 4206,
                "2013/02/03 00:00:00": 3551,
                "2013/02/03 07:00:00": 2633,
                "2013/02/03 23:00:00": 4502,
                "2013/02/03 14:00:00": 4407,
                "2013/02/03 19:00:00": 3735,
                "2013/02/03 05:00:00": 3318,
                "2013/02/03 13:00:00": 4008,
                "2013/02/03 15:00:00": 4248,
                "2013/02/03 08:00:00": 2535,
                "2013/02/03 11:00:00": 3120,
                "2013/02/03 10:00:00": 2771,
                "2013/02/03 12:00:00": 3538,
                "2013/02/03 02:00:00": 3710,
                "2013/02/03 09:00:00": 2546,
                "2013/02/03 22:00:00": 4063,
                "2013/02/03 03:00:00": 3749,
                "2013/02/03 18:00:00": 3828,
                "2013/02/03 06:00:00": 2966,
                "2013/02/03 17:00:00": 4060
            },
            "interval": "hour"
        },
        {
            "target": "interaction.source",
            "analysis": "freqDist",
            "output": {
                "tweetdeck": 1100,
                "mobile web (m2)": 2170,
                "twitter for iphone": 19503,
                "twitter for android": 14838,
                "twittbot.net": 891,
                "web": 18731,
                "echofon": 908,
                "ubersocial for blackberry": 1162,
                "twitter for ipad": 1728,
                "twitter for blackberry®": 9829
            },
            "threshold": 10
        }
    ]
}