Empathy Stats API V2 - Reports - Keyword

This report returns a set of all keywords used on queries. i.e: "blue dress" it'll return ["blue", "dress"]. You can now also specify the 'evol' parameter in order to obtain an evolution regarding some fields of each keyword, as previously you weren't able to specify it so it was automatically calculated.

Report ID: Keyword

Input parameters (see common parameters)

Parameter name	Type	Description	Default
offset	int	The number of results to omit (from the start of the result set)	0
rows	int	Number of results to return	50
evol	bool	Calculate the Evolution of each keyword	False
keyword	str	Given a keyword, find all those queries that contain it together with the times all the keywords appear	None
bucket	str	Bucket to apply when querying data (day, weekly)	day

Responses

200 - successful information retrieve

Type: application/json

Example response

{
    "data": [
        {
            "query_count": 232,
            "click_count": 23,
            "wishlist_count": 0,
            "add2cart_count": 0,
            "conversion_count": 11,
            "success_count": 0,
            "click_count_pct": 9.913794,
            "wishlist_count_pct": 0,
            "add2cart_count_pct": 0,
            "conversion_count_pct": 4.7413793,
            "success_count_pct": 0,
            "keyword": "camiseta",
            "query_count_pct": 38.926174,
            "query_count_evol": "NEW",
            "click_count_evol": "NEW",
            "wishlist_count_evol": "NEW",
            "add2cart_count_evol": "NEW",
            "conversion_count_evol": "NEW"
        },
        {
            "query_count": 75,
            "click_count": 12,
            "wishlist_count": 0,
            "add2cart_count": 0,
            "conversion_count": 8,
            "success_count": 0,
            "click_count_pct": 16,
            "wishlist_count_pct": 0,
            "add2cart_count_pct": 0,
            "conversion_count_pct": 10.666667,
            "success_count_pct": 0,
            "keyword": "camisa",
            "query_count_pct": 12.583892,
            "query_count_evol": "NEW",
            "click_count_evol": "NEW",
            "wishlist_count_evol": "NEW",
            "add2cart_count_evol": "NEW",
            "conversion_count_evol": "NEW"
        },
        {
            "query_count": 59,
            "click_count": 7,
            "wishlist_count": 0,
            "add2cart_count": 0,
            "conversion_count": 0,
            "success_count": 0,
            "click_count_pct": 11.864407,
            "wishlist_count_pct": 0,
            "add2cart_count_pct": 0,
            "conversion_count_pct": 0,
            "success_count_pct": 0,
            "keyword": "pantalon",
            "query_count_pct": 9.899328,
            "query_count_evol": "NEW",
            "click_count_evol": "NEW",
            "wishlist_count_evol": "NEW",
            "add2cart_count_evol": "NEW",
            "conversion_count_evol": "NEW"
        },
        {
            "query_count": 40,
            "click_count": 4,
            "wishlist_count": 0,
            "add2cart_count": 0,
            "conversion_count": 0,
            "success_count": 0,
            "click_count_pct": 10,
            "wishlist_count_pct": 0,
            "add2cart_count_pct": 0,
            "conversion_count_pct": 0,
            "success_count_pct": 0,
            "keyword": "camisetas",
            "query_count_pct": 6.711409,
            "query_count_evol": "NEW",
            "click_count_evol": "NEW",
            "wishlist_count_evol": "NEW",
            "add2cart_count_evol": "NEW",
            "conversion_count_evol": "NEW"
        },
        {
            "query_count": 17,
            "click_count": 1,
            "wishlist_count": 0,
            "add2cart_count": 0,
            "conversion_count": 0,
            "success_count": 0,
            "click_count_pct": 5.882353,
            "wishlist_count_pct": 0,
            "add2cart_count_pct": 0,
            "conversion_count_pct": 0,
            "success_count_pct": 0,
            "keyword": "flores",
            "query_count_pct": 2.852349,
            "query_count_evol": "NEW",
            "click_count_evol": "NEW",
            "wishlist_count_evol": "NEW",
            "add2cart_count_evol": "NEW",
            "conversion_count_evol": "NEW"
        },
        {
            "query_count": 16,
            "click_count": 1,
            "wishlist_count": 0,
            "add2cart_count": 0,
            "conversion_count": 0,
            "success_count": 0,
            "click_count_pct": 6.25,
            "wishlist_count_pct": 0,
            "add2cart_count_pct": 0,
            "conversion_count_pct": 0,
            "success_count_pct": 0,
            "keyword": "vestido",
            "query_count_pct": 2.6845639,
            "query_count_evol": "NEW",
            "click_count_evol": "NEW",
            "wishlist_count_evol": "NEW",
            "add2cart_count_evol": "NEW",
            "conversion_count_evol": "NEW"
        },
        {
            "query_count": 16,
            "click_count": 1,
            "wishlist_count": 0,
            "add2cart_count": 0,
            "conversion_count": 0,
            "success_count": 0,
            "click_count_pct": 6.25,
            "wishlist_count_pct": 0,
            "add2cart_count_pct": 0,
            "conversion_count_pct": 0,
            "success_count_pct": 0,
            "keyword": "sudadera",
            "query_count_pct": 2.6845639,
            "query_count_evol": "NEW",
            "click_count_evol": "NEW",
            "wishlist_count_evol": "NEW",
            "add2cart_count_evol": "NEW",
            "conversion_count_evol": "NEW"
        },
        {
            "query_count": 16,
            "click_count": 1,
            "wishlist_count": 0,
            "add2cart_count": 0,
            "conversion_count": 0,
            "success_count": 0,
            "click_count_pct": 6.25,
            "wishlist_count_pct": 0,
            "add2cart_count_pct": 0,
            "conversion_count_pct": 0,
            "success_count_pct": 0,
            "keyword": "basico",
            "query_count_pct": 2.6845639,
            "query_count_evol": "NEW",
            "click_count_evol": "NEW",
            "wishlist_count_evol": "NEW",
            "add2cart_count_evol": "NEW",
            "conversion_count_evol": "NEW"
        },
        {
            "query_count": 11,
            "click_count": 1,
            "wishlist_count": 0,
            "add2cart_count": 0,
            "conversion_count": 0,
            "success_count": 0,
            "click_count_pct": 9.090909,
            "wishlist_count_pct": 0,
            "add2cart_count_pct": 0,
            "conversion_count_pct": 0,
            "success_count_pct": 0,
            "keyword": "jegging",
            "query_count_pct": 1.8456376,
            "query_count_evol": "NEW",
            "click_count_evol": "NEW",
            "wishlist_count_evol": "NEW",
            "add2cart_count_evol": "NEW",
            "conversion_count_evol": "NEW"
        },
        {
            "query_count": 11,
            "click_count": 4,
            "wishlist_count": 0,
            "add2cart_count": 0,
            "conversion_count": 0,
            "success_count": 0,
            "click_count_pct": 36.363636,
            "wishlist_count_pct": 0,
            "add2cart_count_pct": 0,
            "conversion_count_pct": 0,
            "success_count_pct": 0,
            "keyword": "jeans",
            "query_count_pct": 1.8456376,
            "query_count_evol": "NEW",
            "click_count_evol": "NEW",
            "wishlist_count_evol": "NEW",
            "add2cart_count_evol": "NEW",
            "conversion_count_evol": "NEW"
        }
    ],
    "params": {
        "site_id": "sample",
        "start_date": 1506816000000,
        "end_date": 1513468800000,
        "filters": [],
        "offset": 0,
        "rows": 10,
        "evol": false
    }
}