curl --request GET \
--url https://devtune.ai/api/v2/projects/{projectId}/positioning \
--header 'Authorization: Bearer <token>'import requests
url = "https://devtune.ai/api/v2/projects/{projectId}/positioning"
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}/positioning', 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}/positioning",
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}/positioning"
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}/positioning")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://devtune.ai/api/v2/projects/{projectId}/positioning")
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": {
"current_set_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"window": {
"days": 30,
"from": "2023-12-25",
"to": "2023-12-25"
},
"series_started_on": "2023-12-25",
"competitor_changes": [
"2023-12-25"
],
"statements": [
{
"statement_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"statement": "<string>",
"kind": "positioning",
"status": "active",
"series_started_on": "2023-12-25",
"eligible": 1,
"scored": 1,
"abstained": 1,
"brand_counts": {},
"another_product": 1,
"several": 1,
"nobody": 1,
"brands": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
}
],
"share_of_statement": 0.5,
"day": "2023-12-25",
"prior_status": "comparable",
"prior": {
"scored": 1,
"brand_counts": {},
"another_product": 1,
"several": 1,
"nobody": 1,
"share_of_statement": 0.5
}
}
],
"daily": [
{
"statement_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"statement": "<string>",
"kind": "positioning",
"status": "active",
"series_started_on": "2023-12-25",
"eligible": 1,
"scored": 1,
"abstained": 1,
"brand_counts": {},
"another_product": 1,
"several": 1,
"nobody": 1,
"brands": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
}
],
"share_of_statement": 0.5,
"day": "2023-12-25",
"competitor_set_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"is_current_set": true,
"prior_status": "comparable",
"prior": {
"scored": 1,
"brand_counts": {},
"another_product": 1,
"several": 1,
"nobody": 1,
"share_of_statement": 0.5
}
}
],
"prior_window": {
"from": "2023-12-25",
"to": "2023-12-25"
}
},
"meta": {
"timestamp": "2023-11-07T05:31:56Z",
"projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}Get positioning match
Returns positioning counts, resolved brand names, daily counts and share_of_statement. Share is the primary brand count divided by brand_counts plus another_product, excluding several and nobody. Below ten named-product assignments the share is null. Each statement also carries prior_status and, when that is comparable, the previous window’s totals, for a change against the window of the same length before it. prior_status is comparable when both windows measured the current competitor set and the previous one was scored on every day, platform and intent it had eligible answers for; otherwise it is competitor_changed or incomplete and prior is null. Competitor changes and the series start date identify the comparison period. Requires the positioning.read scope.
curl --request GET \
--url https://devtune.ai/api/v2/projects/{projectId}/positioning \
--header 'Authorization: Bearer <token>'import requests
url = "https://devtune.ai/api/v2/projects/{projectId}/positioning"
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}/positioning', 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}/positioning",
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}/positioning"
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}/positioning")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://devtune.ai/api/v2/projects/{projectId}/positioning")
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": {
"current_set_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"window": {
"days": 30,
"from": "2023-12-25",
"to": "2023-12-25"
},
"series_started_on": "2023-12-25",
"competitor_changes": [
"2023-12-25"
],
"statements": [
{
"statement_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"statement": "<string>",
"kind": "positioning",
"status": "active",
"series_started_on": "2023-12-25",
"eligible": 1,
"scored": 1,
"abstained": 1,
"brand_counts": {},
"another_product": 1,
"several": 1,
"nobody": 1,
"brands": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
}
],
"share_of_statement": 0.5,
"day": "2023-12-25",
"prior_status": "comparable",
"prior": {
"scored": 1,
"brand_counts": {},
"another_product": 1,
"several": 1,
"nobody": 1,
"share_of_statement": 0.5
}
}
],
"daily": [
{
"statement_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"statement": "<string>",
"kind": "positioning",
"status": "active",
"series_started_on": "2023-12-25",
"eligible": 1,
"scored": 1,
"abstained": 1,
"brand_counts": {},
"another_product": 1,
"several": 1,
"nobody": 1,
"brands": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
}
],
"share_of_statement": 0.5,
"day": "2023-12-25",
"competitor_set_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"is_current_set": true,
"prior_status": "comparable",
"prior": {
"scored": 1,
"brand_counts": {},
"another_product": 1,
"several": 1,
"nobody": 1,
"share_of_statement": 0.5
}
}
],
"prior_window": {
"from": "2023-12-25",
"to": "2023-12-25"
}
},
"meta": {
"timestamp": "2023-11-07T05:31:56Z",
"projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}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
The project the credential is bound to. Read it from GET /connection.
Query Parameters
30, 90 1 - 1001 - 100