​
Overview

The IntentGPT B2B Intent API provides powerful intent analysis capabilities for B2B companies. Our API enables you to analyze and track intent signals across companies and topics.

​
Base URL

All API requests should be made to:

https://api.intentgpt.ai

​
Authentication

All API requests require authentication using an API key in the header:

x-api-key: your_api_key_here

Never share your API key or commit it to version control. API keys follow the format: p1rOh.xxxxxxxxxxxxxxx.xxxxxxxxxxxx

​
Rate Limits

The API provides unlimited calls with responses limited to top 1000 rows.

​
Intent Endpoint

​
GET /intent

Retrieve intent data for specified companies and topics.

​
Example Request

curl -X GET "https://api.intentgpt.ai/intent" \
-H "x-api-key: your_api_key"

​
Optional Parameters

ParameterTypeDescription
offsetintegerStarting point for returned rows, useful for pagination
companiesstringComma-separated list of company domains (e.g., “salesforce.com,oracle.com”)
topicsstringOne or more topics to filter intent data (e.g., “marketing”, “sales”)
intent_levelsstringFilter by intent level: ONFIRE, HOT, WARM, COLD

​
Example Requests with Parameters

Basic Request with Offset:

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

Filter by Companies:

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

Filter by Topics:

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

Filter by Intent Levels:

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

Combined Filters Example:

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

​
Intent Levels

The API uses four levels of intent:

LevelDescription
ONFIREHighest intent level indicating immediate interest
HOTStrong intent signals
WARMModerate intent signals
COLDLow or minimal intent signals

​
Error Handling

The API uses conventional HTTP response codes:

  • 2xx - Success
  • 4xx - Client errors (invalid API key, malformed request)
  • 5xx - Server errors

​
SDKs and Libraries

While you can use the API directly with HTTP requests, we also provide official SDKs:

​
Support

Need help? Contact our support team:

Looking to process more than 1000 rows? Contact our sales team at sales@intentgpt.ai to discuss enterprise options.