Introduction - IntentGPT API

What is IntentGPT?

IntentGPT is a comprehensive B2B intelligence platform that combines intent analysis, lead generation, and customer profiling through a powerful REST API. Our platform helps sales and marketing teams identify high-intent prospects, generate qualified leads, and build targeted customer profiles for more effective outreach.

Intent Analysis

Analyze buyer intent signals across companies, topics, and individual prospects with multi-level intent scoring

Lead Generation

Generate qualified leads with AI-powered targeting based on objectives, domains, topics, and keywords

Customer Intelligence

Build ideal customer profiles (ICP) and analyze person-level intent for precision targeting

System Monitoring

Enterprise-grade health monitoring, authentication testing, and system diagnostics

Popular Integrations

Clay Integration

Power Clay workflows with high-intent leads and real-time prospect data

CRM Sync

Automatically sync qualified leads to Salesforce, HubSpot, and other CRMs

Core Capabilities

🎯 Intent Analysis Engine

Our multi-faceted intent analysis system provides deep insights into buyer behavior:

Company Intent Tracking - Monitor intent signals at the organizational level
Person-Level Analysis - Track individual prospect engagement and interest
Topic-Based Intelligence - Filter intent by specific technologies, solutions, or industries
Intent Scoring - Four-level scoring system (ONFIRE, HOT, WARM, COLD) for prioritization
Reveal Technology - Advanced intent revelation for deeper prospect insights

🚀 AI-Powered Lead Generation

Generate high-quality leads with intelligent targeting:

Objective-Based Generation - Specify clear objectives like “find marketing leaders in SaaS”
Multi-Filter Targeting - Combine domain, topic, and keyword filters for precision
Lead List Management - Create, update, and manage lead lists programmatically
Scalable Output - Generate 1-1000 leads per request based on your needs
Real-Time Processing - Get fresh leads generated on-demand

👥 Customer Profiling & Intelligence

Build detailed customer understanding:

Ideal Customer Profile (ICP) Analysis - Automated ICP generation and refinement
Person List Management - Organize and track individual prospects
Company Intelligence - Deep company analysis with intent correlation
SwipeMagic Integration - Enhanced person discovery and profiling

Getting Started

Get Your API Key

Test Authentication

Verify your setup using our /test-auth endpoint with your API key

Generate Your First Leads

Use the /leadgen endpoint to generate qualified prospects based on your criteria

Analyze Intent Data

Explore intent signals using /intent, /company, and /person endpoints

Build & Scale

Integrate our API into your sales and marketing workflows

API Architecture

Authentication Methods

API Key Authentication - Simple header-based auth with X-API-Key
JWT Bearer Tokens - Clerk-based authentication for web applications
Legacy Support - Backward compatibility for existing integrations

Credit System

5000 Free Credits - Generous starting allocation for new users
Transparent Pricing - Clear credit costs per endpoint and operation
Real-Time Monitoring - Track usage with /api/credits endpoint
Flexible Scaling - Pay-as-you-grow model for businesses of all sizes

Enterprise Features

Health Monitoring - Comprehensive system health checks and diagnostics
CORS Support - Full browser compatibility for web applications
Rate Limiting - Intelligent rate limiting to ensure service quality
Error Handling - Standardized error responses with actionable error codes

Use Cases

Sales Intelligence

# Find high-intent prospects in your target market
curl -X GET "https://api.intentgpt.ai/leadgen" \
  -H "X-API-Key: your_api_key" \
  -G --data-urlencode "objective=find CTOs at Series B SaaS companies showing DevOps intent" \
  --data-urlencode "topic=DevOps" \
  --data-urlencode "limit=100"

Marketing Automation

# Create targeted lead lists for campaigns
curl -X POST "https://api.intentgpt.ai/leadgen/lists" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q1 Marketing Campaign",
    "objective": "find marketing directors showing MarTech intent",
    "topic": "marketing automation",
    "limit": 500
  }'

Intent Monitoring

# Monitor intent signals for target accounts
curl -X GET "https://api.intentgpt.ai/intent" \
  -H "X-API-Key: your_api_key" \
  -G --data-urlencode "companies=salesforce.com,hubspot.com" \
  --data-urlencode "intent_levels=HOT,ONFIRE"

Account-Based Marketing

