Skip to main content

​
Getting Started with IntentGPT

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

​
Authentication Setup

  1. Sign up for an account at intentgpt.ai/dashboard
  2. Navigate to the API Keys section
  3. Your API key will be in the format: p1rOh.xxxxxxxxxxxxxxx.xxxxxxxxxxxx
Never expose your API key in client-side code or public repositories. Use environment variables or secure secret management systems to store your API key.
# Example using environment variables
export INTENTGPT_API_KEY="p1rOh.your.api.key"

​
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