Documentação da API

v1.0

API do ICP Match

A API do ICP Match permite que você calcule o score de compatibilidade entre perfis de leads e suas personas criadas na plataforma. Utilize esta API para integrar a análise de ICP Match em seus sistemas, CRMs ou workflows automatizados.

Autenticação JWT

Segura e privada

Análise em tempo real

Respostas rápidas

tRPC Protocol

Type-safe

Autenticação

A API utiliza autenticação baseada em sessão JWT. Você precisa estar autenticado na plataforma para fazer requisições à API.

Como obter o token JWT:

  1. Faça login na plataforma PERSONAS APP
  2. Abra as ferramentas de desenvolvedor do navegador (F12)
  3. Vá para a aba "Application" → "Cookies"
  4. Copie o valor do cookie chamado session
  5. Use este valor no header Cookie: session=SEU_TOKEN

Importante

O token JWT expira após 30 dias de inatividade. Você precisará fazer login novamente para obter um novo token. Nunca compartilhe seu token JWT publicamente.

Endpoints Disponíveis

POST/api/trpc/icpMatch.analyzeMatch

Analisa o match entre um perfil de lead e uma persona específica

Parâmetros de Entrada:

personaIdstring (obrigatório) - ID da persona para comparação
urlsstring[] (opcional) - URLs de perfis sociais (LinkedIn, Instagram, Facebook)
manualDataobject (opcional) - Dados manuais do lead (nome, cargo, empresa, etc.)

Resposta:

{
  "id": 123,
  "score": 85.5,
  "badge": "good",
  "attributeScores": [
    {
      "attribute": "jobTitle",
      "score": 90,
      "weight": 0.25,
      "weightedScore": 22.5,
      "reasoning": "Cargo alinhado com ICP"
    }
  ],
  "recommendations": {
    "summary": "Lead com alto potencial...",
    "strengths": ["Cargo sênior", "Empresa do setor alvo"],
    "weaknesses": ["Localização diferente"],
    "actionItems": ["Personalizar abordagem..."],
    "approachSuggestions": "Focar em ROI..."
  },
  "confidenceLevel": "high",
  "dataSource": "linkedin",
  "missingAttributes": []
}

Badges de Classificação:

perfect (90-100)good (70-89)moderate (50-69)weak (0-49)
GET/api/trpc/icpMatch.getMatchDetails

Busca detalhes completos de uma análise já realizada

Parâmetros de Entrada:

matchIdstring (obrigatório) - ID do match criado anteriormente

Resposta:

Retorna o mesmo formato da resposta do analyzeMatch

Exemplos de Código

curl -X POST https://icp-creator.manus.space/api/trpc/icpMatch.analyzeMatch \\
  -H "Content-Type: application/json" \\
  -H "Cookie: session=SEU_TOKEN_JWT" \\
  -d '{
    "personaId": "123",
    "urls": ["https://linkedin.com/in/exemplo"]
  }'

Playground - Teste a API

Você precisa estar autenticado para testar a API

Rate Limits e Códigos de Erro

Limites por Plano:

Free

Sem acesso à API

0 requisições/mês

Pro

Ideal para pequenas integrações

100 requisições/mês

Enterprise

Sem limites

Ilimitado

Códigos de Erro Comuns:

401 UNAUTHORIZED

Token JWT inválido ou expirado

403 FORBIDDEN

Limite de requisições atingido ou plano insuficiente

404 NOT_FOUND

Persona ou match não encontrado

500 INTERNAL_SERVER_ERROR

Erro interno do servidor