# Analyze specific company intent patterns
curl -X GET "https://api.intentgpt.ai/company" \
  -H "X-API-Key: your_api_key" \
  -G --data-urlencode "domain=targetcompany.com"

Intent Levels Explained

Our four-tier intent classification system helps you prioritize prospects:

ONFIRE

Immediate buying signals with high conversion potential - ready to engage now

HOT

Strong interest and active evaluation - prime for outreach

WARM

Early stage research and consideration - nurture with content

COLD

Initial awareness or minimal engagement - long-term nurturing

Integration Examples

CRM Synchronization

// Fetch and sync high-intent leads to your CRM
const syncHighIntentLeads = async () => {
  const response = await fetch('https://api.intentgpt.ai/intent', {
    headers: {
      'X-API-Key': process.env.INTENTGPT_API_KEY
    }
  });
  
  const params = new URLSearchParams({
    intent_levels: 'HOT,ONFIRE',
    limit: '100'
  });
  
  const intentData = await response.json();
  
  // Sync to CRM
  await updateCRM(intentData);
};

Lead List Automation

# Automatically generate and manage lead lists
import requests

def create_weekly_lead_list():
    response = requests.post(
        'https://api.intentgpt.ai/leadgen/lists',
        headers={'X-API-Key': 'your_api_key'},
        json={
            'name': f'Weekly Prospects - {datetime.now().strftime("%Y-%m-%d")}',
            'objective': 'find marketing leaders showing MarTech intent',
            'topic': 'marketing automation',
            'domain': 'saas',
            'limit': 200
        }
    )
    
    lead_list = response.json()
    return lead_list['lead_list']['list_id']

Real-Time Intent Monitoring

// Monitor intent changes for key accounts
const monitorKeyAccounts = async (accounts) => {
  const promises = accounts.map(domain => 
    fetch(`https://api.intentgpt.ai/company?domain=${domain}`, {
      headers: { 'X-API-Key': process.env.INTENTGPT_API_KEY }
    })
  );
  
  const results = await Promise.all(promises);
  const intentData = await Promise.all(results.map(r => r.json()));
  
  // Process intent changes and trigger alerts
  processIntentAlerts(intentData);
};

Clay Integration

// Clay webhook integration for lead enrichment
const enrichLeadsWithClay = async (leadList) => {
  // First, generate leads with IntentGPT
  const response = await fetch('https://api.intentgpt.ai/leadgen', {
    method: 'GET',
    headers: { 'X-API-Key': process.env.INTENTGPT_API_KEY }
  });
  
  const params = new URLSearchParams({
    objective: 'find marketing leaders in SaaS companies',
    topic: 'marketing automation',
    limit: '50'
  });
  
  const leads = await response.json();
  
  // Send to Clay for enrichment via webhook
  const clayWebhookUrl = 'https://hooks.clay.com/your-webhook-id';
  
  for (const lead of leads.leads) {
    await fetch(clayWebhookUrl, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        company: lead.company,
        contact_name: lead.name,
        contact_title: lead.title,
        intent_score: lead.intent_score,
        source: 'IntentGPT',
        enrichment_request: true
      })
    });
  }
};

Clay Workflows

IntentGPT integrates seamlessly with Clay to create powerful lead generation and enrichment workflows. Here are proven patterns for combining both platforms:

Pattern 1: Intent-Driven Lead Discovery

Use IntentGPT to find high-intent prospects, then enrich them in Clay:

// Clay HTTP API integration
const intentToClayWorkflow = async () => {
  // 1. Generate high-intent leads from IntentGPT
  const intentResponse = await fetch('https://api.intentgpt.ai/leadgen', {
    method: 'GET',
    headers: { 'X-API-Key': process.env.INTENTGPT_API_KEY }
  });
  
  const params = new URLSearchParams({
    objective: 'find VPs of Sales showing CRM intent',
    topic: 'CRM software',
    intent_levels: 'HOT,ONFIRE',
    limit: '100'
  });
  
  const { leads } = await intentResponse.json();
  
  // 2. Send to Clay for enrichment
  const clayTableId = 'your-clay-table-id';
  
  for (const lead of leads) {
    await fetch(`https://api.clay.com/v1/tables/${clayTableId}/rows`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${process.env.CLAY_API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        'Company': lead.company,
        'Contact Name': lead.name,
        'Title': lead.title,
        'Intent Score': lead.intent_score,
        'Intent Topic': 'CRM software',
        'Lead Source': 'IntentGPT',
        'Lead Generated': new Date().toISOString()
      })
    });
  }
};

