Números do planejador social

v1.0.0

GEThttps://api.growthaisystem.com/api/v1/social/metrics

ExigeAuthorization: Bearer gos_…— Chave de API (gos_…)· escopossocial.read

Alcance, engajamento e seguidores do período (comparados com o período anterior), o ranking de posts, os melhores horários e a vida útil dos posts — os mesmos números da aba Números. Vêm de um cache de até 15 minutos (frescor diz de quando são); esta rota nunca força uma leitura nova na rede. Sem conta conectada, situacao diz e os blocos vêm vazios.

Parâmetros de consulta

Vão na querystring, depois do ?.

daysstringopcional
Período: 7, 28 ou 90 dias (comparado com o período anterior do mesmo tamanho).
- padrão "28"
- um de"7""28""90"
connectionIdstringopcional
Só uma conta (GET /social/accounts). Omitido = todas.
- tamanho 1–80

Respostas

6 respostas documentadas — o código, o que ele significa nesta rota e a forma do corpo.

200Deu certoapplication/json

Os números do período, no envelope da aba Números da tela.

V1SocialMetrics

situacaostring
- um de"ok""sem-contas""sem-addon""sem-analytics-nas-contas""perfil-ambiguo"
- diasnumber
- destring
- atestring
- deAnteriorstring
- ateAnteriorstring
connectionIdstring | null
- lastSyncstring | null
- buscadoEmstring
- geradoEmstring
- doCacheboolean
- contasSincronizandonumber
- syncDisparadoboolean
- temLinkedinboolean
Uma destas formas
- oktrue
  sempre true
  Cada item da lista
  datastring
  publicacoesnumber
  alcancenumber
  impressoesnumber
  curtidasnumber
  comentariosnumber
  compartilhamentosnumber
  salvamentosnumber
  Cada item da lista
  datastring
  publicacoesnumber
  alcancenumber
  impressoesnumber
  curtidasnumber
  comentariosnumber
  compartilhamentosnumber
  salvamentosnumber
  publicacoesnumber
  alcancenumber
  impressoesnumber
  curtidasnumber
  comentariosnumber
  compartilhamentosnumber
  salvamentosnumber
  interacoesnumber
  publicacoesnumber
  alcancenumber
  impressoesnumber
  curtidasnumber
  comentariosnumber
  compartilhamentosnumber
  salvamentosnumber
  interacoesnumber
  Cada item da lista
  redestring
  publicacoesnumber
  alcancenumber
  impressoesnumber
  curtidasnumber
  comentariosnumber
  compartilhamentosnumber
  salvamentosnumber
- okfalse
  sempre false
  errostring
Uma destas formas
- oktrue
  sempre true
  Cada item da lista
  idstring
  textostring
  publicadoEmstring | null
  miniaturaUrlstring | null
  tipoMidiastring | null
  redestring
  permalinkstring | null
  alcancenumber
  impressoesnumber
  curtidasnumber
  comentariosnumber
  compartilhamentosnumber
  salvamentosnumber
  interacoesnumber
  taxanumber | null
  impulsionadoboolean
  saiuDaquiboolean
  Cada item da lista
  redestring
  contastring | null
  permalinkstring | null
  alcancenumber
  impressoesnumber
  curtidasnumber
  comentariosnumber
  compartilhamentosnumber
  salvamentosnumber
  interacoesnumber
- okfalse
  sempre false
  errostring
Uma destas formas
- oktrue
  sempre true
  Cada item da lista
  diaSemanaUtcnumber
  horaUtcnumber
  engajamentoMedionumber
  publicacoesnumber
- okfalse
  sempre false
  errostring
Uma destas formas
- oktrue
  sempre true
  Cada item da lista
  ordemnumber
  rotulostring
  pctAcumuladonumber
  publicacoesnumber
- okfalse
  sempre false
  errostring

GET/social/metrics

https://api.growthaisystem.com/api/v1/social/metrics

curl "https://api.growthaisystem.com/api/v1/social/metrics" \
  -H "Authorization: Bearer gos_SEU_TOKEN_AQUI"

Isto chama a API de verdade. A requisição sai do seu navegador direto para https://api.growthaisystem.com — dado real, do workspace da chave que você colar. Em escritas, o efeito é permanente.

