🔐 Authentication & Common Information

Base URL

Production API: https://api.fluenceinsights.com

All Fluence API endpoints use a single production base URL for unified access.

Custom Domain

Our API is accessible via the custom domain https://api.fluenceinsights.com which provides a unified gateway for all Fluence services. All endpoints in this documentation use this production URL.

Getting API Keys

Sign Up Online

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

Contact Support

Alternatively, contact support@tryfluence.tech to request your API key.

Authentication

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

X-API-Key: your-api-key-here

API Key Format

• Length: 40 alphanumeric characters
• Example: bi41LFw9Q8alZqm3fmtDA2xv941sSqIM5VgNc5f3
• Header Name: X-API-Key (not Authorization)

Example Request

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

API Key Security

Best Practices

• 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
• Use different keys for development and production

Environment Variables

# Set your API key as an environment variable
export FLUENCE_API_KEY="your-api-key-here"

API Key Generation

1. Sign up at fluenceinsights.com/signup
2. Verify your email to activate your account
3. Access your dashboard to view API keys
4. Copy the appropriate key for your use case

Status Codes

Code	Name	Summary
200	OK	Everything worked as expected.
400	Bad Request	The request was unacceptable, often due to missing a required parameter.
401	Unauthorized	Invalid API key provided in X-API-Key header
402	Payment Required	You don't have enough credits on your account to perform the request.
404	Not Found	The API didn't find any result for this query.
429	Rate Limit Exceeded	You've exceeded your rate limit. Try again later.
500	Server Error	The request failed due to a server error.

Usage Plans & Quotas

Your API key is assigned to a usage plan that determines your access level and quotas. All usage plans are mapped to the production API.

Available Usage Plans

Plan	Monthly Quota	Rate Limit	Access Level	Allowed Endpoints
CRM-Enterprise-Plan	10,000 requests	100 req/min	All CRM endpoints	/crm_basico, /crm, utility endpoints
CRM-Business-Plan	5,000 requests	100 req/min	All CRM endpoints	/crm_basico, /crm, utility endpoints
Platform-Users-Professional	500 requests	100 req/min	Utility endpoints only	/health, /status, /creditos, /tiers-disponiveis
Platform-Users-Essentials	100 requests	100 req/min	Utility endpoints only	/health, /status, /creditos, /tiers-disponiveis

Tier-Based Access Control

CRM Tiers (Enterprise, Business):

• ✅ Full access to CRM intelligence endpoints
• ✅ All utility endpoints
• ✅ Priority support

Platform Tiers (Professional, Essentials):

• ❌ CRM endpoints blocked (upgrade required)
• ✅ Utility endpoints available
• ✅ Standard support

Rate Limit Best Practices

• Implement exponential backoff for retries
• Monitor your usage in the dashboard
• Upgrade your plan if you consistently hit limits

Tier-Based Access Control

CRM Tiers (Enterprise, Business)

✅ Can access:

• /crm_basico - Basic CRM intelligence (1 credit)
• /crm - Complete CRM intelligence with personality analysis (2 credits)
• All utility endpoints (health, status, credits, tiers)

Platform Tiers (Professional, Essentials)

✅ Can access:

• Analyze endpoints (when available)
• All utility endpoints (health, status, credits, tiers)

❌ Cannot access:

• /crm_basico - Requires CRM tier
• /crm - Requires CRM tier

Access Denied Response

When attempting to access an endpoint not available in your tier:

{
  "error": "Access denied. Your professional tier API key cannot access /crm_basico. Upgrade to CRM tier for access."
}

Credit System

Credit Costs by Endpoint

• CRM Basic (/crm_basico): 1 credit per request
• CRM Complete (/crm): 2 credits per request
• Utility Endpoints (health, status, credits, tiers): Free (0 credits)

Credit Refund Policy

Credits are automatically refunded when:

• ❌ Server errors occur (HTTP 500)
• ❌ Insufficient data found (HTTP 422 with INSUFFICIENT_DATA)
• ❌ Request validation fails (HTTP 400)

Credits are NOT refunded when:

• ✅ Analysis completes successfully (HTTP 200)
• ⚠️ Profile not found (HTTP 404) - search was performed
• ⚠️ Multiple matches found (HTTP 409) - clarification needed

Monitoring Credits

Check your remaining credits using the /creditos endpoint or view them in every API response:

{
  "billing_info": {
    "creditos_utilizados": 1,
    "creditos_restantes": 998,
    "tipo_plano": "enterprise_crm"
  }
}

Programming Examples

Python with Requests

import requests
import os

# Set up authentication
headers = {
    'Content-Type': 'application/json',
    'X-API-Key': os.getenv('FLUENCE_API_KEY')
}

# Make request
response = requests.post(
    'https://api.fluenceinsights.com/crm_basico',
    headers=headers,
    json={
        'primeiro_nome': 'João',
        'ultimo_nome': 'Silva',
        'empresa': 'Microsoft Brasil'
    }
)

if response.status_code == 200:
    result = response.json()
    print(f"Analysis: {result['analise']}")
    print(f"Credits Used: {result['billing_info']['creditos_utilizados']}")
else:
    print(f"Error: {response.status_code} - {response.text}")

JavaScript/Node.js

const axios = require('axios');

const analyzeCRM = async () => {
  try {
    const response = await axios.post(
      'https://api.fluenceinsights.com/crm_basico',
      {
        primeiro_nome: 'Maria',
        ultimo_nome: 'Santos',
        empresa: 'Google Brasil'
      },
      {
        headers: {
          'Content-Type': 'application/json',
          'X-API-Key': process.env.FLUENCE_API_KEY
        }
      }
    );

    const { analise, billing_info } = response.data;
    console.log('Analysis:', analise);
    console.log('Credits Remaining:', billing_info.creditos_restantes);
  } catch (error) {
    console.error('API Error:', error.response?.data || error.message);
  }
};

analyzeCRM();

cURL

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": "Microsoft Brasil"
  }'

Request Parameters

Use a single, simple input method for person matching and analysis:

{
  "primeiro_nome": "João",
  "ultimo_nome": "Silva",
  "empresa": "Microsoft Brasil"
}

Notes:

• Do not send profile URLs. The API does not accept profile URLs as input.
• A public LinkedIn presence is recommended: we automatically compare what we find against public professional profiles to ensure we matched the right person.
• English aliases (first_name, last_name, company) may be available in some environments, but Portuguese parameters are the canonical format.

Access Denied Response Example

When your API key tier doesn't support a specific endpoint:

{
  "error": "Access denied. Your professional tier API key cannot access /crm_basico. Upgrade to CRM tier for access.",
  "error_code": "ACCESS_DENIED",
  "current_tier": "platform_professional",
  "required_tier": "crm_business",
  "upgrade_url": "https://tryfluence.tech/upgrade"
}

Support

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