Ver métricas de uma publicação
curl --request GET \
--url https://post.chatclean.com.br/api/analytics/publications/{publication} \
--header 'Authorization: Bearer <token>'import requests
url = "https://post.chatclean.com.br/api/analytics/publications/{publication}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://post.chatclean.com.br/api/analytics/publications/{publication}', 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://post.chatclean.com.br/api/analytics/publications/{publication}",
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://post.chatclean.com.br/api/analytics/publications/{publication}"
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://post.chatclean.com.br/api/analytics/publications/{publication}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://post.chatclean.com.br/api/analytics/publications/{publication}")
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{
"available": true,
"reason": null,
"publication": {
"id": "9d4a0b1c-2d3e-4f5a-8b6c-7d8e9f0a1b2c",
"post_platform_id": "9d3c1f2b-7a5c-4d9e-8f0a-1b2c3d4e5f60",
"social_account_key": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
"platform": "x",
"origin": "trypost",
"content_type": "text",
"availability": "available",
"provider_published_at": "2026-10-12T14:00:03+00:00",
"permalink": "https://x.com/postclean/status/1843921066571337728",
"excerpt": "We just shipped scheduled threads.",
"preview_metadata": null,
"account_display_name": "PostClean",
"account_username": "postclean",
"account_avatar_url": null
},
"snapshot": {
"date": "2026-10-14",
"collected_at": "2026-10-14T06:10:00+00:00",
"provider_observed_at": "2026-10-14T06:09:58+00:00",
"reactions_count": 42,
"comments_count": 5,
"shares_count": 7,
"saves_count": 3,
"views_count": null,
"impressions_count": 3120,
"reach_count": null,
"engagement_count": 57,
"exposure_count": 3120,
"exposure_kind": "impressions",
"watch_time_milliseconds": null,
"average_watch_time_milliseconds": null
},
"metrics": {
"impressions": {
"value": 3120,
"unit": "count",
"time_basis": "lifetime",
"precision": "exact",
"availability": "available",
"provider_metric": "impression_count",
"period_start": null,
"period_end": null
},
"engagement_rate": {
"value": 1.83,
"unit": "percent",
"time_basis": "lifetime",
"precision": "exact",
"availability": "available",
"provider_metric": "derived_engagements_per_impressions",
"period_start": null,
"period_end": null
}
}
}{
"message": "Unauthenticated."
}{
"message": "Active subscription required."
}{
"message": "<string>"
}{
"message": "<string>"
}{
"name": "rate_limit_exceeded",
"message": "Rate limit exceeded. Please retry after 30 seconds."
}Análises
Ver métricas de uma publicação
Retorna as análises mais recentes já salvas de uma publicação: um post publicado pelo PostClean ou encontrado num canal conectado. Pegue o id em top_posts de GET /analytics ou em GET /channels/{account}/insights/publications. Uma publicação apagada na rede ou indisponível, de outro workspace ou de uma rede sem análises retorna 404.
GET
/
analytics
/
publications
/
{publication}
Ver métricas de uma publicação
curl --request GET \
--url https://post.chatclean.com.br/api/analytics/publications/{publication} \
--header 'Authorization: Bearer <token>'import requests
url = "https://post.chatclean.com.br/api/analytics/publications/{publication}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://post.chatclean.com.br/api/analytics/publications/{publication}', 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://post.chatclean.com.br/api/analytics/publications/{publication}",
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://post.chatclean.com.br/api/analytics/publications/{publication}"
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://post.chatclean.com.br/api/analytics/publications/{publication}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://post.chatclean.com.br/api/analytics/publications/{publication}")
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{
"available": true,
"reason": null,
"publication": {
"id": "9d4a0b1c-2d3e-4f5a-8b6c-7d8e9f0a1b2c",
"post_platform_id": "9d3c1f2b-7a5c-4d9e-8f0a-1b2c3d4e5f60",
"social_account_key": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
"platform": "x",
"origin": "trypost",
"content_type": "text",
"availability": "available",
"provider_published_at": "2026-10-12T14:00:03+00:00",
"permalink": "https://x.com/postclean/status/1843921066571337728",
"excerpt": "We just shipped scheduled threads.",
"preview_metadata": null,
"account_display_name": "PostClean",
"account_username": "postclean",
"account_avatar_url": null
},
"snapshot": {
"date": "2026-10-14",
"collected_at": "2026-10-14T06:10:00+00:00",
"provider_observed_at": "2026-10-14T06:09:58+00:00",
"reactions_count": 42,
"comments_count": 5,
"shares_count": 7,
"saves_count": 3,
"views_count": null,
"impressions_count": 3120,
"reach_count": null,
"engagement_count": 57,
"exposure_count": 3120,
"exposure_kind": "impressions",
"watch_time_milliseconds": null,
"average_watch_time_milliseconds": null
},
"metrics": {
"impressions": {
"value": 3120,
"unit": "count",
"time_basis": "lifetime",
"precision": "exact",
"availability": "available",
"provider_metric": "impression_count",
"period_start": null,
"period_end": null
},
"engagement_rate": {
"value": 1.83,
"unit": "percent",
"time_basis": "lifetime",
"precision": "exact",
"availability": "available",
"provider_metric": "derived_engagements_per_impressions",
"period_start": null,
"period_end": null
}
}
}{
"message": "Unauthenticated."
}{
"message": "Active subscription required."
}{
"message": "<string>"
}{
"message": "<string>"
}{
"name": "rate_limit_exceeded",
"message": "Rate limit exceeded. Please retry after 30 seconds."
}Authorizations
Chave de API do workspace, criada em Configurações > Chaves de API.
Path Parameters
Id da publicação nas métricas (o id de um post em destaque ou de uma linha de desempenho de posts do canal).
Response
As análises da publicação.
Análises salvas de uma publicação: a contagem diária mais recente coletada da rede.
Sempre true em GET /analytics/publications/{publication}.
Sempre null em GET /analytics/publications/{publication}.
Show child attributes
Show child attributes
A contagem diária mais recente, ou null enquanto nenhuma foi coletada.
Show child attributes
Show child attributes
Métricas que a rede informa para esta publicação, pela chave da métrica (reactions, comments, views, impressions, reach, engagement_rate, ...). Cada valor é um objeto. Vem como lista vazia [] enquanto nenhuma contagem foi coletada. engagement_rate é calculado pelo PostClean quando há engajamento e alcance.
Show child attributes
Show child attributes