Build a target account list
Find companies that match your ideal customer profile.
Before you begin
Your API key must include the fields and collections requested below. Check your API package if an endpoint or field is unavailable. Complete your first API request to set CRUNCHBASE_API_KEY in bash or zsh. Commands below include response headers; look for HTTP 200, then read the JSON body.
Primary APIs: Organization Search
Endpoint
POST https://api.crunchbase.com/v4/data/searches/organizations
API reference and guides
Query
Find AI companies in the United States founded between 2016 and 2026, with 251–500 employees and a latest equity funding round of Series C.
Fields used in 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). Adjust the date bounds for your desired period. | between; blank; eq; gte; lte |
last_equity_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 |
Scroll to view all columns →
Run the request
curl --include --request POST \
--url 'https://api.crunchbase.com/v4/data/searches/organizations' \
--header "X-cb-user-key: $CRUNCHBASE_API_KEY" \
--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"
]
}
],
"limit": 3
}'
Example response
The response returns organizations that match our desired criteria
- Industry: AI
- Founded: 2016–2026
- Location: United States
- Funding Stage: Series C
- Employee Count: 251–500
Each item includes the organization entity and associated metadata, including:
- UUID - The unique Crunchbase identifier
- Company details matching the applied filters
The historical example below shows one organization from 23 matching records. count is the total matches; entities contains the returned page. The sample is shortened, so other fields and records may be omitted. Counts and values can change.
{
"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"
}
]
}
}
]
}
Interpret the response
This request returns one page of organizations matching all five ICP filters. Use the organization UUIDs for enrichment; a matching organization is a research candidate, not a guarantee of sales qualification.
Continue with the next playbook:
Anticipate what’s next for your ICP-fit accounts using Crunchbase’s Predictions and Insights
This playbook shows how to retrieve funding predictions and interpret their probability and timing fields.
If you have any questions, please reach out to [email protected].
Check your result
Inspect the returned fields against your filters. An empty entities array is a valid result: broaden one filter at a time if needed. Fixed dates are example inputs; adjust them to your research period.
Search requests here use limit: 3 for a small first page. For a complete result set, follow search pagination while preserving the filters and ordering. For request failures, use the shared request and retry guidance.
Updated 14 days ago