Define and Pull Your ICP
With Crunchbase’s Advanced Financials
Persona: GTM
Use Case: Build Target Account List
Primary API: Search (Organizations)
Goal: Build a target account list by using the Organizations Search endpoint to filter companies by ICP criteria and return a list of matching entities for downstream territory mapping, enrichment, or outreach workflows.
Endpoint
https://api.crunchbase.com/v4/data/searches/organizations
API Reference & Documentation
Query
For this example, we’re trying to find companies in the United States that were , founded in the last 10 years and, that have more than 250 employees. We’re looking specifically for companies, in the AI industry, with at least a Series C round of funding.
Key Fields for this Query
| field_id | What this field does | operator_id (these are the compatible operators per field) |
|---|---|---|
| category_groups | Use this to filter for your industry (Software, AI, Manufacturing, etc) | blank;includes;includes_all;not_includes;not_includes_all |
| founded_on | Date field for when the company was founded. Can be used to find companies founded within a date range (2016-2026, for example) | between;blank;eq;gte;lte |
| last_funding_type | The most recent Funding Round excluding debt (Series A, B, C, etc) | blank;eq;includes;not_eq;not_includes |
| location_identifiers | Used to identify the headquarters of the organization | blank;includes;includes_all;not_includes;not_includes_all |
| num_employees_enum | Total number of employees | blank;eq;includes;not_eq;not_includes |
Now that we have the fields defined, here is a sample query that we can run
curl --request POST \
--url https://api.crunchbase.com/v4/data/searches/organizations \
--header 'X-cb-user-key: dac9eef1292e432a8a94XXXXXXXXXXXX' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"field_ids": [
"category_groups",
"founded_on",
"last_equity_funding_type",
"location_identifiers",
"num_employees_enum"
],
"query": [
{
"field_id": "category_groups",
"operator_id": "includes",
"type": "predicate",
"values": [
"artificial-intelligence-e551"
]
},
{
"field_id": "founded_on",
"operator_id": "between",
"type": "predicate",
"values": [
"2016",
"2026"
]
},
{
"field_id": "last_equity_funding_type",
"operator_id": "includes",
"type": "predicate",
"values": [
"series_c"
]
},
{
"field_id": "location_identifiers",
"operator_id": "includes",
"type": "predicate",
"values": [
"united-states"
]
},
{
"field_id": "num_employees_enum",
"operator_id": "includes",
"type": "predicate",
"values": [
"c_00251_00500"
]
}
]
}
'
Expected Response
The response returns organizations that match our desired criteria
- Industry: AI
- Founded: Within the last 10 years
- Location: United States
- Funding Stage: Series C
- Employee Count: More than 250
Each item includes the organization entity and associated metadata, including:
- UUID - The unique Crunchbase identifier
- Company details matching the applied filters
Response below is condensed to show an example and does not contain the entire response from the API
{
"count": 23,
"entities": [
{
"uuid": "a3674669-6d9e-4f70-895f-3c8c99bcb7ad",
"properties": {
"founded_on": {
"precision": "day",
"value": "2020-08-30"
},
"identifier": {
"permalink": "writer",
"image_id": "jqgtyt2qclr1ikl5mpjv",
"uuid": "a3674669-6d9e-4f70-895f-3c8c99bcb7ad",
"entity_def_id": "organization",
"value": "Writer"
},
"category_groups": [
{
"entity_def_id": "category_group",
"permalink": "artificial-intelligence-e551",
"uuid": "e5514a50-8200-7f6b-de87-b07990670800",
"value": "Artificial Intelligence (AI)"
},
{
"entity_def_id": "category_group",
"permalink": "data-and-analytics",
"uuid": "701eef4f-18c1-4aff-b550-caf732cd575f",
"value": "Data and Analytics"
},
{
"entity_def_id": "category_group",
"permalink": "media-and-entertainment-3bd7",
"uuid": "3bd75a3d-986a-9911-b145-f944d7d6d4c6",
"value": "Media and Entertainment"
},
{
"entity_def_id": "category_group",
"permalink": "science-and-engineering",
"uuid": "285e29fc-8f70-bf00-1749-9e94158f64f4",
"value": "Science and Engineering"
},
{
"entity_def_id": "category_group",
"permalink": "software-85b6",
"uuid": "85b6bca9-930a-11bc-a608-a513b76fb637",
"value": "Software"
}
],
"num_employees_enum": "c_00251_00500",
"last_equity_funding_type": "series_c",
"location_identifiers": [
{
"permalink": "san-francisco-california",
"uuid": "528f5e3c-90d1-1111-5d1c-2e4ff979d58e",
"location_type": "city",
"entity_def_id": "location",
"value": "San Francisco"
},
{
"permalink": "california-united-states",
"uuid": "eb879a83-c91a-121e-0bb8-829782dbcf04",
"location_type": "region",
"entity_def_id": "location",
"value": "California"
},
{
"permalink": "united-states",
"uuid": "f110fca2-1055-99f6-996d-011c198b3928",
"location_type": "country",
"entity_def_id": "location",
"value": "United States"
},
{
"permalink": "north-america",
"uuid": "b25caef9-a1b8-3a5d-6232-93b2dfb6a1d1",
"location_type": "continent",
"entity_def_id": "location",
"value": "North America"
}
]
}
},
Outcome
By using just one API call, we’re able to filter through millions of companies to find a highly targeted list that matches our ICP. This surfaces qualified leads in seconds for our go-to-market team.
If you want to extend this workflow even further, see our next recipe card:
Anticipate what’s next for your ICP-fit accounts using Crunchbase’s Predictions and InsightsThis recipe card will show you how to retrieve Funding and Growth Predictions, as well as integrate probability and timing signals into scoring workflows.
If you have any questions, please reach out to [email protected].
Updated 7 days ago