Examples: Search API
Examples for using Crunchbase's Search API endpoints
Below are a few common examples of using the Search API endpoints to help you request data for multiple entities & filter that data through various search criteria.
Key Reminder
- Search API calls must have a request body
- "field_ids" and "query" are both required parameters to have in the request body
- all other parameters are optional in the request body
- "Query" Supports "AND" Only
Example 1: find funding rounds since 2012 that have 4+ investors & raised $10M+ USD
POST https://api.crunchbase.com/api/v4/searches/funding_rounds?user_key=INSERT_KEY_HERE
--Body Request--
{
"field_ids": [
"identifier",
"announced_on",
"funded_organization_identifier",
"money_raised",
"investment_type"
],
"order": [
{
"field_id": "announced_on",
"sort": "asc"
}
],
"query": [
{
"type": "predicate",
"field_id": "announced_on",
"operator_id": "gte",
"values": ["2012"]
},
{
"type": "predicate",
"field_id": "num_investors",
"operator_id": "lte",
"values": ["4"]
},
{
"type": "predicate",
"field_id": "money_raised",
"operator_id": "gte",
"values": [
{"value": 10000000, "currency": "usd"}
]
}
]
}
Example 2: find companies in Europe w/ $25M-$100M USD in funding
POST https://api.crunchbase.com/api/v4/searches/organizations?user_key=INSERT_KEY_HERE
--Body Request--
{
"field_ids": [
"identifier",
"categories",
"location_identifiers",
"short_description",
"rank_org_company"
],
"order": [
{
"field_id": "rank_org_company",
"sort": "asc"
}
],
"query": [
{
"type": "predicate",
"field_id": "funding_total",
"operator_id": "between",
"values": [
{
"value": 25000000,
"currency": "usd"
},
{
"value": 100000000,
"currency": "usd"
}
]
},
{
"type": "predicate",
"field_id": "location_identifiers",
"operator_id": "includes",
"values": [
"6106f5dc-823e-5da8-40d7-51612c0b2c4e"
]
},
{
"type": "predicate",
"field_id": "facet_ids",
"operator_id": "includes",
"values": [
"company"
]
}
]
}
Example 3: find Biotech companies w/ 101-250 number of employees
POST https://api.crunchbase.com/api/v4/searches/organizations?user_key=INSERT_KEY_HERE
--Body Request--
{
"field_ids": [
"identifier",
"categories",
"location_identifiers",
"short_description",
"rank_org_company"
],
"order": [
{
"field_id": "rank_org_company",
"sort": "asc"
}
],
"query": [
{
"type": "predicate",
"field_id": "num_employees_enum",
"operator_id": "includes",
"values": [
"c_00101_00250"
]
},
{
"type": "predicate",
"field_id": "categories",
"operator_id": "includes",
"values": [
"58842728-7ab9-5bd1-bb67-e8e55f6520a0"
]
}
]
}
Example 4: find companies across multiple categories that have either "101-250" or "501-1000" number of employees (using "Includes Any" search operator)
POST https://api.crunchbase.com/api/v4/searches/organizations?user_key=INSERT_KEY_HERE
--Body Request--
{
"field_ids": [
"identifier",
"categories",
"location_identifiers",
"short_description",
"rank_org_company"
],
"query": [
{
"type": "predicate",
"field_id": "num_employees_enum",
"operator_id": "includes",
"values": [
"c_00101_00250",
"c_00501_01000"
]
},
{
"type": "predicate",
"field_id": "categories",
"operator_id": "includes",
"values": [
"b8ca872c-983d-f8dd-3639-2660511203ef",
"3f21415b-5784-6be6-3722-eb189190b7cd",
"275ddcbc-27de-ff4f-4e50-6dc26ebf9570"
]
}
]
}
Updated almost 4 years ago
What’s Next