Score de visibilidade

Este endpoint devolve as métricas detalhadas de Visibilidade atual para uma marca específica. As métricas refletem a presença da marca em vários motores de IA (como ChatGPT ou Perplexity), incluindo o Share of Voice, Taxa de Citação (Citation Rate), Taxa de Menção (Mention Rate) e Sentimento. Inclui também a evolução histórica destas métricas e o detalhe (breakdown) por cada motor de pesquisa.

curl --request GET \
  --url https://app.semantika.pt/api/v1/brands/1/visibility \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "share_of_voice": 85.5,
    "share_of_voice_delta": 2.5,
    "citation_rate": 45.2,
    "citation_rate_delta": 1.2,
    "mention_rate": 30.1,
    "mention_rate_delta": -0.5,
    "sentiment": 7.5,
    "sentiment_delta": 0.3,
    "sentiment_label": "Positive",
    "engines": [
      {
        "slug": "chatgpt",
        "name": "ChatGPT",
        "type": "llm",
        "score": 90.0,
        "delta": 1.0
      },
      {
        "slug": "perplexity",
        "name": "Perplexity",
        "type": "search",
        "score": 80.5,
        "delta": -0.5
      }
    ],
    "over_time": {
      "points": [
        { "date": "2023-10-01", "share_of_voice": 83.0 },
        { "date": "2023-10-08", "share_of_voice": 85.5 }
      ],
      "engines": []
    }
  }
}

curl --request GET \
  --url https://app.semantika.pt/api/v1/brands/1/visibility \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "share_of_voice": 85.5,
    "share_of_voice_delta": 2.5,
    "citation_rate": 45.2,
    "citation_rate_delta": 1.2,
    "mention_rate": 30.1,
    "mention_rate_delta": -0.5,
    "sentiment": 7.5,
    "sentiment_delta": 0.3,
    "sentiment_label": "Positive",
    "engines": [
      {
        "slug": "chatgpt",
        "name": "ChatGPT",
        "type": "llm",
        "score": 90.0,
        "delta": 1.0
      },
      {
        "slug": "perplexity",
        "name": "Perplexity",
        "type": "search",
        "score": 80.5,
        "delta": -0.5
      }
    ],
    "over_time": {
      "points": [
        { "date": "2023-10-01", "share_of_voice": 83.0 },
        { "date": "2023-10-08", "share_of_voice": 85.5 }
      ],
      "engines": []
    }
  }
}