Quick Start

Get up and running with Fluence CRM Intelligence API in minutes.

1. Get Your API Key

Option 1: Sign Up Online

Visit our Sign Up Page to create your account and get instant access to API keys.

Option 2: Contact Support

Contact support@tryfluence.tech to request your API key. Our team will provision your account and send you the credentials within 24 hours.

2. Authentication

All Fluence API requests require authentication using an API key in the request header:

curl "https://api.fluenceinsights.com/health" \
  -H "X-API-Key: your-api-key-here"

3. Test Your Connection

Use the health endpoint to verify your API key is working:

curl "https://api.fluenceinsights.com/health" \
  -H "X-API-Key: your-api-key-here"

Actual Response:

{
  "status": "saudável",
  "message": "🎉 API CRM Português com Sistema de Créditos FUNCIONANDO!",
  "timestamp": "2024-07-18T14:00:00Z",
  "version": "1.3.0",
  "sistema_creditos": "✅ Sistema de créditos ativo",
  "features": [
    "credit_tracking",
    "api_key_validation", 
    "billing_transparency",
    "region_br_support"
  ]
}

4. Make Your First CRM Request

Test the CRM Basic endpoint for essential lead qualification:

Using Portuguese Parameters (Only Supported Method)

curl -X POST "https://api.fluenceinsights.com/crm_basico" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key-here" \
  -d '{
    "primeiro_nome": "João",
    "ultimo_nome": "Silva",
    "empresa": "TechCorp Brasil"
  }'

Note: Profile URLs are not supported as input. Provide name + company only. A public LinkedIn presence is recommended for matching, but you do not provide any URLs.

You get:

{
  "analise": {
    "cargo": "CEO",
    "tipo_stakeholder": "C-Level Executive",
    "localizacao_detectada": "São Paulo, Brasil",
    "interesses_profissionais": [
      "Desenvolvimento profissional e novas competências",
      "Tendências da indústria e inovação"
    ],
    "manual_comprador": {
      "persona": {
        "titulo": "Profissional Estratégico - CEO",
        "descricao": "Líder focado em inovação"
      },
      "pontos_dor": [
        {"desafio": "Crescimento", "impacto": "Crítico para competitividade no mercado"}
      ],
      "motivadores_compra": [
        {"texto": "Impulsionar inovação e vantagem competitiva", "impacto": "Liderança de mercado"}
      ]
    },
    "linguagem_impacto": [
      "Impulsione o crescimento estratégico da TechCorp com decisões baseadas em dados"
    ]
  },
  "billing_info": {
    "creditos_utilizados": 1,
    "creditos_restantes": 999,
    "tipo_plano": "premium"
  }
}

Available Plans

Feature	Basic (1 credit)	Complete (2 credits)	Plus (3 credits)
Core Analysis
Digital Footprint Analysis	✅	✅	✅
Professional Role Analysis	✅	✅	✅
Stakeholder Classification	✅	✅	✅
Location Detection	✅	✅	✅
Professional Interests	✅	✅	✅
Advanced Psychology
OCEAN Personality Scores	❌	✅	✅
MBTI Assessment	❌	✅	✅
Buyer Intelligence
Buyer Persona	Basic	Advanced	Advanced
Pain Points Analysis	❌	✅	✅
Purchase Motivators	❌	✅	✅
Market Intelligence
AI Market Intelligence	❌	❌	✅
Company Context & Trends	❌	❌	✅
Strategic Insights	❌	❌	✅
Regional Focus
Brazil-Specific Insights	✅	✅	✅
Regional Business Context	❌	✅	✅

Available Endpoints

Single Profile Endpoints

Endpoint	Purpose	Cost	Fields
/crm_basico	Essential lead qualification	1 credit	6 core fields
/crm	Complete behavioral analysis	2 credits	11+ fields with OCEAN/MBTI
/crm_plus	Premium AI-enhanced insights	3 credits	12+ fields with market intelligence

Batch Processing Endpoints

Endpoint	Purpose	Cost	Max Profiles
/crm_basico_batch	Bulk lead qualification	1 credit × profiles	50/request
/crm_batch	Bulk behavioral analysis	2 credits × profiles	50/request
/crm_plus_batch	Bulk premium insights	3 credits × profiles	50/request

Utility Endpoints

Endpoint	Purpose	Cost	Plan
/saude	Health check and API validation	Free	Any
/status	Detailed API status	Free	Any
/creditos	Check remaining credits	Free	Any
/tiers-disponiveis	Available plans and pricing	Free	Any

Rate Limits

Plan	Requests/Second	Burst Limit	Monthly Quota
Basic	5 req/sec	10 requests	500 requests
Premium	10 req/sec	20 requests	2000 requests

Error Codes

Code	Description	Action
400	Bad Request	Check your request parameters
401	Invalid API key	Check your API key format
402	Payment Required	Insufficient credits
403	Forbidden	Contact support to verify account status
404	Not Found	API key not found
429	Rate limit exceeded	Reduce request frequency
500	Server Error	Try again later

API Key Security

• Never commit API keys to version control
• Store keys as environment variables
• Rotate keys regularly for production use
• Contact support immediately if a key is compromised

Next Steps

• 🚀 API Playground - Test with your API key
• 💻 Integration Examples - Code samples for your language
• ❓ Get Help - Common issues and solutions

Support

📧 Email: support@tryfluence.tech
🕒 Response Time: Within 24 hours