Pattern 2: Clay Table to Intent Analysis

Enrich existing Clay prospects with intent data:

// Enrich Clay table with intent scores
const enrichClayWithIntent = async (clayTableId) => {
  // 1. Get companies from Clay table
  const clayResponse = await fetch(`https://api.clay.com/v1/tables/${clayTableId}/rows`, {
    headers: { 'Authorization': `Bearer ${process.env.CLAY_API_KEY}` }
  });
  
  const clayData = await clayResponse.json();
  
  // 2. Analyze intent for each company
  for (const row of clayData.data) {
    const domain = row.fields['Company Domain'];
    
    if (domain) {
      const intentResponse = await fetch(`https://api.intentgpt.ai/company?domain=${domain}`, {
        headers: { 'X-API-Key': process.env.INTENTGPT_API_KEY }
      });
      
      const intentData = await intentResponse.json();
      
      // 3. Update Clay row with intent data
      await fetch(`https://api.clay.com/v1/tables/${clayTableId}/rows/${row.id}`, {
        method: 'PATCH',
        headers: {
          'Authorization': `Bearer ${process.env.CLAY_API_KEY}`,
          'Content-Type': 'application/json'
        },
        body: JSON.stringify({
          'Intent Score': intentData.intent_level,
          'Intent Updated': new Date().toISOString(),
          'Intent Analysis': JSON.stringify(intentData.intent_data)
        })
      });
    }
  }
};

Pattern 3: Automated Lead List Sync

Keep Clay tables synchronized with IntentGPT lead lists:

// Sync IntentGPT lead lists with Clay tables
const syncLeadListToClay = async (listId, clayTableId) => {
  // 1. Get lead list from IntentGPT
  const listResponse = await fetch(`https://api.intentgpt.ai/leadgen/lists?list_id=${listId}`, {
    headers: { 'X-API-Key': process.env.INTENTGPT_API_KEY }
  });
  
  const leadList = await listResponse.json();
  
  // 2. Clear existing Clay table (optional)
  await fetch(`https://api.clay.com/v1/tables/${clayTableId}/rows`, {
    method: 'DELETE',
    headers: { 'Authorization': `Bearer ${process.env.CLAY_API_KEY}` }
  });
  
  // 3. Populate Clay table with fresh leads
  const clayRows = leadList.lead_lists[0].leads.map(lead => ({
    'Company': lead.company,
    'Contact Name': lead.name,
    'Title': lead.title,
    'Email': lead.email,
    'LinkedIn': lead.linkedin,
    'Intent Score': lead.intent_score,
    'List Name': leadList.lead_lists[0].name,
    'Sync Date': new Date().toISOString()
  }));
  
  await fetch(`https://api.clay.com/v1/tables/${clayTableId}/rows/batch`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.CLAY_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ rows: clayRows })
  });
};

Clay Webhook Integration

Set up webhooks to trigger IntentGPT analysis when new prospects are added to Clay:

