Get Ask site analytics
curl --request GET \
--url https://context7.com/api/v2/teamspaces/{teamspaceId}/ask-sites/{siteKey}/analytics \
--header 'Authorization: Bearer <token>'import requests
url = "https://context7.com/api/v2/teamspaces/{teamspaceId}/ask-sites/{siteKey}/analytics"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://context7.com/api/v2/teamspaces/{teamspaceId}/ask-sites/{siteKey}/analytics', 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://context7.com/api/v2/teamspaces/{teamspaceId}/ask-sites/{siteKey}/analytics",
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: Bearer <token>"
],
]);
$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://context7.com/api/v2/teamspaces/{teamspaceId}/ask-sites/{siteKey}/analytics"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://context7.com/api/v2/teamspaces/{teamspaceId}/ask-sites/{siteKey}/analytics")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://context7.com/api/v2/teamspaces/{teamspaceId}/ask-sites/{siteKey}/analytics")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"series": [
{
"date": "<string>",
"total": 123,
"unanswered": 123,
"clients": {}
}
],
"clients": [
{
"client": "<string>",
"count": 123
}
],
"gaps": [
{
"question": "<string>",
"count": 123
}
],
"topQuestions": [
{
"question": "<string>",
"count": 123
}
],
"recent": [
{
"id": "<string>",
"question": "<string>",
"client": "anthropic",
"answered": true,
"at": "2023-11-07T05:31:56Z"
}
]
}
}{
"error": "invalid_days",
"message": "Days must be 1, 7 or 30."
}{
"error": "invalid_api_key",
"message": "Invalid API key. Please check your API key. API keys should start with 'ctx7sk' prefix."
}{
"error": "forbidden",
"message": "You do not have access to this teamspace."
}{
"error": "no_site",
"message": "Site not found."
}{
"error": "internal_error",
"message": "An error occurred while processing your request"
}Ask Sites
Get Ask site analytics
Requests over time by client, the clients that asked, the questions with no answer (gaps), the top questions and the most recent questions. Returns personal data, so an API key needs Write access (other keys get 403 write_access_required).
GET
/
v2
/
teamspaces
/
{teamspaceId}
/
ask-sites
/
{siteKey}
/
analytics
Get Ask site analytics
curl --request GET \
--url https://context7.com/api/v2/teamspaces/{teamspaceId}/ask-sites/{siteKey}/analytics \
--header 'Authorization: Bearer <token>'import requests
url = "https://context7.com/api/v2/teamspaces/{teamspaceId}/ask-sites/{siteKey}/analytics"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://context7.com/api/v2/teamspaces/{teamspaceId}/ask-sites/{siteKey}/analytics', 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://context7.com/api/v2/teamspaces/{teamspaceId}/ask-sites/{siteKey}/analytics",
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: Bearer <token>"
],
]);
$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://context7.com/api/v2/teamspaces/{teamspaceId}/ask-sites/{siteKey}/analytics"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://context7.com/api/v2/teamspaces/{teamspaceId}/ask-sites/{siteKey}/analytics")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://context7.com/api/v2/teamspaces/{teamspaceId}/ask-sites/{siteKey}/analytics")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"series": [
{
"date": "<string>",
"total": 123,
"unanswered": 123,
"clients": {}
}
],
"clients": [
{
"client": "<string>",
"count": 123
}
],
"gaps": [
{
"question": "<string>",
"count": 123
}
],
"topQuestions": [
{
"question": "<string>",
"count": 123
}
],
"recent": [
{
"id": "<string>",
"question": "<string>",
"client": "anthropic",
"answered": true,
"at": "2023-11-07T05:31:56Z"
}
]
}
}{
"error": "invalid_days",
"message": "Days must be 1, 7 or 30."
}{
"error": "invalid_api_key",
"message": "Invalid API key. Please check your API key. API keys should start with 'ctx7sk' prefix."
}{
"error": "forbidden",
"message": "You do not have access to this teamspace."
}{
"error": "no_site",
"message": "Site not found."
}{
"error": "internal_error",
"message": "An error occurred while processing your request"
}Authorizations
Get your API key at context7.com/dashboard. Treat your API key like a password and store it securely. Every key can read the management API (/v2/teamspaces/*), except personal data: member and invitation emails, library requesters, visitor questions, Docs7 reader searches, conversations, feedback and feature requests, and the GitHub account behind a build. To read those or make changes there, the key must be created with Write access ticked; other keys get 403 write_access_required.
Path Parameters
Teamspace id (uuid).
The site's public key, which is also its id.
Pattern:
^ask_[0-9a-f]{24}$Query Parameters
The window in days. 1 is the last 24 hours (hourly points).
Available options:
1, 7, 30 Response
Analytics for the window
Show child attributes
Show child attributes
Was this page helpful?