Workspace Statistics
curl --request GET \
--url https://api.taap.it/v1/stats/workspaces \
--header 'Authorization: <authorization>'import requests
url = "https://api.taap.it/v1/stats/workspaces"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.taap.it/v1/stats/workspaces', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.taap.it/v1/stats/workspaces",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.taap.it/v1/stats/workspaces"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.taap.it/v1/stats/workspaces")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.taap.it/v1/stats/workspaces")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"id": "<string>",
"last_updated": "<string>",
"click_date": "<string>",
"total_clicks": 123,
"unique_visitors": 123,
"scans_only": 123,
"clicks_only": 123,
"chrome_clicks": 123,
"ios_clicks": 123,
"android_clicks": 123,
"os_stats": {
"{os_name}": 123
},
"city_stats": {
"{city_name}": 123
},
"os_version_stats": {
"{version}": 123
},
"lang_stats": {
"lang_stats.{language_code}": 123
},
"device_stats": {
"mobile": 123,
"desktop": 123,
"tablet": 123
},
"browser_stats": {
"{browser_name}": 123
},
"country_stats": {
"{country_code}": 123
},
"device_and_os_stats": {
"{device_os}": 123
},
"app_stats": {
"{app_name}": 123
},
"device_type_stats": {
"{device_type}": 123
},
"from_app_stats": {
"true": 123,
"false": 123
},
"continent_stats": {
"{continent_name}": 123
}
}Stats API
Workspace Statistics
Retrieve detailed statistics for your workspace
GET
/
v1
/
stats
/
workspaces
Workspace Statistics
curl --request GET \
--url https://api.taap.it/v1/stats/workspaces \
--header 'Authorization: <authorization>'import requests
url = "https://api.taap.it/v1/stats/workspaces"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.taap.it/v1/stats/workspaces', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.taap.it/v1/stats/workspaces",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.taap.it/v1/stats/workspaces"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.taap.it/v1/stats/workspaces")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.taap.it/v1/stats/workspaces")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"id": "<string>",
"last_updated": "<string>",
"click_date": "<string>",
"total_clicks": 123,
"unique_visitors": 123,
"scans_only": 123,
"clicks_only": 123,
"chrome_clicks": 123,
"ios_clicks": 123,
"android_clicks": 123,
"os_stats": {
"{os_name}": 123
},
"city_stats": {
"{city_name}": 123
},
"os_version_stats": {
"{version}": 123
},
"lang_stats": {
"lang_stats.{language_code}": 123
},
"device_stats": {
"mobile": 123,
"desktop": 123,
"tablet": 123
},
"browser_stats": {
"{browser_name}": 123
},
"country_stats": {
"{country_code}": 123
},
"device_and_os_stats": {
"{device_os}": 123
},
"app_stats": {
"{app_name}": 123
},
"device_type_stats": {
"{device_type}": 123
},
"from_app_stats": {
"true": 123,
"false": 123
},
"continent_stats": {
"{continent_name}": 123
}
}Request:
Response:
cURL
curl -X GET 'https://api.taap.it/v1/stats/workspaces?start_date=2024-01-01T00:00:00Z&end_date=2024-01-31T23:59:59Z&max_days=30' \
-H 'Authorization: Bearer taapit_your_api_key_here'
[
{
"id": "ws_stat_123456789",
"last_updated": "2024-01-15T10:30:00Z",
"click_date": "2024-01-15",
"total_clicks": 1250,
"unique_visitors": 980,
"scans_only": 50,
"clicks_only": 1200,
"chrome_clicks": 800,
"ios_clicks": 400,
"android_clicks": 200,
"os_stats": {
"iOS": 400,
"Android": 200,
"Windows": 500,
"macOS": 150
},
"city_stats": {
"New York": 200,
"Los Angeles": 150,
"Toronto": 100,
"London": 80
},
"os_version_stats": {
"iOS 17.0": 300,
"iOS 16.5": 100,
"Android 13": 120,
"Android 12": 80
},
"lang_stats": {
"en": 900,
"fr": 150,
"es": 100,
"de": 50
},
"device_stats": {
"mobile": 750,
"desktop": 400,
"tablet": 100
},
"browser_stats": {
"Chrome": 800,
"Safari": 300,
"Firefox": 100,
"Edge": 50
},
"country_stats": {
"US": 650,
"CA": 280,
"UK": 180,
"DE": 80
},
"device_and_os_stats": {
"iPhone iOS": 400,
"Android Phone": 200,
"Windows Desktop": 500,
"Mac Desktop": 150
},
"app_stats": {
"Safari": 300,
"Chrome Mobile": 400,
"Chrome Desktop": 400
},
"device_type_stats": {
"smartphone": 600,
"desktop": 500,
"tablet": 150
},
"from_app_stats": {
"true": 300,
"false": 950
},
"continent_stats": {
"North America": 930,
"Europe": 200,
"Asia": 100,
"Oceania": 20
}
}
]
Authorization
string
required
Bearer token for API authentication. Format:
Bearer YOUR_API_KEYQuery Parameters
string
Start date for statistics (ISO 8601 format, e.g., 2024-01-01T00:00:00Z)
string
End date for statistics (ISO 8601 format, e.g., 2024-01-31T23:59:59Z)
integer
Maximum number of days to retrieve statistics for (minimum: 1, maximum: 30)
Response Fields
string
required
Unique identifier for the statistics record
string
required
ISO 8601 timestamp when the statistics were last updated
string
required
Date for the statistics (YYYY-MM-DD format)
integer
required
Total number of clicks across all workspace links on this date
integer
required
Number of unique visitors across all workspace links on this date
integer
required
Number of QR code scans without clicks across all workspace links on this date
integer
required
Number of direct clicks without scans across all workspace links on this date
integer
required
Number of clicks from Chrome browser across all workspace links on this date
integer
required
Number of clicks from iOS devices across all workspace links on this date
integer
required
Number of clicks from Android devices across all workspace links on this date
object
Statistics broken down by operating system across all workspace links
Show Operating system statistics
Show Operating system statistics
integer
required
Number of clicks from this operating system (OS name as key)
object
Statistics broken down by city across all workspace links
Show City statistics
Show City statistics
integer
required
Number of clicks from this city (city name as key)
object
Statistics broken down by operating system version across all workspace links
Show OS version statistics
Show OS version statistics
integer
required
Number of clicks from this OS version (version as key)
object
Statistics broken down by language across all workspace links
Show Language statistics
Show Language statistics
integer
required
Number of clicks from this language (language code as key)
object
object
Statistics broken down by browser across all workspace links
Show Browser statistics
Show Browser statistics
integer
required
Number of clicks from this browser (browser name as key)
object
Statistics broken down by country across all workspace links
Show Country statistics
Show Country statistics
integer
required
Number of clicks from this country (country code as key)
object
Statistics broken down by device and operating system combination across all workspace links
Show Device and OS statistics
Show Device and OS statistics
integer
required
Number of clicks from this device-OS combination (device-OS as key)
object
Statistics broken down by application across all workspace links
Show Application statistics
Show Application statistics
integer
required
Number of clicks from this application (app name as key)
object
Statistics broken down by device type (detailed) across all workspace links
Show Device type statistics
Show Device type statistics
integer
required
Number of clicks from this device type (device type as key)
object