Step 1:

Search for a Growth Predicti

In this step, we’ll request the latest Growth Prediction for a specific company to confirm whether one exists.

Endpoint

Query

For the first part of this exercise, we’re going to search for the latest Growth Predictions for the company Writer (UUID: a3674669-6d9e-4f70-895f-3c8c99bcb7ad):

Now that we have the field_id defined, here is the sample query we can run that will search for available Growth Predictions for the company Writer:

curl --request POST \
     --url https://api.crunchbase.com/v4/data/searches/growth_predictions \
     --header 'X-cb-user-key: dac9eef1292e432a8a94XXXXXXXXXXXX' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "field_ids": [
    "organization"
  ],
  "query": [
    {
      "field_id": "organization",
      "operator_id": "includes",
      "type": "predicate",
      "values": [
        "a3674669-6d9e-4f70-895f-3c8c99bcb7ad"
      ]
    }
  ]
}

Response

The response contains 10 Growth Prediction entities, with the date of each prediction and their unique identifier (UUID). This UUID can be used to get more information about that specific Growth Prediction (more on that below).

❗️

The response below is condensed to show 1 of the 10 growth predictions, and does not contain the entire response from the API

{
  "count": 10,
  "entities": [
    {
      "uuid": "030b0f7c-8dc3-4b25-9ce2-baed5d8f1ee6",
      "properties": {
        "identifier": {
          "entity_def_id": "growth_prediction",
          "image_id": "7299fb1a70b6414b8adb52b6d56d486b",
          "uuid": "030b0f7c-8dc3-4b25-9ce2-baed5d8f1ee6",
          "value": "Growth Prediction 2026-01-24"
        },
        "organization": {
          "permalink": "writer",
          "image_id": "jqgtyt2qclr1ikl5mpjv",
          "uuid": "a3674669-6d9e-4f70-895f-3c8c99bcb7ad",
          "entity_def_id": "organization",
          "value": "Writer"
        }
      }
    },

Outcome

By using the Search GrowthPrediction Entities endpoint, we’re able to query Crunchbase for a list of all the Growth Predictions that have been made for the particular company that meets our ICP. From here, we can take the latest one and retrieve all the information about it.

Step 2

Retrieve and Operationalize the Latest Growth Prediction

Now that we have a list of the Growth Predictions for the company Writer, we’re now going to query Crunchbase for the latest one, and retrieve all the information we have for that prediction. This will help your teams retrieve the full prediction object — including probability score and probability tier — to determine whether the company is likely to experience future high-growth. These fields can be integrated into scoring models, CRM updates, or notification systems to prioritize outreach to accounts that may require scaling solutions or increased engagement.

Endpoint

Query

For the second part of this exercise, we’re going to retrieve the data behind the latest growth prediction that we found in the previous query (above) using its unique identifier (UUID):

Key Fields for this Query

curl --request GET \
     --url 'https://api.crunchbase.com/v4/data/entities/growth_predictions/030b0f7c-8dc3-4b25-9ce2-baed5d8f1ee6?field_ids=created_at,probability_score,probability_tier,runway_speculation&card_ids=fields' \
     --header 'X-cb-user-key: dac9eef1292e432a8a94XXXXXXXXXXXX' \
     --header 'accept: application/json'

Response

The response contains the specific details behind the latest Growth Prediction, including Crunchbase’s level of confidence - probability score and probability tier.

{
  "properties": {
    "identifier": {
      "uuid": "030b0f7c-8dc3-4b25-9ce2-baed5d8f1ee6",
      "value": "Growth Prediction 2026-01-24",
      "image_id": "7299fb1a70b6414b8adb52b6d56d486b",
      "entity_def_id": "growth_prediction"
    },
    "probability_score": 0.9529,
    "runway_speculation": {
      "uuid": "5d591058-76cc-4fa6-8ad1-be4d0186b70d",
      "value": "Series C - Writer",
      "image_id": "jqgtyt2qclr1ikl5mpjv",
      "permalink": "writer-series-c--5d591058",
      "entity_def_id": "funding_round"
    },
    "unicorn_status": "c200_evidence_present",
    "created_at": "2026-01-15T09:59:33Z",
    "key_employee_changes": [
      {
        "uuid": "d3be8cd0-ad46-4507-9c59-a0d44b234311",
        "image_id": "7299fb1a70b6414b8adb52b6d56d486b",
        "entity_def_id": "key_employee_change"
      },
      {
        "uuid": "356d3002-3eb9-43c1-b4f8-3c620bdc0f0c",
        "image_id": "7299fb1a70b6414b8adb52b6d56d486b",
        "entity_def_id": "key_employee_change"
      }
    ],
    "probability_tier": "p100_positive_high"
  },

Outcome

From this response, we’re able to conclude:

Having this level of detail on what’s coming around the corner allows your teams to know which companies to target before your competitors do.