> ## 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.

# Company Intelligence API

> Get GTM-focused insights into companies research areas, intent signals, and competitive intelligence

## Overview

The Company Intelligence API provides deep insights into a company's research areas, intent signals, pain points, and competitive context. By default, it returns compact GTM-optimized responses designed for sales and marketing teams.

## Endpoint

```bash theme={null}
GET /company
```

## Authentication

Use the `Authorization` header with your API key:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Query Parameters

<ParamField query="website" type="string" required>
  The domain of the company to be analyzed.

  **Example:** `website=asana.com`
</ParamField>

<ParamField query="profile" type="string">
  Your company domain for contextual analysis. If not provided, automatically uses the domain from your API key's email address.

  **Example:** `profile=salesforce.com`
</ParamField>

<ParamField query="deep_research" type="boolean" default="false">
  Returns detailed verbose analysis instead of GTM format.

  **Example:** `deep_research=true`
</ParamField>

## Auto-Profile Detection

When no `profile` parameter is provided, the API automatically uses the domain from your API key's email address as the default profile for contextual analysis.

**Example:**

* API key email: `sales@acme.com`
* Auto-detected profile: `acme.com`

## Example Requests

<CodeGroup>
  ```bash Basic Request (GTM Format) theme={null}
  curl -X GET "https://api.intentgpt.ai/company?website=asana.com" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```bash With Explicit Profile theme={null}
  curl -X GET "https://api.intentgpt.ai/company?website=asana.com&profile=salesforce.com" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```bash Detailed Analysis theme={null}
  curl -X GET "https://api.intentgpt.ai/company?website=asana.com&deep_research=true" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</CodeGroup>

## Response Format

### GTM Response (Default)

The default response is optimized for sales and marketing teams:

```json theme={null}
{
  "domain": "asana.com",
  "logo": "https://img.logo.dev/asana.com?token=...",
  "gtm_insights": {
    "gtm_score": 8,
    "priority_level": "Hot",
    "summary": "Asana shows strong buying signals for sales enablement and content syndication solutions.",
    "top_opportunities": [
      {
        "area": "Sales Enablement & Content",
        "urgency": "High",
        "signals": [
          "Researching Seismic sales enablement",
          "Content syndication exploration",
          "Customer testimonial needs"
        ]
      }
    ],
    "contact_strategy": {
      "timing": "Immediate",
      "approach": "Lead with ABM + content syndication value prop",
      "stakeholders": ["VP Marketing", "Sales Enablement Manager"],
      "talking_points": [
        "Accelerate sales cycles with compelling case studies",
        "Feed ABM campaigns with high-converting content"
      ]
    },
    "tech_fit": {
      "stack_maturity": "Advanced",
      "key_tools": ["Salesforce Sales Cloud", "6sense", "Marketo"]
    },
    "competitive_context": {
      "status": "Evaluating",
      "window": "Active evaluation phase"
    },
    "generated_at": 1737750234
  }
}
```

### Response Fields

<ResponseField name="domain" type="string">
  The analyzed company domain
</ResponseField>

<ResponseField name="logo" type="string">
  Company logo URL
</ResponseField>

<ResponseField name="gtm_insights" type="object">
  GTM-focused intelligence data

  <Expandable title="GTM Insights Object">
    <ResponseField name="gtm_score" type="integer">
      Sales-readiness score from 1-10
    </ResponseField>

    <ResponseField name="priority_level" type="string">
      Priority classification: "Hot", "Warm", or "Cold"
    </ResponseField>

    <ResponseField name="summary" type="string">
      2-sentence executive summary of the opportunity
    </ResponseField>

    <ResponseField name="top_opportunities" type="array">
      Maximum 3 most promising areas with urgency and signals
    </ResponseField>

    <ResponseField name="contact_strategy" type="object">
      Recommended outreach approach, timing, stakeholders, and talking points
    </ResponseField>

    <ResponseField name="tech_fit" type="object">
      Technology stack maturity and key tools
    </ResponseField>

    <ResponseField name="competitive_context" type="object">
      Evaluation status and competitive window
    </ResponseField>
  </Expandable>
</ResponseField>

## Alternative Endpoints

### Explicit GTM Endpoint

For guaranteed GTM format responses:

```bash theme={null}
GET /company-gtm?website=asana.com
```

### Verbose Analysis

For detailed research and analysis:

```bash theme={null}
GET /company?website=asana.com&deep_research=true
```

## Response Size Comparison

| Format            | Size   | Structure       | Use Case                              |
| ----------------- | ------ | --------------- | ------------------------------------- |
| **GTM (Default)** | \~2KB  | 2 levels deep   | Sales prospecting, CRM integration    |
| **Verbose**       | \~15KB | 4-5 levels deep | Strategic research, detailed analysis |

## Error Responses

<ResponseExample>
  ```json Missing Parameters theme={null}
  {
    "error": "Missing required parameters: Either 'icp_domain' or 'objective' must be provided"
  }
  ```
</ResponseExample>

<ResponseExample>
  ```json No Data Available   theme={null}
  {
    "error": "No intent insights available"
  }
  ```
</ResponseExample>

## Best Practices

### 1. Use Auto-Profile Detection

Let the API automatically detect your company profile:

```bash theme={null}
# Uses email domain automatically
GET /company?website=target-company.com
```

### 2. Cache Responses

Company insights should be cached for 24-48 hours for optimal performance.

### 3. GTM Integration

The compact format is optimized for:

* CRM systems (Salesforce, HubSpot)
* Sales automation platforms
* Lead scoring systems
* Account-based marketing tools

### 4. Error Handling

Always implement retry logic with exponential backoff for 5xx errors.

## Rate Limits

* **Default:** 100 requests per minute per API key
* **Burst:** Up to 20 requests per second

<Note>
  The GTM format provides 90% size reduction while maintaining all critical sales intelligence, making it perfect for real-time sales workflows and automated prospecting systems.
</Note>