curl --request GET \
--url https://devtune.ai/api/v2/projects/{projectId}/traffic/referrals \
--header 'Authorization: Bearer <token>'import requests
url = "https://devtune.ai/api/v2/projects/{projectId}/traffic/referrals"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://devtune.ai/api/v2/projects/{projectId}/traffic/referrals', 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://devtune.ai/api/v2/projects/{projectId}/traffic/referrals",
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://devtune.ai/api/v2/projects/{projectId}/traffic/referrals"
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://devtune.ai/api/v2/projects/{projectId}/traffic/referrals")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://devtune.ai/api/v2/projects/{projectId}/traffic/referrals")
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": {
"engines": {
"items": [
{
"conversionRate": 123,
"conversions": {
"current": 123,
"previous": 123,
"comparisonAvailable": true
},
"engagementSeconds": {
"current": 123,
"previous": 123,
"comparisonAvailable": true
},
"platform": "<string>",
"sessions": {
"current": 123,
"previous": 123,
"comparisonAvailable": true
}
}
],
"hasConversionSource": true,
"hasEngagementSource": true,
"totals": {}
},
"window": {
"dateFrom": "2023-12-25",
"dateTo": "2023-12-25"
},
"items": [
{}
],
"overview": {
"referralCoverage": {
"sessionsCurrent": true,
"sessionsPrevious": true,
"conversionsCurrent": true,
"conversionsPrevious": true
}
},
"pagination": {
"hasMore": true,
"nextCursor": "<string>",
"pageSize": 50,
"totalCount": 1
},
"windowDays": 7
},
"meta": {
"timestamp": "2023-11-07T05:31:56Z",
"projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": "<string>",
"message": "<string>",
"status": 123
}{
"error": "<string>",
"message": "<string>",
"status": 123
}{
"error": "<string>",
"message": "<string>",
"status": 123
}{
"error": "<string>",
"message": "<string>",
"status": 123
}{
"error": "<string>",
"message": "<string>",
"status": 123
}List AI referrals
Returns paginated AI-referral landing pages, overview and the complete GA4 engine breakdown for the same fixed reporting dates. Sessions are not people; conversion events are selected GA4 key events. Nullable provider measurements remain unavailable. Known counts can be partial: overview.referralCoverage reports current and previous coverage for sessions and conversion events. Compare a metric across periods only when both of its coverage flags are true.
curl --request GET \
--url https://devtune.ai/api/v2/projects/{projectId}/traffic/referrals \
--header 'Authorization: Bearer <token>'import requests
url = "https://devtune.ai/api/v2/projects/{projectId}/traffic/referrals"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://devtune.ai/api/v2/projects/{projectId}/traffic/referrals', 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://devtune.ai/api/v2/projects/{projectId}/traffic/referrals",
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://devtune.ai/api/v2/projects/{projectId}/traffic/referrals"
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://devtune.ai/api/v2/projects/{projectId}/traffic/referrals")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://devtune.ai/api/v2/projects/{projectId}/traffic/referrals")
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": {
"engines": {
"items": [
{
"conversionRate": 123,
"conversions": {
"current": 123,
"previous": 123,
"comparisonAvailable": true
},
"engagementSeconds": {
"current": 123,
"previous": 123,
"comparisonAvailable": true
},
"platform": "<string>",
"sessions": {
"current": 123,
"previous": 123,
"comparisonAvailable": true
}
}
],
"hasConversionSource": true,
"hasEngagementSource": true,
"totals": {}
},
"window": {
"dateFrom": "2023-12-25",
"dateTo": "2023-12-25"
},
"items": [
{}
],
"overview": {
"referralCoverage": {
"sessionsCurrent": true,
"sessionsPrevious": true,
"conversionsCurrent": true,
"conversionsPrevious": true
}
},
"pagination": {
"hasMore": true,
"nextCursor": "<string>",
"pageSize": 50,
"totalCount": 1
},
"windowDays": 7
},
"meta": {
"timestamp": "2023-11-07T05:31:56Z",
"projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": "<string>",
"message": "<string>",
"status": 123
}{
"error": "<string>",
"message": "<string>",
"status": 123
}{
"error": "<string>",
"message": "<string>",
"status": 123
}{
"error": "<string>",
"message": "<string>",
"status": 123
}{
"error": "<string>",
"message": "<string>",
"status": 123
}Authorizations
API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.
Path Parameters
Query Parameters
Fixed rolling window in days. Supported values are 7, 30, and 90. Defaults to 30.
7, 30, 90 Opaque cursor from the previous response; cursors expire after ~48 hours.
Results per page. Capped at 100.
1 <= x <= 100