// Express.js webhook handler
app.post('/clay-webhook', async (req, res) => {
  const { company_domain, contact_name, row_id } = req.body;
  
  if (company_domain) {
    // Analyze intent for the new company
    const intentResponse = await fetch(`https://api.intentgpt.ai/company?domain=${company_domain}`, {
      headers: { 'X-API-Key': process.env.INTENTGPT_API_KEY }
    });
    
    const intentData = await intentResponse.json();
    
    // Update Clay row with intent analysis
    await fetch(`https://api.clay.com/v1/tables/your-table-id/rows/${row_id}`, {
      method: 'PATCH',
      headers: {
        'Authorization': `Bearer ${process.env.CLAY_API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        'Intent Score': intentData.intent_level,
        'Intent Analysis Date': new Date().toISOString(),
        'Buying Signals': intentData.intent_data?.signals?.join(', ') || 'None detected'
      })
    });
  }
  
  res.status(200).json({ success: true });
});

Clay Automation Recipes

Recipe 1: High-Intent Prospect Pipeline

IntentGPT: Generate leads with objective: "find decision makers showing buying intent"
Clay: Enrich with email, phone, social profiles
Clay: Score and prioritize based on company size, industry
Clay: Auto-send to Salesforce/HubSpot as qualified leads

Recipe 2: Account Monitoring Dashboard

Clay: Maintain list of target accounts
IntentGPT: Daily intent score updates via /company endpoint
Clay: Alert when intent score increases to HOT/ONFIRE
Clay: Trigger outreach sequences for high-intent accounts

Recipe 3: Competitor Intelligence

IntentGPT: Track intent for competitor keywords/topics
Clay: Enrich competitor prospects with contact data
Clay: Build targeted lists of companies considering competitors
Clay: Launch win-back or competitive campaigns

Pro Tip: Use IntentGPT’s lead list management features to organize prospects by campaign, then sync specific lists to dedicated Clay tables for different workflows.

Developer Experience

Simple Integration

Our RESTful API follows standard HTTP conventions with predictable endpoints, comprehensive error handling, and detailed documentation for every feature.

Testing & Debugging

Authentication Testing - Verify your setup with /test-auth
Health Monitoring - Check system status with /health
CORS Testing - Validate browser integration with /cors-test

Multiple SDKs

JavaScript/TypeScript - Full-featured SDK with TypeScript support
Python - Native Python integration with async support
REST API - Use with any language that supports HTTP requests

IntentGPT processes millions of intent signals daily to provide the freshest, most actionable B2B intelligence. Our API is built for scale, handling everything from startup growth to enterprise-level integrations.

Ready to Start?

Quick Start Guide

Get up and running in 5 minutes with your first API calls

API Reference

Comprehensive documentation for all endpoints and features

Lead Generation Guide

Learn how to generate and manage qualified leads

System Health

Monitor system health and test your integration

Resources

Developer Community

Join our community of B2B developers and get expert advice

Technical Support

Get help from our technical team and integration specialists

Get Started

​What is IntentGPT?

Intent Analysis

Lead Generation

Customer Intelligence

System Monitoring

​Popular Integrations

Clay Integration

CRM Sync

​Core Capabilities

​🎯 Intent Analysis Engine

​🚀 AI-Powered Lead Generation

​👥 Customer Profiling & Intelligence

​Getting Started

​API Architecture

​Authentication Methods

​Credit System

​Enterprise Features

​Use Cases

​Sales Intelligence

​Marketing Automation

​Intent Monitoring

​Account-Based Marketing

​Intent Levels Explained

ONFIRE

HOT

WARM

COLD

​Integration Examples

​CRM Synchronization

​Lead List Automation

​Real-Time Intent Monitoring

​Clay Integration

​Clay Workflows

​Pattern 1: Intent-Driven Lead Discovery

​Pattern 2: Clay Table to Intent Analysis

​Pattern 3: Automated Lead List Sync

​Clay Webhook Integration

​Clay Automation Recipes

​Recipe 1: High-Intent Prospect Pipeline

​Recipe 2: Account Monitoring Dashboard

​Recipe 3: Competitor Intelligence

​Developer Experience

​Simple Integration

​Testing & Debugging

​Multiple SDKs

​Ready to Start?

Quick Start Guide

API Reference

Lead Generation Guide

System Health

​Resources

Developer Community

Technical Support

What is IntentGPT?

Popular Integrations

Core Capabilities

🎯 Intent Analysis Engine

🚀 AI-Powered Lead Generation

👥 Customer Profiling & Intelligence

Getting Started

API Architecture

Authentication Methods

Credit System

Enterprise Features

Use Cases

Sales Intelligence

Marketing Automation

Intent Monitoring

Account-Based Marketing

Intent Levels Explained

Integration Examples

CRM Synchronization

Lead List Automation

Real-Time Intent Monitoring

Clay Integration

Clay Workflows

Pattern 1: Intent-Driven Lead Discovery

Pattern 2: Clay Table to Intent Analysis

Pattern 3: Automated Lead List Sync

Clay Webhook Integration

Clay Automation Recipes

Recipe 1: High-Intent Prospect Pipeline

Recipe 2: Account Monitoring Dashboard

Recipe 3: Competitor Intelligence

Developer Experience

Simple Integration

Testing & Debugging

Multiple SDKs

Ready to Start?

Resources