Datasets API endpoint
Searches the crawled public PitchBook company profile catalog stored in a search index. Discovered from PitchBook's public sitemap. Sort enum: `relevance`, `name_asc`, `year_founded_desc`, `investor_count_desc`, `recently_crawled_desc`. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).
/datasets/pitchbook-companies/searchSearches the crawled public PitchBook company profile catalog stored in a search index. Discovered from PitchBook's public sitemap — company overview, description, contact/headquarters, industry, financing status, and a preview of investors, acquisitions and subsidiaries. PitchBook gates most numeric figures and full lists behind a paid subscription; those come through as empty cells rather than being fabricated.
Query parameters:
q — full-text query over name and description (max 256 chars).status, primary_industry, financing_status, ownership_status, hq_country, hq_state, run_id — exact-match filters (max 128 chars).min_year_founded, max_year_founded, min_investor_count — numeric filters.sort — one of relevance, name_asc, year_founded_desc, investor_count_desc, recently_crawled_desc. Defaults to relevance with q, otherwise recently_crawled_desc.page (default 1), page_size (default 20, max 100). page * page_size must be ≤ 10000.Each row carries a stable envelope (id, kind, name, description, source_url, crawled_at) plus company-specific rollups (status, employees, year_founded, investor_count, financing_status, ownership_status, primary_industry, other_industries[], verticals[], hq_country/hq_state/hq_city, website) extracted best-effort from the underlying profile — absent, never fabricated, when the source page doesn't have them. The raw overview, contact, tables and faqs blocks (the same shape the live /pitchbook/company endpoint returns) are also included for full fidelity. Returns {dataset, items[], page, page_size, total, sort}. An empty or not-yet-populated dataset returns an empty items list, not an error.
1 credit per record returned, minimum 2. A search that returns 20 records costs 20 credits, a full page of 100 costs 100, and an empty or one-record result costs 2. You are charged for what comes back, not for the page_size you ask for, but your balance must cover the requested page_size for the call to be accepted. The response header x-credit-cost shows what a call was charged.
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| kind | 20 | |
| name | 20 | |
| description | 20 | median 342 characters |
| overview | 20 | |
| contact | 20 | |
| tables | 19 | median 2 entries |
| faqs | 20 | median 7 entries |
| source_url | 20 | pitchbook.com |
| year_founded | 18 | 1,893 to 2,025, median 2,012 |
| hq_country | 20 | |
| hq_state | 13 | |
| hq_city | 20 | |
| status | 20 | |
| latest_deal_type | 19 | |
| ownership_status | 20 | |
| financing_status | 20 | |
| primary_industry | 20 | |
| verticals | 17 | median 2 entries |
| crawled_at | 20 | 2026-09-30 |
| crawled_at_ms | 20 | 2026-09-30 |
| discovery_source | 20 | |
| run_id | 20 | |
| schema_version | 20 | |
| content_hash | 20 | |
| website | 16 | schleich-s.com and 15 other hosts |
| employees | 12 | 1 to 5,000, median 6 |
| investor_count | 11 | 1 to 10, median 2 |
| other_industries | 12 | median 1 entry |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | No | Full-text query over name and description, max 256 characters | ||
| status | string | No | Exact status filter (e.g. Private, Public, Acquired, Out of Business), max 128 characters | ||
| primary_industry | string | No | Exact primary industry filter, max 128 characters | ||
| financing_status | string | No | Exact financing status filter, max 128 characters | ||
| ownership_status | string | No | Exact ownership status filter, max 128 characters | ||
| hq_country | string | No | Exact headquarters country filter, max 128 characters | ||
| hq_state | string | No | Exact headquarters state/region filter, max 128 characters | ||
| run_id | string | No | Exact crawl run-id filter, max 128 characters | ||
| min_year_founded | integer | No | Minimum founding year | ||
| max_year_founded | integer | No | Maximum founding year | ||
| min_investor_count | integer | No | Minimum number of investors | ||
| sort | string | No | Sort enum: relevance, name_asc, year_founded_desc, investor_count_desc, recently_crawled_desc Allowed values: relevance, name_asc, year_founded_desc, investor_count_desc, recently_crawled_desc. | ||
| page | integer | No | 1 | Page number, defaults to 1 | |
| page_size | integer | No | 20 and maxes at 100 | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/datasets/pitchbook-companies/search?q=coffee&sort=relevance&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "pitchbook-companies",
"items": [
{
"id": "752821-12",
"kind": "company",
"name": "Thinking Machines Lab",
"description": "Developer of artificial intelligence systems designed to support the research and development of AI technologies.",
"status": "Private",
"employees": 130,
"year_founded": 2024,
"investor_count": 23,
"financing_status": "Venture Capital-Backed",
"ownership_status": "Privately Held (backing)",
"primary_industry": "Business/Productivity Software",
"hq_country": "United States",
"hq_state": "CA",
"hq_city": "San Francisco",
"website": "http://www.thinkingmachines.ai",
"source_url": "https://pitchbook.com/profiles/company/752821-12",
"crawled_at": "2026-07-20T20:00:00Z"
}
],
"page": 1,
"page_size": 20,
"total": 1,
"sort": "recently_crawled_desc"
}
}Request schema
No body schema
Response schema
#/definitions/datasets.pitchbookCompaniesSearchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | datasets.PitchbookCompaniesSearchResponse | No | ||||
| data.dataset | string | No | ||||
| data.items | array | No | PitchbookRecord record, 54 fields: commitments_count, contact, contact_title, content_hash, crawled_at, crawled_at_ms, description, discovery_source, employees, exits_count, faqs, financing_status and 35 more. Described under Get a PitchBook fund from dataset API. | |||
| data.page | integer | No | ||||
| data.page_size | integer | No | ||||
| data.sort | string | No | ||||
| data.total | integer | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/datasets/pitchbook-companies/search?q=coffee&sort=relevance&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"