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()
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
