> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intentgpt.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get started with IntentGPT B2B Intent API in minutes

## Getting Started with IntentGPT

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

### Authentication Setup

<AccordionGroup>
  <Accordion icon="key" title="Get your API Key">
    1. Sign up for an account at [intentgpt.ai/dashboard](https://intentgpt.ai/dashboard)
    2. Navigate to the API Keys section
    3. Your API key will be in the format: `p1rOh.xxxxxxxxxxxxxxx.xxxxxxxxxxxx`
  </Accordion>

  <Accordion icon="shield" title="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.

    ```bash theme={null}
    # Example using environment variables
    export INTENTGPT_API_KEY="p1rOh.your.api.key"
    ```
  </Accordion>
</AccordionGroup>

### Making Your First API Call

Here's a simple example to get you started:

```bash theme={null}
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

```bash theme={null}
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

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

#### By Intent Level

```bash theme={null}
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

```javascript theme={null}
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

```python theme={null}
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:

```bash theme={null}
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

<CardGroup>
  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Explore our complete API documentation
  </Card>

  <Card title="Use Cases" icon="lightbulb" href="/essentials/code">
    Learn how others are using intent data
  </Card>

  <Card title="Best Practices" icon="star" href="/essentials/markdown">
    Optimize your API usage
  </Card>

  <Card title="Support" icon="users" href="https://community.intentgpt.ai">
    Get help from our developer community
  </Card>
</CardGroup>