Empathy Stats API V2 - Reports - Top Queries

This report calculate the top queries in the system for the selected date range and within the mandatory set of pivots.

Report ID: TopQueries

Input parameters (see common parameters)

Parameter nameTypeRequiredDescriptionDefault Value
top_kint(error)Number of results by group of pivots10
top_pctfloat(error)For each group of pivots percentile of values to return0
offsetint(error)The number of results to omit (from the start of the result set)0
rowsint(error)Number of results to return50
evolbool(error)Calculate the evolution for some of the fields in the responseFalse
pivotslist[str](tick)Group results by this valuesNone
groupint(error)Return results grouped by pivots (false, true)false
typeint(error)Type of queries to return (0: all, 1: queries w/results, 2: queries wo/results)0

Notes: top_k and top_pct params works together and the max. number of results to return is the minimum value between top_k and results over top_pct.

Responses

200 - successful information retrieve

Type: application/json
Example application/json
{
    "data": [
        {
            "terms": "camisetas",
            "query_count": 1,
            "filters": [
                {
                    "filter": "user_type",
                    "values": [
                        "recurrent"
                    ]
                },
                {
                    "filter": "scope",
                    "values": [
                        "mobile"
                    ]
                },
                {
                    "filter": "lang",
                    "values": [
                        "0"
                    ]
                },
                {
                    "filter": "store",
                    "values": [
                        "example"
                    ]
                }
            ]
        },
        {
            "terms": "camiseta",
            "query_count": 1,
            "filters": [
                {
                    "filter": "user_type",
                    "values": [
                        "recurrent"
                    ]
                },
                {
                    "filter": "scope",
                    "values": [
                        "desktop"
                    ]
                },
                {
                    "filter": "lang",
                    "values": [
                        "de"
                    ]
                },
                {
                    "filter": "store",
                    "values": [
                        "example"
                    ]
                }
            ]
        }
    ],
    "params": {
        "site_id": "sample",
        "start_date": 1506816000000,
        "end_date": 1513551600000,
        "filters": [],
        "offset": 0,
        "rows": 10,
        "evol": false,
        "top_k": 10,
        "pivots": [
            "lang"
        ],
        "group": false,
        "top_pct": 0,
        "type": 0
    }
}