Behavioral Inference API - Complete Documentation

The Behavioral Inference API provides AI-powered personality analysis and buyer insights from public professional profiles. The API supports both individual and batch processing with a single, simple input method: name + company (no profile URLs).

Overview

The Fluence API is a comprehensive behavioral analysis platform that enables you to:

• 🚀 Batch Processing - Analyze up to 10 profiles concurrently in a single request
• 🌍 Simple Inputs - Name + company only (no profile URLs)
• 🧠 Advanced Behavioral Analysis - OCEAN personality scores, MBTI assessment, and buyer personas
• 🇧🇷 Brazil-Specific Market Intelligence - LGPD compliance, regional insights, and local business context
• 📊 Tiered Analysis Options - Basic, Complete, and Premium analysis levels
• 🔗 Chrome Extension Integration - Lightweight analysis for browser workflows
• 💰 Pay-per-Success Billing - Only charged for successfully analyzed profiles
• 💼 Enterprise-Ready - Credit-based billing, transparent pricing, and comprehensive analytics

Multi-Language Support

Language	Primary Use Case	Specialized Features
Portuguese	Brazilian market analysis	LGPD compliance, regional business context, localized insights
English	Global business intelligence	Comprehensive behavioral analysis, buyer playbooks

Analysis Tiers

Choose the right analysis depth for your use case:

Tier	API Calls	Credits	Best For	Key Features
Basic	1 (Profile only)	1	Lead qualification	OCEAN scores, MBTI, basic insights
Standard	2 (Profile + Posts)	1-2	Sales preparation	+ Communication style, working preferences
Premium	2 (Profile + Posts + ML)	2	High-value prospects	+ Buyer playbooks, trigger phrases, enhanced analysis

Base URLs

Environment	Base URL	Status
Production	https://a7qq5h74ej.execute-api.us-west-2.amazonaws.com/production	✅ Active
Development	https://nwa2joi3xi.execute-api.us-west-2.amazonaws.com/dev	✅ Active
Custom Domain	https://api.fluenceinsights.com	✅ Recommended

Authentication

All API requests must include your API key in the request header:

x-api-key: your-api-key-here

Example:

curl -X POST https://api.fluenceinsights.com/crm \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"primeiro_nome": "Satya", "empresa": "Microsoft"}'

Learn more about authentication →

🚀 Quick Start

1. Get Your API Key

Contact support@tryfluence.tech for immediate access to production API keys.

2. Choose Your Endpoint

Endpoint Type	Credits	Tier Required	Best For
Basic Analysis	1	Basic/Complete	Lead qualification
Complete Analysis	2	Complete	Full behavioral insights
Premium Analysis	3	Complete	Enhanced with AI insights
Batch Processing	1-2/profile	Basic/Complete	Multiple profiles (up to 10)

3. Test Live

Single Profile - Name + Company

curl -X POST "https://api.fluenceinsights.com/crm" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key-here" \
  -d '{
    "primeiro_nome": "Satya",
    "ultimo_nome": "Nadella",
    "empresa": "Microsoft"
  }'

Batch Processing (Up to 10 Profiles)

curl -X POST "https://api.fluenceinsights.com/crm_batch" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key-here" \
  -d '{
    "profiles": [
      {"primeiro_nome": "Satya", "ultimo_nome": "Nadella", "empresa": "Microsoft"},
      {"primeiro_nome": "Sundar", "ultimo_nome": "Pichai", "empresa": "Google"}
    ]
  }'

Available Endpoints

🔐 Authentication

Section	Description
Authentication Guide	API key setup, billing, and security

📊 Single Profile Endpoints

Process individual profiles with name + company parameters only.

Endpoint	Method	Credits	Features	Description
/crm_basico	POST	1	6 core fields	Essential lead qualification
/crm	POST	2	11+ fields, OCEAN, MBTI	Complete behavioral analysis
/crm_plus	POST	3	12+ fields, AI insights	Premium with market intelligence

🚀 Batch Processing Endpoints

Process multiple profiles concurrently - pay only for successful analyses.

Endpoint	Method	Credits	Max Profiles	Description
/crm_basico_batch	POST	1 × success	50	Bulk lead qualification
/crm_batch	POST	2 × success	50	Bulk behavioral analysis
/crm_plus_batch	POST	3 × success	50	Bulk premium insights

