Person Intelligence API

Overview

The Person Intelligence API provides GTM-focused insights into individual prospects, including lead scoring, buying signals, pain points, and competitive intelligence. Perfect for sales prospecting and account-based marketing.

Endpoint

GET /person

Authentication

Use the Authorization header with your API key:

Authorization: Bearer YOUR_API_KEY

Query Parameters

string

LinkedIn profile URL or username.Example: linkedin=john-doe-123

string

Email address of the person.Example: email=john@acme.com

profile

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

deep_research

boolean

default:"false"

Returns detailed verbose analysis instead of GTM format.Example: deep_research=true

Either linkedin or email is required to identify the person.

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 Requests

curl -X GET "https://api.intentgpt.ai/person?linkedin=suman-chakraborty" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Format

GTM Response (Default)

The default response is optimized for sales and marketing teams:

{
  "person_gtm": {
    "lead_score": 8,
    "priority": "Hot",
    "contact_info": {
      "name": "Suman Chakraborty",
      "title": "Senior Manager Human Resources",
      "company": "PricewaterhouseCoopers LLP",
      "decision_power": "Medium"
    },
    "buying_signals": {
      "stage": "Consideration",
      "key_indicators": [
        "Researching enterprise asset management solutions",
        "Evaluating data visualization tools like Tableau",
        "Investigating AI and predictive modeling platforms"
      ]
    },
    "pain_points": [
      {
        "area": "System Integration & Modernization",
        "urgency": "High",
        "business_impact": "Complex systems causing operational inefficiencies"
      },
      {
        "area": "Data-Driven Decision Making",
        "urgency": "High",
        "business_impact": "Lack of strategic insights limiting competitive advantage"
      }
    ],
    "competitive_context": {
      "current_vendors": ["Tableau", "IFS Ultimo", "Procore"],
      "evaluation_focus": [
        "Integration capabilities",
        "Total cost of ownership",
        "Functionality for complex operations"
      ],
      "switching_likelihood": "High"
    },
    "generated_at": 1737750234
  }
}

Response Fields

person_gtm

object

GTM-focused person intelligence data

Show Person GTM Object

lead_score

integer

Lead qualification score from 1-10 based on role, intent signals, and buying power

priority

string

Priority classification: “Hot” (ready to buy), “Warm” (evaluating), or “Cold” (early research)

contact_info

object

Contact details and decision-making power assessment

Show Contact Info

name

string

Person’s name

title

string

Job title

company

string

Company name

decision_power

string

Decision-making influence: “High”, “Medium”, “Low”, or “Unknown”

buying_signals

object

Current buying stage and key indicators

Show Buying Signals

stage

string

Buying stage: “Awareness”, “Consideration”, “Decision”, or “Implementation”

key_indicators

array

Up to 5 specific research activities and behaviors

pain_points

array

Maximum 3 prioritized challenges with urgency and business impact

competitive_context

object

Current vendors, evaluation focus, and switching likelihood

Alternative Endpoints

Explicit GTM Endpoint

For guaranteed GTM format responses:

GET /person-gtm?linkedin=john-doe

Verbose Analysis

For detailed research and analysis:

GET /person?linkedin=john-doe&deep_research=true

Response Size Comparison

Format	Size	Structure	Use Case
GTM (Default)	~1.5KB	2 levels deep	Lead qualification, prospecting
Verbose	~8KB	4-5 levels deep	Strategic research, detailed analysis

Lead Scoring

The lead_score (1-10) is calculated based on:

Role & Title: Decision-making authority and relevance
Intent Signals: Research activities and buying behaviors
Company Context: Organization size and technology maturity
Buying Stage: Current position in the purchase journey

Score	Priority	Description
8-10	Hot	High-value prospect with strong buying signals
5-7	Warm	Qualified lead worth nurturing
1-4	Cold	Early-stage prospect requiring education

Buying Stages

Stage	Description	Typical Activities
Awareness	Identifying problems and researching solutions	Reading articles, attending webinars
Consideration	Evaluating specific vendors and solutions	Comparing features, requesting demos
Decision	Final vendor selection and procurement	Contract negotiations, ROI analysis
Implementation	Deployment and rollout planning	Technical evaluations, pilot programs

Error Responses

{
  "error": "Missing required parameters: either email or linkedin is required"
}

{
  "error": "Unable to analyze person data"
}

Best Practices

1. Use for Lead Qualification

The GTM format is optimized for:

CRM lead scoring
Sales automation workflows
Account-based marketing
Prospecting prioritization

2. Combine with Company Intelligence

Use both endpoints together for complete account intelligence:

# Get company context
GET /company?website=target-company.com

# Get person intelligence
GET /person?email=prospect@target-company.com

3. Cache Responses

Person insights should be cached for 12-24 hours for optimal performance.

4. Focus on High-Score Leads

Prioritize outreach to leads with scores 7+ for highest conversion rates.

Rate Limits

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

The GTM format provides 80% size reduction while maintaining all critical sales intelligence, delivering immediate actionable insights for prospect qualification and outreach prioritization.

API Documentation

Core Endpoints

Overview

Endpoint

Authentication

Query Parameters

Auto-Profile Detection

Example Requests

Response Format

GTM Response (Default)

Response Fields

Alternative Endpoints

Explicit GTM Endpoint

Verbose Analysis

Response Size Comparison

Lead Scoring

Buying Stages

Error Responses

Best Practices

1. Use for Lead Qualification

2. Combine with Company Intelligence

3. Cache Responses

4. Focus on High-Score Leads

Rate Limits

API Documentation

Core Endpoints

​Overview

​Endpoint

​Authentication

​Query Parameters

​Auto-Profile Detection

​Example Requests

​Response Format

​GTM Response (Default)

​Response Fields

​Alternative Endpoints

​Explicit GTM Endpoint

​Verbose Analysis

​Response Size Comparison

​Lead Scoring

​Buying Stages

​Error Responses

​Best Practices

​1. Use for Lead Qualification

​2. Combine with Company Intelligence

​3. Cache Responses

​4. Focus on High-Score Leads

​Rate Limits

Overview

Endpoint

Authentication

Query Parameters

Auto-Profile Detection

Example Requests

Response Format

GTM Response (Default)

Response Fields

Alternative Endpoints

Explicit GTM Endpoint

Verbose Analysis

Response Size Comparison

Lead Scoring

Buying Stages

Error Responses

Best Practices

1. Use for Lead Qualification

2. Combine with Company Intelligence

3. Cache Responses

4. Focus on High-Score Leads

Rate Limits