Research Person

Research a person and retrieve detailed professional information including their background, experience, education, and current company details.

Endpoint

POST https://api.kruncher.ai/api/integration/research/person

Request Body

CODE

{
  "fullName": "John Doe",
  "companyName": "Acme Inc",
  "linkedinUrl": "https://linkedin.com/in/johndoe",
  "type": "founder"
}

Fields

Field	Type	Required	Description
`fullName`	string	Yes	The full name of the person to research.
`companyName`	string	Yes	The name of their current or associated company.
`linkedinUrl`	string (URL)	No	LinkedIn profile URL for more accurate matching.
`type`	string	No	Person type classification. Options: `founder`, `investor`, `employee`. Defaults to `founder`.

Code Examples

JavaScript/TypeScript

Basic

CODE

const API_KEY = "YOUR_API_KEY_HERE";
 
const response = await fetch("https://api.kruncher.ai/api/integration/research/person", {
  method: "POST",
  headers: {
    "Authorization": `${API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    fullName: "John Doe",
    companyName: "Acme Inc"
  })
});
 
const result = await response.json();
console.log("Person:", result.data.fullName);
console.log("Role:", result.data.roleInCompany);

Result: Researches a person using name and company. Uses default type founder.

With LinkedIn

CODE

const API_KEY = "YOUR_API_KEY_HERE";
 
const response = await fetch("https://api.kruncher.ai/api/integration/research/person", {
  method: "POST",
  headers: {
    "Authorization": `${API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    fullName: "John Doe",
    companyName: "Acme Inc",
    linkedinUrl: "https://linkedin.com/in/johndoe",
    type: "founder"
  })
});
 
const result = await response.json();
console.log("Person:", result.data.fullName);
console.log("Bio:", result.data.shortBio);
console.log("Company:", result.data.currentCompany.name);

Result: Uses LinkedIn URL for more accurate matching.

With Error Handling

CODE

const API_KEY = "YOUR_API_KEY_HERE";
 
async function researchPerson(personData) {
  try {
    const response = await fetch("https://api.kruncher.ai/api/integration/research/person", {
      method: "POST",
      headers: {
        "Authorization": `${API_KEY}`,
        "Content-Type": "application/json"
      },
      body: JSON.stringify(personData)
    });
 
    if (!response.ok) {
      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
    }
 
    const result = await response.json();
    return result.data;
  } catch (error) {
    console.error("Failed to research person:", error.message);
    throw error;
  }
}
 
const person = await researchPerson({
  fullName: "John Doe",
  companyName: "Acme Inc",
  linkedinUrl: "https://linkedin.com/in/johndoe",
  type: "investor"
});
 
console.log("Role:", person.roleInCompany);
console.log("Skills:", person.skillSummary);
console.log("Experience:", person.pastExperience);

Result: Reusable function with error handling.

Python

Basic

CODE

import requests
 
API_KEY = "YOUR_API_KEY_HERE"
url = "https://api.kruncher.ai/api/integration/research/person"
 
headers = {
    "Authorization": f"{API_KEY}",
    "Content-Type": "application/json"
}
 
data = {
    "fullName": "John Doe",
    "companyName": "Acme Inc"
}
 
response = requests.post(url, headers=headers, json=data)
result = response.json()
 
print(f"Person: {result['data']['fullName']}")
print(f"Role: {result['data']['roleInCompany']}")

Result: Researches a person using name and company.

With LinkedIn

CODE

import requests
 
API_KEY = "YOUR_API_KEY_HERE"
url = "https://api.kruncher.ai/api/integration/research/person"
 
headers = {
    "Authorization": f"{API_KEY}",
    "Content-Type": "application/json"
}
 
data = {
    "fullName": "John Doe",
    "companyName": "Acme Inc",
    "linkedinUrl": "https://linkedin.com/in/johndoe",
    "type": "founder"
}
 
response = requests.post(url, headers=headers, json=data)
result = response.json()
 
person = result["data"]
print(f"Person: {person['fullName']}")
print(f"Bio: {person['shortBio']}")
print(f"Company: {person['currentCompany']['name']}")
print(f"LinkedIn: {person['linkedinUrl']}")

Result: Uses LinkedIn URL for more accurate matching.

With Error Handling

CODE

import requests
from typing import Optional, Dict
 
API_KEY = "YOUR_API_KEY_HERE"
BASE_URL = "https://api.kruncher.ai/api"
 
