{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/items","auth":"required","method":"post","examples":{"codes":[]},"settings":"587e7c7358666c2700965d5b","results":{"codes":[{"status":200,"language":"json","code":"{\n  \"message\" : \"Aggregation successful\",\n  \"impression_stats\": [...],\n  \"click_stats\": [...],\n  \"pageview_stats\": [...]\n}","name":""},{"status":400,"language":"json","code":"{\n  \"message\" : \"Can't parse the date. Make sure that start date and end date follows ISO8601 (https://en.wikipedia.org/wiki/ISO_8601)\"\n}","name":""},{"status":500,"language":"json","code":"{\n  \"message\" : \"ERROR: Aggregation failed. Analytics backend might be temporaily unavailable.\",\n  \"impression_stats\" = {},\n  \"click_stats\" = {},\n\t\"pageview_stats\" = {}\n}"},{"status":401,"language":"json","code":"{\n  \"message\" : \"Invalid API Key\"\n}"}]},"params":[{"name":"apiKey","type":"string","default":"","desc":"Your LiftIgniter API Key","required":true,"in":"body","ref":"","_id":"587e8325db3b0319007af1e3"},{"name":"startDate","type":"string","default":"","desc":"Start of time range for query in ISO8601 format","required":true,"in":"body","ref":"","_id":"587e8325db3b0319007af1e2"},{"name":"endDate","type":"string","default":"","desc":"End of time range for query in ISO8601 format","required":true,"in":"body","ref":"","_id":"587e8325db3b0319007af1e1"},{"name":"ids","type":"array_string","default":"","desc":"IDs of the items you want to query stats for. This usually means the URLs of your page.","required":true,"in":"body","ref":"","_id":"587e838edb3b0319007af1e6"},{"name":"dimensions","type":"array_string","default":"['type','widgetName','hostName','country','state','city']","desc":"Values you want to slice (groupby) on","required":false,"in":"body","ref":"","_id":"587e8325db3b0319007af1e0"},{"name":"granularity","type":"string","default":"\"day\"","desc":"Time granularity of the query. `all` to aggregate from start to end date, supports `hour`, `month`, and `year`.","required":false,"in":"body","ref":"","_id":"587e8325db3b0319007af1df"}]},"next":{"description":"","pages":[]},"title":"/items","type":"endpoint","slug":"items","excerpt":"","body":"[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Data lifetime\",\n  \"body\": \"LiftIgniter makes recent 4 weeks of data available for realtime aggregation. If you want the result to last then either schedule a query using /queries endpoint or independently store the results.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Query time\",\n  \"body\": \"If the data isn't cached on our server, then a query can take up to 10-20 seconds.\"\n}\n[/block]","updates":[],"order":999,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5b6b4e99c523fd000322051b","project":"5668fab608f90021008e882f","version":{"version":"1.18","version_clean":"1.18.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5668fab708f90021008e8833","569740f124490c3700170a64","569742b58560a60d00e2c25d","569742bd0b09a41900b2446c","569742cd69393517000c82b3","569742f459a6692d003fad8f","569743020b09a41900b2446d","5697430b69393517000c82b5","56a17776470ae00d00c30642","56a2c48a831e2a0d0069b1ad","56b535757bccae0d00e9a1cd","56e1ff6aa49fdc0e005746b5","57e1c88115bf6522002a5e4e","57fa65275ba65a17008b988f","57fbeea34002550e004c032e","58474584889b6c2d00fb86e9","58475dcc64157f0f002f1907","587e7b5158666c2700965d4e","58a349fc30852819007ba083"],"_id":"5668fab608f90021008e8832","__v":19,"releaseDate":"2015-12-10T04:08:22.769Z","createdAt":"2015-12-10T04:08:22.769Z","project":"5668fab608f90021008e882f"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Analytics API","slug":"analytics-api","order":3,"from_sync":false,"reference":false,"_id":"587e7b5158666c2700965d4e","createdAt":"2017-01-17T20:15:13.711Z","project":"5668fab608f90021008e882f","__v":0,"version":"5668fab608f90021008e8832"},"user":"5668fa9755e4b32100935d41","createdAt":"2018-08-08T20:12:09.341Z","__v":0}

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

apiKey:
required
string
Your LiftIgniter API Key
startDate:
required
string
Start of time range for query in ISO8601 format
endDate:
required
string
End of time range for query in ISO8601 format
ids:
required
array of strings
IDs of the items you want to query stats for. This usually means the URLs of your page.
dimensions:
array of strings['type','widgetName','hostName','country','state','city']
Values you want to slice (groupby) on
granularity:
string"day"
Time granularity of the query. `all` to aggregate from start to end date, supports `hour`, `month`, and `year`.

Result Format


Documentation

[block:callout] { "type": "warning", "title": "Data lifetime", "body": "LiftIgniter makes recent 4 weeks of data available for realtime aggregation. If you want the result to last then either schedule a query using /queries endpoint or independently store the results." } [/block] [block:callout] { "type": "warning", "title": "Query time", "body": "If the data isn't cached on our server, then a query can take up to 10-20 seconds." } [/block]

User Information

Try It Out

post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}