# Crunchbase People Info

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/crunchbase/people/info` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/crunchbase-people-info |

## Description

Retrieve detailed Crunchbase profiles for individuals including career history, investments, and board positions.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/crunchbase/people/info' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup by permalink 'elon-musk'

```json
{
  "logo": "https://images.crunchbase.com/image/upload/c_pad,h_45,w_45,f_auto,b_white,q_auto:eco,dpr_1/hevy6dvk7gien0rmg37n",
  "name": "Elon Musk",
  "uuid": "d3326bcc-6d25-9214-60c7-1e95c5f2f2a1",
  "title": "Elon Musk - Founder, CEO & CTO @ SpaceX",
  "gender": "male",
  "image_id": "hevy6dvk7gien0rmg37n",
  "education": [
    {
      "school": {
        "logo": "https://images.crunchbase.com/image/upload/c_pad,h_45,w_45,f_auto,b_white,q_auto:eco,dpr_1/v1491958662/vzxwledskmxwj0vtbqgs.png",
        "name": "University of Pennsylvania",
        "uuid": "e72aab01-fbef-7d21-ac1d-84ee1413fddd",
        "permalink": "university-of-pennsylvania"
      },
      "started_on": null,
      "degree_name": null,
      "completed_on": null,
      "education_uuid": "a10d1587-43e0-109f-198d-ba1a2724850e"
    }
  ],
  "facet_ids": [
    "investor",
    "rank"
  ],
  "locations": [
    {
      "name": "Hawthorne",
      "type": "city",
      "uuid": "ed19e5bf-bec4-49ef-d87e-5979a1a7c0c8",
      "permalink": "hawthorne-california"
    },
    {
      "name": "California",
      "type": "region",
      "uuid": "eb879a83-c91a-121e-0bb8-829782dbcf04",
      "permalink": "california-united-states"
    },
    {
      "name": "United States",
      "type": "country",
      "uuid": "f110fca2-1055-99f6-996d-011c198b3928",
      "permalink": "united-states"
    }
  ],
  "permalink": "elon-musk",
  "investments": [],
  "past_positions": [
    {
      "title": "CEO",
      "ended_on": {
        "value": "2023-01-01",
        "precision": "year"
      },
      "job_uuid": "73d25b88-2ab4-45a3-abed-51d7f8ead754",
      "started_on": {
        "value": "2022-10-01",
        "precision": "month"
      },
      "organization": {
        "name": "X (formerly Twitter)",
        "uuid": "5da6106f-0d27-0d37-e9d7-dcfeccc1f709",
        "permalink": "twitter"
      }
    },
    {
      "title": "Co-founder",
      "ended_on": {
        "value": "2018-01-01",
        "precision": "year"
      },
      "job_uuid": "a0ec5bed-52e7-4cdb-aff6-a563750bd329",
      "started_on": {
        "value": "2015-12-01",
        "precision": "month"
      },
      "organization": {
        "name": "OpenAI",
        "uuid": "cf2c678c-b81a-80c3-10d1-9c5e76448e51",
        "permalink": "openai"
      }
    }
  ],
  "social_networks": [
    {
      "url": "https://x.com/elonmusk",
      "name": "twitter"
    }
  ],
  "num_current_jobs": 8,
  "current_positions": [
    {
      "title": "Founder, CEO & CTO",
      "job_uuid": "02d4e58e-7e57-a127-2434-f6d2d24ec05a",
      "organization": {
        "logo": "https://images.crunchbase.com/image/upload/c_pad,h_45,w_45,f_auto,b_white,q_auto:eco,dpr_1/u196odmivjn2dvw09xhx",
        "name": "SpaceX",
        "uuid": "2372e88e-240a-a19c-c549-bd262c670ee1",
        "permalink": "space-exploration-technologies"
      }
    },
    {
      "title": "CEO",
      "job_uuid": "d8dbf949-ad81-0ffb-3c02-086f8f0dd626",
      "organization": {
        "logo": "https://images.crunchbase.com/image/upload/c_pad,h_45,w_45,f_auto,b_white,q_auto:eco,dpr_1/dj8rndg9wkqkpgvplvzi",
        "name": "Tesla",
        "uuid": "a367b036-5952-5435-7541-ad7ee8869e24",
        "permalink": "tesla-motors"
      }
    },
    {
      "title": "CEO & Founder",
      "job_uuid": "63539854-3e86-494d-bd0b-6a4c6d5d9899",
      "organization": {
        "logo": "https://images.crunchbase.com/image/upload/c_pad,h_45,w_45,f_auto,b_white,q_auto:eco,dpr_1/fx3dkdpnolvubjldo54x",
        "name": "xAI",
        "uuid": "fb1e8b91-ca1f-46fa-b773-b147af49088c",
        "permalink": "xai"
      }
    }
  ],
  "short_description": "Elon Musk is based out of Hawthorne, California, and is the Founder, Chief Executive Officer, and Chief Technology Officer of SpaceX.",
  "rank_principal_investor": 22124,
  "num_founded_organizations": 8
}
```

### Lookup by Crunchbase URL 'sam-altman'

```json
{
  "logo": "https://images.crunchbase.com/image/upload/c_pad,h_45,w_45,f_auto,b_white,q_auto:eco,dpr_1/eifaoe14zqiueje28oo9",
  "name": "Sam Altman",
  "uuid": "f63055a5-a077-f7ad-2ace-9dbbac22a366",
  "title": "Sam Altman - CEO & Co-Founder @ OpenAI",
  "gender": "male",
  "education": [],
  "facet_ids": [
    "investor",
    "rank"
  ],
  "locations": [
    {
      "name": "San Francisco",
      "type": "city",
      "uuid": "528f5e3c-90d1-1111-5d1c-2e4ff979d58e",
      "permalink": "san-francisco-california"
    },
    {
      "name": "California",
      "type": "region",
      "uuid": "eb879a83-c91a-121e-0bb8-829782dbcf04",
      "permalink": "california-united-states"
    },
    {
      "name": "United States",
      "type": "country",
      "uuid": "f110fca2-1055-99f6-996d-011c198b3928",
      "permalink": "united-states"
    }
  ],
  "permalink": "sam-altman",
  "investments": [],
  "past_positions": [
    {
      "title": "President, YC Group",
      "ended_on": {
        "value": "2019-03-01",
        "precision": "day"
      },
      "job_uuid": "208106cc-cf4e-8d78-d08b-1087f343e1ff",
      "started_on": {
        "value": "2016-01-01",
        "precision": "day"
      },
      "organization": {
        "name": "Y Combinator",
        "uuid": "73633ee4-ea65-2967-6c5d-9b5fec7d2d5e",
        "permalink": "y-combinator"
      }
    }
  ],
  "social_networks": [
    {
      "url": "https://www.x.com/sama",
      "name": "twitter"
    },
    {
      "url": "https://blog.samaltman.com",
      "name": "website"
    }
  ],
  "num_current_jobs": 4,
  "current_positions": [
    {
      "title": "CEO & Co-Founder",
      "job_uuid": "cdec28a8-8885-3021-da37-bff6fb849bdf",
      "organization": {
        "logo": "https://images.crunchbase.com/image/upload/c_pad,h_45,w_45,f_auto,b_white,q_auto:eco,dpr_1/jjykwqqhsscreywea4gb",
        "name": "OpenAI",
        "uuid": "cf2c678c-b81a-80c3-10d1-9c5e76448e51",
        "permalink": "openai"
      }
    }
  ],
  "short_description": "Sam Altman is the CEO and co-founder of OpenAI and also the Partner of Apollo Projects.",
  "rank_principal_investor": 9033,
  "num_founded_organizations": 6
}
```

## Documentation

## Overview
Retrieve detailed public profiles of individuals on Crunchbase, including their current and past positions, education, board memberships, social networks, investment activity, and a press reference timeline. Accepts a person's name, permalink, or full Crunchbase URL.

## Quickstart
```
GET https://api.piloterr.com/v2/crunchbase/people/info?query=elon-musk
GET https://api.piloterr.com/v2/crunchbase/people/info?query=https://www.crunchbase.com/person/sam-altman
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Person's permalink, full name, or Crunchbase URL |