🔧 Utility Endpoints

Endpoint	Method	Description	Credits	Authentication
/saude	GET	Health check (Portuguese)	0	Optional
/status	GET	API operational status	0	Optional
/creditos	GET	Check remaining credits	0	Required
/tiers-disponiveis	GET	Available plans and pricing	0	Optional

❌ Error Handling

Section	Description
Error Handling Guide	Comprehensive error codes and troubleshooting

Enhanced Error Handling

Our API provides detailed error responses with actionable feedback:

HTTP Status Codes

Code	Status	Description
200	OK	Request successful
400	Bad Request	Invalid request parameters or validation errors
401	Unauthorized	Invalid or missing API key
404	Not Found	Profile not found after comprehensive search
409	Conflict	Person confirmation required (multiple matches)
422	Unprocessable Entity	Insufficient digital footprint for analysis
429	Too Many Requests	Rate limit exceeded or insufficient credits
500	Internal Server Error	Analysis failed due to system error

Enhanced Error Response Format

{
  "success": false,
  "error": {
    "type": "insufficient_digital_footprint",
    "message": "Limited profile data available for comprehensive analysis",
    "user_action": "Consider providing additional context or using a different tier",
    "suggestions": [
      "Verify the person's company information",
  "Check for recent public professional activity",
      "Try searching with alternative company names"
    ],
    "confidence_score": 0.3,
    "can_provide_context": true
  },
  "request": {
    "first_name": "John",
    "last_name": "Doe",
    "company": "Microsoft"
  }
}

Rate Limits & Performance

Rate Limits by Plan

Plan	Requests/Second	Burst Limit	Monthly Quota	Concurrent Requests
Essentials	5 req/sec	10 requests	500 requests	5
Professional	10 req/sec	20 requests	1,000 requests	10
Enterprise	15 req/sec	30 requests	1,000 requests	10

Performance Expectations

Tier	Response Time	Complexity
Basic	2-5 seconds	Profile analysis only
Standard	5-10 seconds	Profile + posts analysis
Premium	10-15 seconds	Full ML analysis + buyer playbooks

Credit System & Optimization

Credit Usage by Endpoint

Endpoint Type	Credits	Optimization Tips
Basic Analysis	1	Use for initial lead qualification
Standard Analysis	1-2	Most business applications
Premium Analysis	2	High-value prospects only
Chrome Extension	1	Batch requests when possible

Cost Optimization Strategies

• Use Portuguese API for Brazilian market (optimized pricing)
• Batch requests when analyzing multiple prospects
• Monitor analytics dashboard for usage patterns
• Consider subscription tiers for high-volume usage

Support & Resources

• 📧 Email Support: support@tryfluence.tech
• 📚 Comprehensive Documentation: Browse the sidebar for detailed endpoint guides
• 🚀 Custom Integrations: Contact us for enterprise features
• 📊 Analytics Dashboard: Monitor usage and performance
• 🔍 API Playground: Test endpoints live →

---

Next Steps

1. Set up authentication → - Get your API key and start testing
2. Try the API playground → - Interactive testing environment
3. Explore CRM endpoints → - Start with basic lead qualification
4. View tier comparison → - Choose the right analysis depth

Important Notes

Real System Configuration

Based on actual API testing, here's what's confirmed:

✅ Available Public Endpoints:

• /crm_basico - CRM Basic intelligence (Portuguese only)
• /crm - CRM Complete intelligence (Complete tier only)
• /analisar - Profile analysis
• /saude - Health check (Portuguese response)
• /status - API status
• /creditos - Check credits and tier info
• /tiers-disponiveis - Available plans (Portuguese response)

🚫 Internal/Restricted Endpoints:

• /analisar-extensao-chrome - Chrome extension only (Complete tier)

Parameter Requirements

Important: Only Portuguese parameters are supported:

• Required: primeiro_nome, ultimo_nome, empresa
• NOT Supported: English parameters or profile URLs
• Language: All responses are in Portuguese

Real Tier System

• Básico (R$ 99/mês): crm_basico, analisar only
• Completo (R$ 299/mês): All endpoints including /crm

Ready to unlock behavioral insights? Start with our Quick Start guide → or jump directly to the API playground →.