Quickstart - IntentGPT API

Getting Started with IntentGPT

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

Authentication Setup

Get your API Key

Sign up for an account at intentgpt.ai/dashboard
Navigate to the API Keys section
Your API key will be in the format: p1rOh.xxxxxxxxxxxxxxx.xxxxxxxxxxxx

API Key Security

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

​Getting Started with IntentGPT

​Authentication Setup

​Making Your First API Call

​Filtering Results

​By Companies

​By Topics

​By Intent Level

​Using with Programming Languages

​JavaScript/Node.js

​Python

​Pagination

​Understanding Intent Levels

​Next Steps