Build a target account list

Before you begin

This example was verified with Advanced Financials access. 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.

Persona: Go-to-market teams

Use case: Build a target account list

Primary APIs: Organization Search

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

https://data.crunchbase.com/docs/search-api-basics
https://data.crunchbase.com/reference/searchorganizations-2

Query

Companies

Located in USA

Founded 2016–2026

251–500 Employees

AI Industry

Series C Funding

For this example, we’re trying to find companies in the United States that were founded between 2016 and 2026 and have 251–500 employees. We’re looking specifically for companies in the AI industry with a latest equity funding round of Series C.

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). 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

Now that we have the fields defined, here is a sample query that we can run

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
}'

Expected Response

Response examples below are historical, shortened JSON samples; search samples show one entity and card samples show at most one record per card. Other fields or records may be omitted. Counts and values change; count is the total matching records, while entities contains the returned page.

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 response below is shortened to show one organization. The example count of 23 represents the total matching organizations, not the number of organizations displayed here. Results may change over time.

{
  "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

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.

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 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.