Chave de APIBearerobrigatório

Vai no cabeçalho Authorization: Bearer …. Ela nunca aparece no cURL copiável nem sai desta aba.

Lembrar nesta aba — some ao fechá-la. Não marque em computador compartilhado: a chave dá acesso ao workspace inteiro dentro dos escopos dela.

Parâmetros de consulta

Marque os que devem ir na querystring. Digitar já marca.

daysenum

Período: 7, 28 ou 90 dias (comparado com o período anterior do mesmo tamanho).

connectionIdtexto

Só uma conta (GET /social/accounts). Omitido = todas.

Vai sair assim

GEThttps://api.growthaisystem.com/api/v1/social/metrics

O botão copia o cURL equivalente — com gos_SEU_TOKEN_AQUI no lugar da sua chave.

⌘Enter

{
  "situacao": "ok",
  "janela": {
    "dias": 0,
    "de": "<texto>",
    "ate": "<texto>",
    "deAnterior": "<texto>",
    "ateAnterior": "<texto>"
  },
  "connectionId": null,
  "frescor": {
    "lastSync": null,
    "buscadoEm": "<texto>",
    "geradoEm": "<texto>",
    "doCache": false,
    "contasSincronizando": 0,
    "syncDisparado": false,
    "temLinkedin": false
  },
  "serie": {
    "ok": true,
    "dados": {
      "atual": [
        {
          "data": "<texto>",
          "publicacoes": 0,
          "alcance": 0,
          "impressoes": 0,
          "curtidas": 0,
          "comentarios": 0,
          "compartilhamentos": 0,
          "salvamentos": 0
        }
      ],
      "anterior": [
        {
          "data": "<texto>",
          "publicacoes": 0,
          "alcance": 0,
          "impressoes": 0,
          "curtidas": 0,
          "comentarios": 0,
          "compartilhamentos": 0,
          "salvamentos": 0
        }
      ],
      "resumo": {
        "atual": {
          "publicacoes": 0,
          "alcance": 0,
          "impressoes": 0,
          "curtidas": 0,
          "comentarios": 0,
          "compartilhamentos": 0,
          "salvamentos": 0,
          "interacoes": 0
        },
        "anterior": {
          "publicacoes": 0,
          "alcance": 0,
          "impressoes": 0,
          "curtidas": 0,
          "comentarios": 0,
          "compartilhamentos": 0,
          "salvamentos": 0,
          "interacoes": 0
        }
      },
      "porRede": [
        {
          "rede": "<texto>",
          "publicacoes": 0,
          "alcance": 0,
          "impressoes": 0,
          "curtidas": 0,
          "comentarios": 0,
          "compartilhamentos": 0,
          "salvamentos": 0
        }
      ]
    }
  },
  "ranking": {
    "ok": true,
    "dados": {
      "posts": [
        {
          "id": "<texto>",
          "texto": "<texto>",
          "publicadoEm": null,
          "miniaturaUrl": null,
          "tipoMidia": null,
          "rede": "<texto>",
          "permalink": null,
          "alcance": 0,
          "impressoes": 0,
          "curtidas": 0,
          "comentarios": 0,
          "compartilhamentos": 0,
          "salvamentos": 0,
          "interacoes": 0,
          "taxa": null,
          "impulsionado": false,
          "saiuDaqui": false,
          "porRede": [
            {
              "rede": null,
              "conta": null,
              "permalink": null,
              "alcance": null,
              "impressoes": null,
              "curtidas": null,
              "comentarios": null,
              "compartilhamentos": null,
              "salvamentos": null,
              "interacoes": null
            }
          ]
        }
      ]
    }
  },
  "horarios": {
    "ok": true,
    "dados": {
      "slots": [
        {
          "diaSemanaUtc": 0,
          "horaUtc": 0,
          "engajamentoMedio": 0,
          "publicacoes": 0
        }
      ]
    }
  },
  "vida": {
    "ok": true,
    "dados": {
      "baldes": [
        {
          "ordem": 0,
          "rotulo": "<texto>",
          "pctAcumulado": 0,
          "publicacoes": 0
        }
      ]
    }
  }
}