Read account counters and daily analytics
curl --request GET \
--url https://api.dev.postinger.dev/public/v1/analytics/accounts/{accountId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.dev.postinger.dev/public/v1/analytics/accounts/{accountId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.dev.postinger.dev/public/v1/analytics/accounts/{accountId}', 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.dev.postinger.dev/public/v1/analytics/accounts/{accountId}",
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://api.dev.postinger.dev/public/v1/analytics/accounts/{accountId}"
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://api.dev.postinger.dev/public/v1/analytics/accounts/{accountId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dev.postinger.dev/public/v1/analytics/accounts/{accountId}")
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": {
"from": "2023-12-25",
"to": "2023-12-25",
"timezone": "UTC",
"generatedAt": "2023-11-07T05:31:56Z",
"account": {
"metrics": {
"followers": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
},
"following": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
},
"media_count": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
}
},
"collectedAt": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"platform": "instagram"
},
"daily": [
{
"metrics": {
"views": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
},
"likes": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
},
"comments": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
},
"shares": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
},
"saves": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
}
},
"collectedAt": "2023-11-07T05:31:56Z",
"periodStart": "2023-11-07T05:31:56Z",
"periodEnd": "2023-11-07T05:31:56Z"
}
],
"followers": [
{
"value": "<string>",
"collectedAt": "2023-11-07T05:31:56Z"
}
]
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}Analytics
Read account counters and daily analytics
Required permissions: analytics-read. Reads stored measurements only; never triggers collection. Counters are decimal strings; null means missing data, not zero. generatedAt is the response time, collectedAt is the measurement time. Account counters are the latest stored totals, regardless of date range. Daily analytics use the requested inclusive UTC range. Follower observations also include the previous day as a comparison baseline. Another project’s account returns 404.
GET
/
analytics
/
accounts
/
{accountId}
Read account counters and daily analytics
curl --request GET \
--url https://api.dev.postinger.dev/public/v1/analytics/accounts/{accountId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.dev.postinger.dev/public/v1/analytics/accounts/{accountId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.dev.postinger.dev/public/v1/analytics/accounts/{accountId}', 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.dev.postinger.dev/public/v1/analytics/accounts/{accountId}",
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://api.dev.postinger.dev/public/v1/analytics/accounts/{accountId}"
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://api.dev.postinger.dev/public/v1/analytics/accounts/{accountId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dev.postinger.dev/public/v1/analytics/accounts/{accountId}")
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": {
"from": "2023-12-25",
"to": "2023-12-25",
"timezone": "UTC",
"generatedAt": "2023-11-07T05:31:56Z",
"account": {
"metrics": {
"followers": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
},
"following": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
},
"media_count": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
}
},
"collectedAt": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"platform": "instagram"
},
"daily": [
{
"metrics": {
"views": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
},
"likes": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
},
"comments": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
},
"shares": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
},
"saves": {
"value": "<string>",
"status": "available",
"collectedAt": "2023-11-07T05:31:56Z"
}
},
"collectedAt": "2023-11-07T05:31:56Z",
"periodStart": "2023-11-07T05:31:56Z",
"periodEnd": "2023-11-07T05:31:56Z"
}
],
"followers": [
{
"value": "<string>",
"collectedAt": "2023-11-07T05:31:56Z"
}
]
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"meta": {
"requestId": "<string>"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
Inclusive UTC date. Both dates are required; at most 366 days.
Inclusive UTC date. Both dates are required; at most 366 days.
Was this page helpful?