​
Getting Started with IntentGPT

Follow these steps to start accessing B2B intent data through our API.

​
Authentication Setup

​
Making Your First API Call

Here’s a simple example to get you started: 
curl -X GET "https://api.intentgpt.ai/intent" \
-H "x-api-key: your_api_key"
This will return intent data for all companies and topics within the default limits.

​
Filtering Results

​
By Companies

curl -X GET "https://api.intentgpt.ai/intent" \
-H "x-api-key: your_api_key" \
-G --data-urlencode "companies=salesforce.com,oracle.com"

​
By Topics

curl -X GET "https://api.intentgpt.ai/intent" \
-H "x-api-key: your_api_key" \
-G --data-urlencode "topics=marketing"

​
By Intent Level

curl -X GET "https://api.intentgpt.ai/intent" \
-H "x-api-key: your_api_key" \
-G --data-urlencode "intent_levels=HOT"

​
Using with Programming Languages

​
JavaScript/Node.js

const axios = require('axios');

async function getIntent() {
  try {
    const response = await axios.get('https://api.intentgpt.ai/intent', {
      headers: {
        'x-api-key': 'your_api_key'
      },
      params: {
        companies: 'salesforce.com,oracle.com',
        topics: 'marketing',
        intent_levels: 'HOT'
      }
    });
    
    console.log(response.data);
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
}

​
Python

import requests

def get_intent():
    headers = {
        'x-api-key': 'your_api_key'
    }
    
    params = {
        'companies': 'salesforce.com,oracle.com',
        'topics': 'marketing',
        'intent_levels': 'HOT'
    }
    
    response = requests.get(
        'https://api.intentgpt.ai/intent',
        headers=headers,
        params=params
    )
    
    return response.json()

​
Pagination

For large datasets, use the offset parameter: 
curl -X GET "https://api.intentgpt.ai/intent" \
-H "x-api-key: your_api_key" \
-G --data-urlencode "offset=100"

​
Understanding Intent Levels

Our API uses four intent levels to categorize B2B signals:
  • ONFIRE: Highest intent level - immediate buying signals
  • HOT: Strong interest and engagement
  • WARM: Moderate interest
  • COLD: Minimal or early-stage interest

​
Next Steps

API Reference

Explore our complete API documentation

Use Cases

Learn how others are using intent data

Best Practices

Optimize your API usage

Support

Get help from our developer community