# PitchBook Search

## Overview

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

## Description

Search PitchBook for companies, news and profiles by keyword or search URL via browser rendering.

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

## Example Response

### Content search airbus

```json
{
  "results": [
    {
      "url": "https://pitchbook.com/profiles/company/11062-99",
      "type": "profile",
      "image": "https://image.pitchbook.com/example_200x200",
      "title": "Airbus Group",
      "category": "Profile Preview",
      "company_id": "11062-99",
      "description": "Airbus is a global aerospace and defense firm."
    }
  ],
  "pagination": {
    "next": "https://pitchbook.com/search?q=airbus&p=2",
    "page": 1,
    "per_page": 10,
    "total_pages": 4,
    "total_results": 33
  }
}
```

### Profiles search openai

```json
{
  "results": [
    {
      "url": "https://pitchbook.com/profiles/company/149504-14",
      "logo": "https://image.pitchbook.com/example_200x200",
      "type": "company",
      "title": "OpenAI",
      "company_id": "149504-14",
      "profile_id": "149504-14"
    }
  ],
  "pagination": {
    "next": null,
    "page": 1,
    "per_page": 15,
    "total_pages": 1,
    "total_results": 15
  }
}
```

## Documentation

## Overview
Search PitchBook for companies, news, research and profiles. Pass a keyword or a PitchBook search URL.

Two modes:
- Content search: keyword or `/search?q=...` (articles, research, profile preview)
- Profiles search: `/profiles/search?q=...` (companies, investors, funds, advisors)

Browser rendering. Costs **2 credits** per call.

## Quickstart
```
GET https://api.piloterr.com/v2/pitchbook/search?query=airbus
GET https://api.piloterr.com/v2/pitchbook/search?query=https://pitchbook.com/profiles/search?q=openai
GET https://api.piloterr.com/v2/pitchbook/search?query=airbus&page=2
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword or PitchBook search URL |
| `page` | integer | no | Page number for content search |
| `return_page_source` | boolean | no | Return rendered HTML instead of JSON |

## Response fields
| Field | Type | Description |
|---|---|---|
| `results` | array | Search hits |
| `results[].type` | string | `profile`, `article`, `research`, `blog`, `company`, `investor`, … |
| `results[].title` / `url` | string | Title and link |
| `results[].company_id` | string | Present for company profiles |
| `pagination` | object | `page`, `per_page`, `total_results`, `total_pages`, `next` |

Tip: use a company URL or `company_id` with [PitchBook Company Info](https://www.piloterr.com/library/pitchbook-company-info).

## Error codes
| Code | Meaning |
|---|---|
| `400` | Empty or invalid `query` |
| `404` | Page not parseable |
| `500` | Rendering failed |

## Related endpoints
- [PitchBook Company Info](https://www.piloterr.com/library/pitchbook-company-info)