## Response fields
| Field | Type | Description |
|---|---|---|
| `uuid` | string | Unique Crunchbase identifier |
| `name` | string | Full name of the person |
| `logo` | string | Profile image URL |
| `title` | string | Main role title and organization |
| `gender` | string | Gender |
| `permalink` | string | Crunchbase permalink |
| `short_description` | string | Brief biography |
| `locations` | array | City, region, country, continent |
| `current_positions` | array | Active job roles with organization info |
| `past_positions` | array | Previous job roles with dates |
| `current_board_positions` | array | Active board memberships |
| `education` | array | Schools attended with degree info |
| `social_networks` | array | Twitter, LinkedIn, website URLs |
| `investments` | array | Investment records |
| `facet_ids` | array | Crunchbase facet labels (e.g. `investor`, `rank`) |
| `num_current_jobs` | number | Number of current positions |
| `num_founded_organizations` | number | Number of organizations founded |
| `rank_principal_investor` | number | Investor rank on Crunchbase |
| `timeline` | object | Press references and events related to the person |

## Notes
- Both permalink slugs (`elon-musk`) and full Crunchbase URLs are accepted.
- Some fields may be empty arrays or null for people with limited public data.

## Main use cases
- Build investor intelligence databases by pulling profiles of VCs, angels, and founders
- Enrich sales and recruiting pipelines with up-to-date career histories from Crunchbase
- Track board membership changes for portfolio companies or competitors
- Identify key decision-makers at target accounts using their current job titles and organizations