# Crunchbase Search

## Overview

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

## Description

Search Crunchbase for companies and people by keyword and retrieve their profiles and Crunchbase identifiers.

## 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/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search by keyword 'openai'

```json
{
  "results": [
    {
      "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",
      "type": "organization",
      "uuid": "cf2c678c-b81a-80c3-10d1-9c5e76448e51",
      "image_id": "jjykwqqhsscreywea4gb",
      "permalink": "openai",
      "description": "OpenAI is an AI research and deployment company that develops advanced AI models, including ChatGPT."
    },
    {
      "logo": "https://images.crunchbase.com/image/upload/c_pad,h_45,w_45,f_auto,b_white,q_auto:eco,dpr_1/zrafm9hariyl22gfnzkq",
      "name": "OpenAi",
      "type": "organization",
      "uuid": "30658435-66e6-4d4a-bcce-5ac474713ef1",
      "image_id": "zrafm9hariyl22gfnzkq",
      "permalink": "openai-3ef1",
      "description": "OpenAi provides solutions for artificial intelligence and social media management."
    },
    {
      "logo": "https://images.crunchbase.com/image/upload/c_pad,h_45,w_45,f_auto,b_white,q_auto:eco,dpr_1/bt82qrftpaedzlqqthgi",
      "name": "OpenAirlines",
      "type": "organization",
      "uuid": "d24dda07-4d9a-43b3-9727-75efca750551",
      "image_id": "bt82qrftpaedzlqqthgi",
      "permalink": "openairlines",
      "description": "OpenAirlines is a needs of airlines to optimize their flight operations and reduce their costs."
    },
    {
      "logo": null,
      "name": "Senior Researcher OpenAI",
      "type": "person",
      "uuid": "2f102504-1e57-44ea-b4a4-21c3b26578ca",
      "image_id": null,
      "job_title": null,
      "permalink": "senior-researcher-openai",
      "organization": null
    },
    {
      "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",
      "type": "person",
      "uuid": "d3326bcc-6d25-9214-60c7-1e95c5f2f2a1",
      "image_id": "hevy6dvk7gien0rmg37n",
      "job_title": "CEO",
      "permalink": "elon-musk",
      "organization": "Tesla"
    }
  ]
}
```

### Search by keyword 'anthropic'

```json
{
  "results": [
    {
      "logo": "https://images.crunchbase.com/image/upload/c_pad,h_45,w_45,f_auto,b_white,q_auto:eco,dpr_1/02bb58922b3d4d64b082982f275896c8",
      "name": "Anthropic",
      "type": "organization",
      "uuid": "e10aaff2-4d89-46d4-820b-b4f64b8d42ca",
      "image_id": "02bb58922b3d4d64b082982f275896c8",
      "permalink": "anthropic",
      "description": "Anthropic is an AI safety and research company that builds reliable, interpretable, and steerable AI systems."
    },
    {
      "logo": "https://images.crunchbase.com/image/upload/c_pad,h_45,w_45,f_auto,b_white,q_auto:eco,dpr_1/f81rsob2ck3tunenbfob",
      "name": "Anthropics Technology",
      "type": "organization",
      "uuid": "da1f2be8-af77-4cc2-8ce4-245fc03bfc8c",
      "image_id": "f81rsob2ck3tunenbfob",
      "permalink": "anthropics-technology",
      "description": "Anthropics Technology is a research and development company that has created Zyler, virtual clothing try-on technology."
    },
    {
      "logo": "https://images.crunchbase.com/image/upload/c_pad,h_45,w_45,f_auto,b_white,q_auto:eco,dpr_1/e1ccd0271e574b03ae964e78918f7882",
      "name": "Radium",
      "type": "organization",
      "uuid": "e332e73c-12c6-40f1-a983-484197dbd11f",
      "image_id": "e1ccd0271e574b03ae964e78918f7882",
      "permalink": "radium-d11f",
      "description": "Radium is a swap-in OpenAI / Anthropic -compatible inference platform: faster, lower cost, enterprise-ready."
    },
    {
      "logo": "https://images.crunchbase.com/image/upload/c_pad,h_45,w_45,f_auto,b_white,q_auto:eco,dpr_1/xmyicftkqrvovfpetq8s",
      "name": "Alexander Berend",
      "type": "person",
      "uuid": "febfa7ff-af67-4162-86bf-bbd9689ff9fe",
      "image_id": "xmyicftkqrvovfpetq8s",
      "job_title": null,
      "permalink": "alexander-berend",
      "organization": null
    },
    {
      "logo": null,
      "name": "Andrew Berend,",
      "type": "person",
      "uuid": "e472ce87-5cf4-4b5a-9616-312d200e84f9",
      "image_id": null,
      "job_title": "Executive Chairman",
      "permalink": "andrew-berend",
      "organization": "Anthropics Technology"
    }
  ]
}
```

## Documentation

## Overview
Search Crunchbase for companies, organizations, and people using free-text keywords. Returns a mixed list of matching entities with their type, name, description, UUID, and Crunchbase permalink: enabling quick entity discovery and disambiguation.

## Quickstart
```
GET https://api.piloterr.com/v2/crunchbase/search?query=openai
GET https://api.piloterr.com/v2/crunchbase/search?query=elon
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Free-text keyword or phrase to search on Crunchbase |

## Response fields
| Field | Type | Description |
|---|---|---|
| `results[].uuid` | string | Unique Crunchbase identifier |
| `results[].name` | string | Name of the entity (company or person) |
| `results[].type` | string | Entity type: `organization` or `person` |
| `results[].permalink` | string | Crunchbase permalink slug |
| `results[].logo` | string\|null | Logo or profile image URL |
| `results[].image_id` | string\|null | Image identifier |
| `results[].description` | string\|null | Short description (for organizations) |
| `results[].job_title` | string\|null | Job title (for people only) |
| `results[].organization` | string\|null | Current organization (for people only) |

## Notes
- Results include both `organization` and `person` types in a single mixed array.
- Use the `type` field to filter results by entity type in your application.
- The `permalink` can be passed directly to `crunchbase/company/info` or `crunchbase/people/info` for full profile retrieval.

## Main use cases
- Resolve and validate company or person identities on Crunchbase before fetching full profiles
- Build entity autocomplete features in internal tools using Crunchbase as a name resolution layer
- Discover Crunchbase permalinks for companies or investors to use in downstream API calls
- Power lead enrichment workflows by searching for prospect names and mapping them to Crunchbase profiles