def research_person(
    full_name: str,
    company_name: str,
    linkedin_url: Optional[str] = None,
    person_type: str = "founder"
) -> Dict:
    headers = {
        "Authorization": f"{API_KEY}",
        "Content-Type": "application/json"
    }
 
    payload = {
        "fullName": full_name,
        "companyName": company_name,
        "type": person_type
    }
 
    if linkedin_url:
        payload["linkedinUrl"] = linkedin_url
 
    try:
        response = requests.post(
            f"{BASE_URL}/integration/research/person",
            headers=headers,
            json=payload
        )
        response.raise_for_status()
        return response.json()["data"]
    except requests.exceptions.HTTPError as e:
        print(f"HTTP Error: {response.status_code} - {response.text}")
        raise
 
# Usage
person = research_person(
    full_name="John Doe",
    company_name="Acme Inc",
    linkedin_url="https://linkedin.com/in/johndoe",
    person_type="investor"
)
 
print(f"Role: {person['roleInCompany']}")
print(f"Skills: {person['skillSummary']}")
print(f"Experience: {person['pastExperience']}")

Result: Reusable function with error handling.

cURL

Basic

CODE

curl -X POST "https://api.kruncher.ai/api/integration/research/person" \
  -H "Authorization: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "fullName": "John Doe",
    "companyName": "Acme Inc"
  }'

With LinkedIn

CODE

curl -X POST "https://api.kruncher.ai/api/integration/research/person" \
  -H "Authorization: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "fullName": "John Doe",
    "companyName": "Acme Inc",
    "linkedinUrl": "https://linkedin.com/in/johndoe",
    "type": "founder"
  }'

Investor Type

CODE

curl -X POST "https://api.kruncher.ai/api/integration/research/person" \
  -H "Authorization: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "fullName": "Jane Smith",
    "companyName": "Venture Capital Partners",
    "type": "investor"
  }'

Response Structure

Success Response

CODE

{
  "metadata": {
    "code": "1000",
    "title": "Successful"
  },
  "data": {
    "fullName": "John Doe",
    "name": "John",
    "surname": "Doe",
    "type": "founder",
    "profileImage": "https://...",
    "shortBio": "Serial entrepreneur with 15+ years experience...",
    "description": "Detailed professional description...",
    "roleInCompany": "CEO & Co-Founder",
    "linkedinUrl": "https://linkedin.com/in/johndoe",
    "linkedinFollowers": 5000,
    "linkedinConnection": 500,
    "emailAddress": "john@acme.com",
    "city": "San Francisco",
    "country": "United States",
    "countryCode": "US",
    "pastExperience": [
      {
        "role": "CTO",
        "company": "Previous Corp",
        "startDate": "2015-01",
        "endDate": "2020-06"
      }
    ],
    "education": [
      {
        "degree": "MBA",
        "school": "Stanford University",
        "year": "2014"
      }
    ],
    "highlights": ["Forbes 30 Under 30", "Y Combinator Alumni"],
    "tags": ["SaaS", "AI", "Enterprise"],
    "skillSummary": "Product strategy, fundraising, team building...",
    "currentCompany": {
      "role": "CEO",
      "name": "Acme Inc",
      "logo": "https://...",
      "website_url": "https://acme.com",
      "startDate": "2020-07",
      "endDate": null
    }
  }
}

Response Fields

Person Data

Field	Type	Description
`fullName`	string	Full name of the person
`name`	string	First name
`surname`	string	Last name
`type`	string	Person type (`founder`, `investor`, `employee`)
`profileImage`	string	Profile photo URL
`shortBio`	string	Brief biography
`description`	string	Detailed professional description
`roleInCompany`	string	Current role/title
`linkedinUrl`	string	LinkedIn profile URL
`linkedinFollowers`	number	LinkedIn follower count
`linkedinConnection`	number	LinkedIn connection count
`emailAddress`	string	Contact email
`city`	string	City of residence
`country`	string	Country name
`countryCode`	string	ISO country code
`pastExperience`	array	Previous work experience
`education`	array	Educational background
`highlights`	array	Key achievements
`tags`	array	Relevant tags/keywords
`skillSummary`	string	Summary of professional skills
`currentCompany`	object	Current company details

Current Company Object

Field	Type	Description
`role`	string	Role at the company
`name`	string	Company name
`logo`	string	Company logo URL
`website_url`	string	Company website
`startDate`	string	Start date at company
`endDate`	string \| null	End date (null if current)

Credits

This endpoint costs 0.2 credits per new person researched. Cached results are returned for free if the person was previously researched.