Listar Concorrentes

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors?timeframe=30d&sortBy=mentions&limit=20' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

import requests

r = requests.get(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    params={"timeframe": "30d", "sortBy": "visibility", "limit": 20},
)
competitors = r.json()["data"]["competitors"]
print([c["name"] for c in competitors if c["isUserBrand"]])

{
  "data": {
    "competitors": [
      {
        "id": "c7d8e9f0-a1b2-4345-cdef-678901234abc",
        "name": "Finseo",
        "domain": "finseo.ai",
        "baseDomain": "finseo.ai",
        "isStarred": true,
        "isUserBrand": true,
        "totalMentions": 412,
        "visibleResults": 186,
        "averagePosition": 17.3,
        "sentimentScore": 0.77,
        "promptCount": 42
      },
      {
        "id": "d8e9f0a1-b2c3-4456-def0-789012345bcd",
        "name": "Competitor A",
        "domain": "competitor-a.com",
        "baseDomain": "competitor-a.com",
        "isStarred": false,
        "isUserBrand": false,
        "totalMentions": 389,
        "visibleResults": 172,
        "averagePosition": 21.4,
        "sentimentScore": 0.62,
        "promptCount": 42
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 15,
      "hasMore": false
    }
  }
}

GET

projects

{projectId}

competitors

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors?timeframe=30d&sortBy=mentions&limit=20' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

import requests

r = requests.get(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    params={"timeframe": "30d", "sortBy": "visibility", "limit": 20},
)
competitors = r.json()["data"]["competitors"]
print([c["name"] for c in competitors if c["isUserBrand"]])

{
  "data": {
    "competitors": [
      {
        "id": "c7d8e9f0-a1b2-4345-cdef-678901234abc",
        "name": "Finseo",
        "domain": "finseo.ai",
        "baseDomain": "finseo.ai",
        "isStarred": true,
        "isUserBrand": true,
        "totalMentions": 412,
        "visibleResults": 186,
        "averagePosition": 17.3,
        "sentimentScore": 0.77,
        "promptCount": 42
      },
      {
        "id": "d8e9f0a1-b2c3-4456-def0-789012345bcd",
        "name": "Competitor A",
        "domain": "competitor-a.com",
        "baseDomain": "competitor-a.com",
        "isStarred": false,
        "isUserBrand": false,
        "totalMentions": 389,
        "visibleResults": 172,
        "averagePosition": 21.4,
        "sentimentScore": 0.62,
        "promptCount": 42
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 15,
      "hasMore": false
    }
  }
}

Retorna os concorrentes ranqueados por visibilidade em IA: Mentions, visibilidade, posição média e Sentiment. Use isto para ver como a Finseo se compara a outras marcas nas respostas do ChatGPT, Claude e Perplexity.

string

obrigatório

Identificador do projeto.

string

padrão:"30d"

Janela de análise, por exemplo 7d, 30d.

string

Filtre os resultados de Tracking para um único modelo.

string

Filtre os Prompts por idioma.

string

Array JSON ou Tags de Prompt separadas por vírgula.

string

Filtre por parte do nome ou domínio do concorrente.

string

padrão:"mentions"

Um de visibility, mentions, position, sentiment, name.

string

padrão:"desc"

asc ou desc.

integer

padrão:"1"

Número da página.

integer

padrão:"50"

Tamanho da página (1–500).

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors?timeframe=30d&sortBy=mentions&limit=20' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

import requests

r = requests.get(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    params={"timeframe": "30d", "sortBy": "visibility", "limit": 20},
)
competitors = r.json()["data"]["competitors"]
print([c["name"] for c in competitors if c["isUserBrand"]])

{
  "data": {
    "competitors": [
      {
        "id": "c7d8e9f0-a1b2-4345-cdef-678901234abc",
        "name": "Finseo",
        "domain": "finseo.ai",
        "baseDomain": "finseo.ai",
        "isStarred": true,
        "isUserBrand": true,
        "totalMentions": 412,
        "visibleResults": 186,
        "averagePosition": 17.3,
        "sentimentScore": 0.77,
        "promptCount": 42
      },
      {
        "id": "d8e9f0a1-b2c3-4456-def0-789012345bcd",
        "name": "Competitor A",
        "domain": "competitor-a.com",
        "baseDomain": "competitor-a.com",
        "isStarred": false,
        "isUserBrand": false,
        "totalMentions": 389,
        "visibleResults": 172,
        "averagePosition": 21.4,
        "sentimentScore": 0.62,
        "promptCount": 42
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 15,
      "hasMore": false
    }
  }
}

Série Temporal de Métricas Listar Fontes

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Export

Attribution

Listar Concorrentes