Stat API: Difference between revisions
No edit summary |
No edit summary |
||
Line 900: | Line 900: | ||
<!--T:27--> | <!--T:27--> | ||
''' | See bellow allowed values in '''<groups>''' | ||
<!--T:28--> | <!--T:28--> | ||
|- | |- | ||
|metrics | |metrics | ||
Line 944: | Line 943: | ||
|See bellow description '''<compare>''' | |See bellow description '''<compare>''' | ||
|} | |} | ||
{| class="wikitable" | |||
|+Description <groups> | |||
!API name | |||
!Name in UI | |||
!Comment | |||
|- | |||
|time_hour | |||
|Hour | |||
| | |||
|- | |||
|time_day | |||
|Day | |||
| | |||
|- | |||
|time_week | |||
|Week | |||
| | |||
|- | |||
|time_month | |||
|Month | |||
| | |||
|- | |||
|time_dateTime | |||
|Date time | |||
| | |||
|- | |||
|sub_integration | |||
|Integration | |||
| | |||
|- | |||
|sub_botType | |||
|Bot or fraud type | |||
| | |||
|- | |||
|sub_referer | |||
|Referer | |||
| | |||
|- | |||
|sub_1 | |||
|Sub1 | |||
| | |||
|- | |||
|sub_2 | |||
|Sub2 | |||
| | |||
|- | |||
|sub_3 | |||
|Sub3 | |||
| | |||
|- | |||
|sub_4 | |||
|Sub4 | |||
| | |||
|- | |||
|sub_5 | |||
|Sub5 | |||
| | |||
|- | |||
|sub_6 | |||
|Sub6 | |||
| | |||
|- | |||
|sub_7 | |||
|Sub7 | |||
| | |||
|- | |||
|sub_8 | |||
|Sub8 | |||
|This group is available only if feature [[Additional_subs|Additional subs]] is on | |||
|- | |||
|sub_9 | |||
|Sub9 | |||
|This group is available only if feature [[Additional_subs|Additional subs]] is on | |||
|- | |||
|sub_10 | |||
|Sub10 | |||
|This group is available only if feature [[Additional_subs|Additional subs]] is on | |||
|- | |||
|sub_conversionType | |||
|Conversion status | |||
|This group is available only if feature [[Conversions|Conversions]] is on | |||
|- | |||
|sub_cnvId | |||
|Conversion ID | |||
|This group is available only if feature [[Conversions|Conversions]] is on | |||
|- | |||
|geo_language | |||
|Browsers language | |||
| | |||
|- | |||
|geo_timezonename | |||
|Browsers time zone | |||
| | |||
|- | |||
|geo_country | |||
|Country from IP | |||
| | |||
|- | |||
|geo_city | |||
|City from IP | |||
| | |||
|- | |||
|geo_timezone | |||
|Time zone from IP | |||
| | |||
|- | |||
|geo_provider | |||
|Provider from IP | |||
| | |||
|- | |||
|geo_ip | |||
|Truncated IP | |||
|We store IP without the last octet | |||
|- | |||
|device_browserEngine | |||
|Real browser engine | |||
| | |||
|- | |||
|device_realOs | |||
|Real OS | |||
| | |||
|- | |||
|device_connectionType | |||
|Connection type | |||
| | |||
|- | |||
|device_browser | |||
|Browser from UA | |||
| | |||
|- | |||
|device_os | |||
|OS from UA | |||
| | |||
|- | |||
|device_device | |||
|Device from UA | |||
| | |||
|- | |||
|device_type | |||
|Device type from UA | |||
| | |||
|- | |||
|device_useragent | |||
|User agent | |||
| | |||
|- | |||
|screen_width | |||
|Screen width | |||
| | |||
|- | |||
|screen_height | |||
|Screen height | |||
| | |||
|- | |||
|screen_orientation | |||
|Ccreen orientation | |||
| | |||
|- | |||
|screen_pixelDensity | |||
|Pixel density | |||
| | |||
|} | |||
{| class="wikitable mw-collapsible" | {| class="wikitable mw-collapsible" | ||
|+Description <filters> | |+Description <filters> |
Revision as of 22:30, 28 March 2025
Detailed description of the requests and responses for each endpoint.
Endpoint list:
Method | Path | Description |
---|---|---|
OPTIONS | /api/stat/get | Returns all possible groupings and metrics grouped by categories |
POST | /api/stat/filter | Obtaining data for filter |
POST | /api/stat/data | Obtaining data for the table |
How to get all possible groupings and metrics
To obtain all possible groupings and metrics grouped by categories use this URL:
Method | Path |
---|---|
OPTIONS | /api/stat/get |
If you want to better understand what our metrics mean, visit page Metrics and groups.
Request
No parameters
Response
Response example
{ "success":true, "code":200, "msg":[], "data":{ "groups":{ "time":[ { "id":"time_hour", "icon":"date", "filterType":"range" }, { "id":"time_day", "icon":"date", "filterType":"range" }, { "id":"time_week", "icon":"date", "filterType":"range" }, { "id":"time_month", "icon":"date", "filterType":"range" }, { "id":"time_dateTime", "icon":"date", "filterType":"list", "filterSync":true } ], "sub":[ { "id":"sub_integration", "icon":"text", "filterType":"list", "filterSync":false }, { "id":"sub_botType", "icon":"text", "filterType":"list", "filterSync":false }, { "id":"sub_cnvId", "icon":"text", "filterType":"list", "filterSync":true }, { "id":"sub_clickId", "icon":"number", "filterType":"list", "filterSync":true }, { "id":"sub_referer", "icon":"text", "filterType":"list", "filterSync":true, "tooltip":true }, { "id":"sub_1", "icon":"text", "filterType":"list", "filterSync":true }, { "id":"sub_2", "icon":"text", "filterType":"list", "filterSync":true }, { "id":"sub_3", "icon":"text", "filterType":"list", "filterSync":true }, { "id":"sub_4", "icon":"text", "filterType":"list", "filterSync":true }, { "id":"sub_5", "icon":"text", "filterType":"list", "filterSync":true }, { "id":"sub_6", "icon":"text", "filterType":"list", "filterSync":true }, { "id":"sub_7", "icon":"text", "filterType":"list", "filterSync":true } ], "geo":[ { "id":"geo_language", "icon":"text", "filterType":"list", "filterSync":true }, { "id":"geo_timezone", "icon":"text", "filterType":"list", "filterSync":false }, { "id":"geo_country", "icon":"text", "filterType":"list", "filterSync":false }, { "id":"geo_city", "icon":"text", "filterType":"list", "filterSync":true }, { "id":"geo_provider", "icon":"text", "filterType":"list", "filterSync":true }, { "id":"geo_ip", "icon":"text", "filterType":"list", "filterSync":true } ], "device":[ { "id":"device_browser", "icon":"text", "filterType":"list", "filterSync":true, "tooltip":true }, { "id":"device_browserEngine", "icon":"text", "filterType":"list", "filterSync":true, "tooltip":true }, { "id":"device_os", "icon":"text", "filterType":"list", "filterSync":true, "tooltip":true }, { "id":"device_realOs", "icon":"text", "filterType":"list", "filterSync":false, "tooltip":true }, { "id":"device_device", "icon":"text", "filterType":"list", "filterSync":true, "tooltip":true }, { "id":"device_type", "icon":"text", "filterType":"list", "filterSync":false, "tooltip":true }, { "id":"device_connectionType", "icon":"text", "filterType":"list", "filterSync":false }, { "id":"device_useragent", "icon":"text", "filterType":"list", "filterSync":true } ], "screen":[ { "id":"screen_width", "icon":"number", "filterType":"range", "tooltip":true }, { "id":"screen_height", "icon":"number", "filterType":"range", "tooltip":true }, { "id":"screen_orientation", "icon":"text", "filterType":"list", "filterSync":false }, { "id":"screen_pixelDensity", "icon":"number", "filterType":"list", "filterSync":true, "tooltip":true } ] }, "metrics":{ "summary":[ { "id":"summary_totalVisits", "icon":"number", "filterType":"range" }, { "id":"summary_validVisits", "icon":"number", "filterType":"range", "filterSync":false, "tooltip":true }, { "id":"summary_validVisitsPc", "icon":"number", "filterType":"range", "filterSync":false }, { "id":"summary_techLosses", "icon":"number", "filterType":"range", "filterSync":false, "tooltip":true }, { "id":"summary_techLossesPc", "icon":"number", "filterType":"range", "filterSync":false }, { "id":"summary_uniqUsers", "icon":"number", "filterType":"range", "tooltip":true }, { "id":"summary_uniqUsersPc", "icon":"number", "filterType":"range" }, { "id":"summary_conversions", "icon":"number", "filterType":"binary", "filterSync":false, "tooltip":true }, { "id":"summary_conversionsPc", "icon":"number", "filterType":"range", "filterSync":false } ], "bots":[ { "id":"bots_total", "icon":"number", "filterType":"range", "filterSync":false, "tooltip":true }, { "id":"bots_totalPc", "icon":"number", "filterType":"range", "filterSync":false }, { "id":"bots_crawler", "icon":"number", "filterType":"binary", "filterSync":false, "tooltip":true }, { "id":"bots_crawlerPc", "icon":"number", "filterType":"range", "filterSync":false }, { "id":"bots_spoofing", "icon":"number", "filterType":"binary", "filterSync":false, "tooltip":true }, { "id":"bots_spoofingPc", "icon":"number", "filterType":"range", "filterSync":false }, { "id":"bots_automated", "icon":"number", "filterType":"binary", "filterSync":false, "tooltip":true }, { "id":"bots_automatedPc", "icon":"number", "filterType":"range", "filterSync":false }, { "id":"bots_iFrame", "icon":"number", "filterType":"binary", "filterSync":false, "tooltip":true }, { "id":"bots_iFramePc", "icon":"number", "filterType":"range", "filterSync":false }, { "id":"bots_badReputationIp", "icon":"number", "filterType":"binary", "filterSync":false, "tooltip":true }, { "id":"bots_badReputationIpPc", "icon":"number", "filterType":"range", "filterSync":false }, { "id":"bots_blocked", "icon":"number", "filterType":"binary", "filterSync":false, "tooltip":true }, { "id":"bots_blockedPc", "icon":"number", "filterType":"range", "filterSync":false } ], "lowQuality":[ { "id":"lowQuality_total", "icon":"number", "filterType":"binary", "filterSync":false, "tooltip":true }, { "id":"lowQuality_totalPc", "icon":"number", "filterType":"range", "filterSync":false }, { "id":"lowQuality_proxy", "icon":"number", "filterType":"binary", "filterSync":false, "tooltip":true }, { "id":"lowQuality_proxyPc", "icon":"number", "filterType":"range", "filterSync":false }, { "id":"lowQuality_spoofing", "icon":"number", "filterType":"binary", "filterSync":false, "tooltip":true }, { "id":"lowQuality_spoofingPc", "icon":"number", "filterType":"range", "filterSync":false }, { "id":"lowQuality_automated", "icon":"number", "filterType":"binary", "filterSync":false, "tooltip":true }, { "id":"lowQuality_automatedPc", "icon":"number", "filterType":"range", "filterSync":false }, { "id":"lowQuality_trafficCheats", "icon":"number", "filterType":"binary", "filterSync":false, "tooltip":true }, { "id":"lowQuality_trafficCheatsPc", "icon":"number", "filterType":"range", "filterSync":false } ], "feature":[ { "id":"feature_adBlock", "icon":"number", "filterType":"list", "filterSync":false, "tooltip":true }, { "id":"feature_adBlockPc", "icon":"number", "filterType":"range" }, { "id":"feature_isMobile", "icon":"number", "filterType":"binary", "tooltip":true }, { "id":"feature_isMobilePc", "icon":"number", "filterType":"range" }, { "id":"feature_webView", "icon":"number", "filterType":"binary", "tooltip":true }, { "id":"feature_webViewPc", "icon":"number", "filterType":"range" }, { "id":"feature_iFrame", "icon":"number", "filterType":"binary", "filterSync":false, "tooltip":true }, { "id":"feature_iFramePc", "icon":"number", "filterType":"range", "filterSync":false }, { "id":"feature_pushNotifications", "icon":"number", "filterType":"binary", "filterSync":false, "tooltip":true }, { "id":"feature_pushNotificationsPc", "icon":"number", "filterType":"range", "filterSync":false } ], "beAn":[ { "id":"beAn_pageVisibility", "icon":"number", "filterType":"list", "filterSync":false, "tooltip":true, "disabled":false }, { "id":"beAn_pageVisibilityPc", "icon":"number", "filterType":"range", "filterSync":false, "disabled":false }, { "id":"beAn_pageActivity", "icon":"number", "filterType":"list", "filterSync":false, "tooltip":true, "disabled":false }, { "id":"beAn_pageActivityPc", "icon":"number", "filterType":"range", "filterSync":false, "disabled":false }, { "id":"beAn_pageAcceptance", "icon":"number", "filterType":"list", "filterSync":false, "tooltip":true, "disabled":false }, { "id":"beAn_pageAcceptancePc", "icon":"number", "filterType":"range", "filterSync":false, "disabled":false } ] } } }
API
Key | Type | Description |
---|---|---|
success | Boolean | Was the request successful or it failed |
code | Number | Response status code |
msg | [String] | Error message |
data | ||
data.groups | { groupTitle: [<item>, …] } | See bellow description <item> |
data.metrics | { metricTitle: [<item>, …] } | See bellow description <item> |
Key | Type | Description |
---|---|---|
id | String | <groupTitle or metricTitle>
+ underscore + <metric or group's name> (groupTitle_id, for example: lowQuality_total, feature_adBlock) |
icon | date | text | number
|
Type of content served |
filterType | range | list | binary
|
See bellow description <filters> |
filterSync | Boolean * | list with server-side search
|
How to get all possible values for filter
To obtain values use this URL:
Method | Path |
---|---|
POST | /api/stat/filter |
Request
Request example
{ "id":"geo_language", "searchQuery":"en", "dateFrom":"2024-04-10", "dateTo":"2024-04-10" }
API
Key | Type | Description |
---|---|---|
id | String | Filter name |
searchQuery | String | Search query |
dateFrom | String | What date should we start searching? Date in the format Y-m-d. |
dateTo | String | Until what date should we continue searching?? Date in the format Y-m-d. |
Response
Response example
{ "success":true, "code":200, "msg":[], "data":{ "items":[ { "id":"bd", "label":"Bengali" }, { "id":"bez", "label":"Bena (Tanzania)" }, { "id":"bn", "label":"Bengali" }, { "id":"ce", "label":"Chechen" }, { "id":"ckb", "label":"Central Kurdish" }, { "id":"en", "label":"English" }, { "id":"fr", "label":"French" }, { "id":"hy", "label":"Armenian" }, { "id":"kam", "label":"Kamba (Kenya)" }, { "id":"kln", "label":"Kalenjin" }, { "id":"km", "label":"Central Khmer" }, { "id":"luo", "label":"Luo (Kenya and Tanzania)" }, { "id":"mfe", "label":"Morisyen" }, { "id":"seh", "label":"Sena" }, { "id":"ses", "label":"Koyraboro Senni Songhai" }, { "id":"sl", "label":"Slovenian" }, { "id":"tk", "label":"Turkmen" }, { "id":"tzm", "label":"Central Atlas Tamazight" }, { "id":"ve", "label":"Venda" }, { "id":"vec", "label":"Venetian" }, { "id":"yav", "label":"Yangben" }, { "id":"yrl", "label":"Nhengatu" } ] } }
API
Key | Type | Description |
---|---|---|
success | Boolean | Was the request successful or it failed |
code | Number | Response status code |
msg | [String] | Error message |
data | ||
data.items | [{ id: Number, label: String }] | { id: 1, label: "Param A" } |
How to get full statistic data
To obtain such data use this URL:
Method | Path |
---|---|
POST | /api/stat/data |
Request
Request example
{ "id":null, "name":null, "perPage":50, "groups":[ "time_day", "geo_country" ], "metrics":[ "summary_totalVisits", "bots_total", "bots_totalPc" ], "filters":{ "filters":[ { "id":"geo_language", "type":"list", "include":["sl", "hr", "sh", "bs", "sr"], "exclude":[] } ], "period":"today", "timezone":-3 }, "compare":null }
API
Key | Type | Description |
---|---|---|
id | String | Optional parameter |
name | String | Optional parameter |
perPage | Number | Number of lines shown simultaneously. Default value is 50. |
page | Number | Current page number. Default value is 1. |
groups | [String] | Groups you would like to see in statistics.
See bellow allowed values in <groups> |
metrics | [String] | Metrics you would like to see in statistics.
Allowed values: summary_totalVisits, summary_uniqUsers, summary_uniqUsersPc, summary_validVisits, summary_validVisitsPc, summary_techLosses, summary_techLossesPc, bots_total, bots_totalPc, bots_crawler, bots_crawlerPc, bots_spoofing, bots_spoofingPc, bots_automated, bots_automatedPc, bots_iFrame, bots_iFramePc, bots_badReputationIp, bots_badReputationIpPc, bots_blocked, bots_blockedPc, lowQuality_total, lowQuality_totalPc, lowQuality_proxy, lowQuality_proxyPc, lowQuality_spoofing, lowQuality_spoofingPc, lowQuality_automated, lowQuality_automatedPc, lowQuality_trafficCheats, lowQuality_trafficCheatsPc, feature_adBlock, feature_adBlockPc, feature_isMobile, feature_isMobilePc, feature_webView, feature_webViewPc, feature_iFrame, feature_iFramePc, feature_pushNotifications, feature_pushNotificationsPc. Those values are allowed only if option Behavioral analysis is turned on for you integration: beAn_pageVisibility, beAn_pageVisibilityPc, beAn_pageActivity, beAn_pageActivityPc, beAn_pageAcceptance, beAn_pageAcceptancePc Metrics whose ID ends with Pc (for example, lowQuality_totalPc) return percentage values. Full list of metrics you can get with this URL. |
filters | ||
filters.dateFrom | String | Date in the format Y-m-d. If you specify a period, dateFrom will not work. The period has high priority. |
filters.dateTo | String | Date in the format Y-m-d. If you specify a period, dateTo will not work. The period has high priority. |
filters.period | today | yesterday | currentWeek | 7days| month | null | If you specify a period, dateFrom and dateTo will not work. The period has high priority |
filters.timezone | Number | From -12 to +12. Default value is 0, which means that the data will be output in UTC. |
filters.filters | [<filters>] | See bellow description <filters> |
compare | <compare> | See bellow description <compare> |
API name | Name in UI | Comment |
---|---|---|
time_hour | Hour | |
time_day | Day | |
time_week | Week | |
time_month | Month | |
time_dateTime | Date time | |
sub_integration | Integration | |
sub_botType | Bot or fraud type | |
sub_referer | Referer | |
sub_1 | Sub1 | |
sub_2 | Sub2 | |
sub_3 | Sub3 | |
sub_4 | Sub4 | |
sub_5 | Sub5 | |
sub_6 | Sub6 | |
sub_7 | Sub7 | |
sub_8 | Sub8 | This group is available only if feature Additional subs is on |
sub_9 | Sub9 | This group is available only if feature Additional subs is on |
sub_10 | Sub10 | This group is available only if feature Additional subs is on |
sub_conversionType | Conversion status | This group is available only if feature Conversions is on |
sub_cnvId | Conversion ID | This group is available only if feature Conversions is on |
geo_language | Browsers language | |
geo_timezonename | Browsers time zone | |
geo_country | Country from IP | |
geo_city | City from IP | |
geo_timezone | Time zone from IP | |
geo_provider | Provider from IP | |
geo_ip | Truncated IP | We store IP without the last octet |
device_browserEngine | Real browser engine | |
device_realOs | Real OS | |
device_connectionType | Connection type | |
device_browser | Browser from UA | |
device_os | OS from UA | |
device_device | Device from UA | |
device_type | Device type from UA | |
device_useragent | User agent | |
screen_width | Screen width | |
screen_height | Screen height | |
screen_orientation | Ccreen orientation | |
screen_pixelDensity | Pixel density |
Key | Type | Description |
---|---|---|
id | String | Column by which you would like to filter.
Allowed values: time_hour, time_day, time_week, time_month, sub_integration, sub_botType, sub_referer, sub_1, sub_2, sib_3, sub_4, sub_5, sub_6, sub_7, geo_language, geo_timezone, geo_country, geo_city, geo_provider, device_browser, device_browserEngine, device_os, device_realOs, device_device, device_type, device_connectionType, device_useragent, screen_width, screen_height, screen_orientation, screen_pixelDensity, summary_totalVisits, summary_uniqUsers, summary_uniqUsersPc, summary_validVisits, summary_validVisitsPc, summary_techLosses, summary_techLossesPc, bots_total, bots_totalPc, bots_crawler, bots_crawlerPc, bots_spoofing, bots_spoofingPc, bots_automated, bots_automatedPc, bots_iFrame, bots_iFramePc, bots_badReputationIp, bots_badReputationIpPc, bots_blocked, bots_blockedPc, lowQuality_total, lowQuality_totalPc, lowQuality_proxy, lowQuality_proxyPc, lowQuality_spoofing, lowQuality_spoofingPc, lowQuality_automated, lowQuality_automatedPc, lowQuality_trafficCheats, lowQuality_trafficCheatsPc, feature_adBlock, feature_adBlockPc, feature_isMobile, feature_isMobilePc, feature_webView, feature_webViewPc, feature_iFrame, feature_iFramePc, feature_pushNotifications, feature_pushNotificationsPc. Those values are allowed only if option Behavioral analysis is turned on for you integration: beAn_pageVisibility, beAn_pageVisibilityPc, beAn_pageActivity, beAn_pageActivityPc, beAn_pageAcceptance, beAn_pageAcceptancePc Filters whose ID ends with Pc (for example, lowQuality_totalPc) return percentage values. Full list of metrics you can get with this URL. |
type | range | list | binary
|
|
range | {from: Number, to: Number} | For filters with type range
|
include | [Any] | For filters with type list and binary . Show only records with included values.
|
exclude | [Any] | For filters with type list and binary . Show only records without included values.
|
Filters examples
Type list
, include in on. Search the visits only from Cambodia ("KH") or China ("CN").
{ ... "filters":{ "filters":[ { "id":"geo_country", "type":"list", "include":["KH","CN"], "exclude":[] } ], "period":"today", "timezone":-3 } }
Type list
, exclude in on. Search the visits from any country except Cambodia ("KH") andr China ("CN").
{ ... "filters":{ "filters":[ { "id":"geo_country", "type":"list", "include":[], "exclude":["KH","CN"] } ], "period":"today", "timezone":-3 } }
Type binary
, include is on. Search for visits made only by crawlers (i.e. search engine and social network bots).
{ ... "filters":{ "filters":[ { "id":"bots_crawler", "type":"binary", "include":[1], "exclude":[] } ], "period":"today", "timezone":-3 } }
Type binary
, exclude is on. Do not show visits made by crawlers.
{ ... "filters":{ "filters":[ { "id":"bots_crawler", "type":"binary", "include":[], "exclude":[1] } ], "period":"today", "timezone":-3 } }
Type range
. Search for slices, where total amount of bot visits is between 1 000 and 10 000 hits.
{ ... "filters":{ "filters":[ { "id":"bots_total", "type":"range", "range":{ "from":1000, "to":10000 } } ], "period":"today", "timezone":-3 } }
Type range
. Search for slices, where more than 50% of visits made from mobile devices.
{ ... "filters":{ "filters":[ { "id":"feature_isMobilePc", "type":"range", "range":{ "from":50, "to":null } } ], "period":"today", "timezone":-3 } }
Type range
. Search for visits made before 10 a.m. UTC-3.
{ ... "filters":{ "filters":[ { "id":"time_hour", "type":"range", "range":{ "from":null, "to":10 } } ], "period":"today", "timezone":-3 } }
Key | Type | Description |
---|---|---|
dateFrom | String | Date in the format Y-m-d |
dateTo | String | Date in the format Y-m-d |
mode | compare_value | diff | percent | |
sort | Boolean |
Response
Response example
{ "success":true, "code":200, "msg":[], "data":{ "rows":[ { "id":0, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"AE", "value":"United Arab Emirates ", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"1", "value":"1", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":1, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"AT", "value":"Austria", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"27", "value":"27", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":2, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"BA", "value":"Bosnia and Herzegovina", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"349", "value":"349", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"3", "value":"3", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0.86, "value":"0.86", "diff":null, "percent":null, "compare_value":null } }, { "id":3, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"BD", "value":"Bangladesh", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"1", "value":"1", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":4, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"BG", "value":"Bulgaria", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"3", "value":"3", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":5, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"BR", "value":"Brazil", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"1", "value":"1", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":6, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"CA", "value":"Canada", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"1", "value":"1", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":7, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"CH", "value":"Switzerland", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"4", "value":"4", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":8, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"DE", "value":"Germany", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"110", "value":"110", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":9, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"HR", "value":"Croatia", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"274", "value":"274", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"4", "value":"4", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":1.46, "value":"1.46", "diff":null, "percent":null, "compare_value":null } }, { "id":10, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"HU", "value":"Hungary", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"1", "value":"1", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":11, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"IN", "value":"India", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"2", "value":"2", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":12, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"IR", "value":"Iran", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"1", "value":"1", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":13, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"IT", "value":"Italy", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"2", "value":"2", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":14, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"LB", "value":"Lebanon", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"2", "value":"2", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":15, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"LU", "value":"Luxembourg", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"1", "value":"1", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":16, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"MA", "value":"Morocco", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"1", "value":"1", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":17, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"ME", "value":"Montenegro", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"42", "value":"42", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":18, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"MK", "value":"Republic of North Macedonia", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"21", "value":"21", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":19, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"MT", "value":"Malta", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"1", "value":"1", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":20, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"NO", "value":"Norway", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"1", "value":"1", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":21, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"PL", "value":"Poland", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"8", "value":"8", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":22, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"QA", "value":"Qatar", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"2", "value":"2", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":23, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"RO", "value":"Romania", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"2", "value":"2", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":24, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"RS", "value":"Serbia", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"676", "value":"676", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"3", "value":"3", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0.44, "value":"0.44", "diff":null, "percent":null, "compare_value":null } }, { "id":25, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"RU", "value":"Russian Federation ", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"3", "value":"3", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":26, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"SE", "value":"Sweden", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"1", "value":"1", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":27, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"SI", "value":"Slovenia", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"199", "value":"199", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"10", "value":"10", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":5.03, "value":"5.03", "diff":null, "percent":null, "compare_value":null } }, { "id":28, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"SK", "value":"Slovakia", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"1", "value":"1", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":29, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"SO", "value":"Somalia", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"1", "value":"1", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":30, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"TR", "value":"Turkey", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"1", "value":"1", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } }, { "id":31, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"US", "value":"United States of America ", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"20", "value":"20", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"18", "value":"18", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":90, "value":"90", "diff":null, "percent":null, "compare_value":null } }, { "id":32, "time_day":{ "rawValue":"10.04.2024", "value":"10.04.2024", "diff":null, "percent":null, "compare_value":null }, "geo_country":{ "rawValue":"XK", "value":"Kosovo", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":"3", "value":"3", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":"0", "value":"0", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":0, "value":"0", "diff":null, "percent":null, "compare_value":null } } ], "totalRows":33, "page":1, "perPage":50, "columns":[ { "field":"time_day", "type":"string", "sortable":true, "unit":null, "tooltip":false }, { "field":"geo_country", "type":"string", "sortable":true, "unit":null, "tooltip":false }, { "field":"summary_totalVisits", "type":"number", "sortable":true, "unit":null, "tooltip":false }, { "field":"bots_total", "type":"number", "sortable":true, "unit":null, "tooltip":true }, { "field":"bots_totalPc", "type":"float", "sortable":true, "unit":"%", "tooltip":false } ], "total":{ "id":33, "time_day":"fullResult", "geo_country":{ "rawValue":null, "value":"", "diff":null, "percent":null, "compare_value":null }, "summary_totalVisits":{ "rawValue":null, "value":"1763", "diff":null, "percent":null, "compare_value":null }, "bots_total":{ "rawValue":null, "value":"38", "diff":null, "percent":null, "compare_value":null }, "bots_totalPc":{ "rawValue":null, "value":"2.16", "diff":null, "percent":null, "compare_value":null } } } }
API
Key | Type | Description |
---|---|---|
success | Boolean | Was the request successful or it failed |
code | Number | Response status code |
msg | [String] | Error message |
data | ||
data.rows | [<row>] | Description of table rows |
data.totalRows | Number | Total number of items in the table |
data.total | <row> | Sum for each column considering invisible rows |
data.page | Number | Current page |
data.perPage | Number | Number of items per page |
data.columns | [<column>] | Description of columns |
Key | Type | Description |
---|---|---|
value | String | Human readable value |
rawValue | String | Raw value |
diff | String | null | |
percent | Number | null | Is the value a percentage or not? |
compare_value | String | null | Comparison value if compare is on in request |
Key | Type | Description |
---|---|---|
field | String | ID of the metric or group |
type | String | Number | Float | |
sortable | Boolean | Sortable or not |
unit | String | null | Unit of measurement
For example, % for percentage columns |
Request examples
CURL
curl -X 'OPTIONS' \ 'https://kaminari.click/api/stat/get' \ -H 'accept: */*' 'Authorization: Bearer <YOUR API_TOKEN>'
curl -X POST 'https://kaminari.click/api/stat/filter' -d '{"id":"device_type","searchQuery":"","dateFrom":"2023-01-05","dateTo":"2023-01-05"}' -H 'content-type: application/json' -H 'Authorization: Bearer <YOUR API_TOKEN>'
curl -X POST 'https://kaminari.click/api/stat/data' -d '{"id":null,"name":null,"groups":["time_day"],"metrics":["summary_totalVisits"],"filters":{"filters":[],"period":null,"timezone":0,"dateTo":"2022-08-15","dateFrom":"2022-08-15"},"compare":null}' -H 'content-type: application/json' -H 'Authorization: Bearer <YOUR API_TOKEN>'
NodeJS
const https = require('https'); const options = { host: 'kaminari.click', port: 443, path: '/api/stat/get', method: 'POST', headers: { 'Authorization': 'Bearer <YOUR API_TOKEN>' } }; https .get(options, (resp) => { let data = ''; resp.on('data', (chunk) => { data += chunk; }); resp.on('end', () => { try { data = JSON.parse(data); } catch { console.log(data); } }); }) .on("error", (err) => { console.log("Error: " + err.message); });
PHP
<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, 'https://kaminari.click/api/stat/get'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'OPTIONS'); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'accept: */*', ]); $response = curl_exec($ch); curl_close($ch);
Python
import requests headers = { 'accept': '*/*', } response = requests.options('https://kaminari.click/api/stat/get', headers=headers) response = requests.options('http://Authorization: Bearer <YOUR API_TOKEN>', headers=headers)