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