---
updatedAt: 2026-07-16T19:46:56.000Z
agentTools:
  projectIndex: https://data.crunchbase.com/llms.txt
---

# Lookup MarketInsight's single card

The following cards are available: [market_insight_reasons]

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Predictions & Insights Package",
    "description": "Crunchbase Enterprise API - Predictions and Insights",
    "termsOfService": "https://data.crunchbase.com/docs/terms",
    "contact": {
      "email": "partnerships@crunchbase.com"
    },
    "version": "1.1.0"
  },
  "externalDocs": {
    "description": "API Reference doc",
    "url": "https://data.crunchbase.com/docs"
  },
  "servers": [
    {
      "url": "https://api.crunchbase.com/v4"
    }
  ],
  "security": [
    {
      "ApiKeyAuthHeader": []
    }
  ],
  "tags": [
    {
      "name": "Entity"
    }
  ],
  "paths": {
    "/data/entities/market_insights/{entity_id}/cards/{card_id}": {
      "get": {
        "tags": [
          "Entity"
        ],
        "summary": "Lookup MarketInsight's single card",
        "description": "The following cards are available: [market_insight_reasons]",
        "operationId": "getMarketInsightCard",
        "parameters": [
          {
            "$ref": "#/components/parameters/entity_id"
          },
          {
            "name": "card_id",
            "in": "path",
            "description": "A market_insight card to lookup",
            "required": true,
            "style": "simple",
            "explode": false,
            "schema": {
              "title": "card_id",
              "type": "string",
              "enum": [
                "market_insight_reasons"
              ]
            }
          },
          {
            "$ref": "#/components/parameters/card_field_ids"
          },
          {
            "$ref": "#/components/parameters/after_id"
          },
          {
            "$ref": "#/components/parameters/before_id"
          },
          {
            "$ref": "#/components/parameters/order"
          },
          {
            "$ref": "#/components/parameters/limit"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/MarketInsightCardLookupResponse"
          },
          "400": {
            "$ref": "#/components/responses/GenericBadRequestError"
          },
          "404": {
            "$ref": "#/components/responses/GenericNotFoundError"
          },
          "500": {
            "$ref": "#/components/responses/GenericInternalServerError"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "EntityIdentifier": {
        "type": "object",
        "description": "Every entity in the system has a unique identifier that contains all necessary properties to represent it.",
        "required": [
          "entity_def_id",
          "uuid"
        ],
        "properties": {
          "entity_def_id": {
            "type": "string",
            "enum": [
              "acquisition",
              "acquisition_prediction",
              "address",
              "award",
              "category",
              "category_group",
              "market_insight",
              "market_insight_reason",
              "closure_prediction",
              "current_valuation_comparable",
              "current_valuation_estimate",
              "degree",
              "diversity_spotlight",
              "event",
              "event_appearance",
              "fund",
              "funding_prediction",
              "funding_round",
              "growth_event",
              "growth_insight",
              "growth_prediction",
              "investment",
              "investor_insight",
              "investor_match",
              "ipo",
              "ipo_prediction",
              "job",
              "key_employee_change",
              "layoff",
              "layoff_prediction",
              "legal_proceeding",
              "location",
              "micro_category",
              "remain_private_prediction",
              "organization",
              "org_similarity",
              "product_similarity",
              "ownership",
              "partnership_announcement",
              "person",
              "press_reference",
              "product",
              "product_launch",
              "research_insight"
            ]
          },
          "image_id": {
            "type": "string",
            "maxLength": 255
          },
          "permalink": {
            "type": "string",
            "maxLength": 255
          },
          "uuid": {
            "type": "string",
            "description": "Universally Unique Identifier",
            "format": "uuid"
          },
          "value": {
            "type": "string",
            "maxLength": 255
          }
        }
      },
      "Errors": {
        "type": "object",
        "description": "Developer friendly error message",
        "properties": {
          "value": {
            "type": "string",
            "description": "stuff"
          }
        }
      },
      "MarketInsight": {
        "type": "object",
        "required": [
          "identifier"
        ],
        "properties": {
          "created_at": {
            "type": "string",
            "format": "date-time",
            "x-cb-field-type": "datetime",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "between",
              "blank",
              "eq",
              "gte",
              "lte"
            ]
          },
          "direction": {
            "type": "string",
            "description": "* c100_growing - Growing\n* c200_stable - Stable\n* c300_declining - Declining",
            "enum": [
              "c100_growing",
              "c200_stable",
              "c300_declining"
            ],
            "x-enum-descriptions": [
              "Growing",
              "Stable",
              "Declining"
            ],
            "x-cb-field-enum-values": [
              {
                "value": "c100_growing",
                "description": "Growing"
              },
              {
                "value": "c200_stable",
                "description": "Stable"
              },
              {
                "value": "c300_declining",
                "description": "Declining"
              }
            ],
            "x-cb-field-type": "enum",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "blank",
              "eq",
              "includes",
              "not_eq",
              "not_includes"
            ]
          },
          "entity_def_id": {
            "type": "string",
            "description": "Market Insight\n* market_insight - Market Insight",
            "enum": [
              "market_insight"
            ],
            "x-enum-descriptions": [
              "Market Insight"
            ],
            "x-cb-field-enum-values": [
              {
                "value": "market_insight",
                "description": "Market Insight"
              }
            ],
            "x-cb-field-type": "enum",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "blank",
              "eq",
              "includes",
              "not_eq",
              "not_includes"
            ]
          },
          "generated_on": {
            "type": "string",
            "format": "date",
            "x-cb-field-type": "date",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "between",
              "blank",
              "eq",
              "gte",
              "lte"
            ]
          },
          "identifier": {
            "type": "object",
            "description": "Market Insight",
            "allOf": [
              {
                "$ref": "#/components/schemas/EntityIdentifier"
              }
            ],
            "x-cb-field-type": "identifier",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "blank",
              "contains",
              "eq",
              "includes",
              "not_contains",
              "not_eq",
              "not_includes",
              "starts"
            ]
          },
          "subject": {
            "type": "object",
            "description": "Industry Collection Type",
            "allOf": [
              {
                "$ref": "#/components/schemas/EntityIdentifier"
              }
            ],
            "x-cb-field-type": "identifier",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "blank",
              "contains",
              "eq",
              "includes",
              "not_contains",
              "not_eq",
              "not_includes",
              "starts"
            ]
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "x-cb-field-type": "datetime",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "between",
              "blank",
              "eq",
              "gte",
              "lte"
            ]
          },
          "uuid": {
            "type": "string",
            "format": "uuid",
            "x-cb-field-type": "uuid",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "blank",
              "eq",
              "includes",
              "not_eq",
              "not_includes"
            ]
          }
        }
      },
      "MarketInsightEntity": {
        "type": "object",
        "properties": {
          "cards": {
            "type": "object",
            "properties": {
              "fields": {
                "$ref": "#/components/schemas/MarketInsight"
              },
              "market_insight_reasons": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/MarketInsightReason"
                }
              }
            }
          },
          "properties": {
            "$ref": "#/components/schemas/MarketInsight"
          }
        }
      },
      "MarketInsightReason": {
        "type": "object",
        "required": [
          "identifier"
        ],
        "properties": {
          "created_at": {
            "type": "string",
            "format": "date-time",
            "x-cb-field-type": "datetime",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "between",
              "blank",
              "eq",
              "gte",
              "lte"
            ]
          },
          "entity_def_id": {
            "type": "string",
            "description": "Market Insight Reason\n* market_insight_reason - Market Insight Reason",
            "enum": [
              "market_insight_reason"
            ],
            "x-enum-descriptions": [
              "Market Insight Reason"
            ],
            "x-cb-field-enum-values": [
              {
                "value": "market_insight_reason",
                "description": "Market Insight Reason"
              }
            ],
            "x-cb-field-type": "enum",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "blank",
              "eq",
              "includes",
              "not_eq",
              "not_includes"
            ]
          },
          "identifier": {
            "type": "object",
            "description": "Market Insight Reason",
            "allOf": [
              {
                "$ref": "#/components/schemas/EntityIdentifier"
              }
            ],
            "x-cb-field-type": "identifier",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "blank",
              "contains",
              "eq",
              "includes",
              "not_contains",
              "not_eq",
              "not_includes",
              "starts"
            ]
          },
          "market_insight": {
            "type": "object",
            "description": "Market Insight",
            "allOf": [
              {
                "$ref": "#/components/schemas/EntityIdentifier"
              }
            ],
            "x-cb-field-type": "identifier",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "blank",
              "contains",
              "eq",
              "includes",
              "not_contains",
              "not_eq",
              "not_includes",
              "starts"
            ]
          },
          "market_insight_generated_on": {
            "type": "string",
            "format": "date",
            "x-cb-field-type": "date",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "between",
              "blank",
              "eq",
              "gte",
              "lte"
            ]
          },
          "market_insight_subject": {
            "type": "object",
            "description": "Industry Collection Type",
            "allOf": [
              {
                "$ref": "#/components/schemas/EntityIdentifier"
              }
            ],
            "x-cb-field-type": "identifier",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "blank",
              "contains",
              "eq",
              "includes",
              "not_contains",
              "not_eq",
              "not_includes",
              "starts"
            ]
          },
          "metric_basis": {
            "type": "string",
            "description": "* acquisition_activity - Acquisition Activity\n* activity - Activity\n* average_value - Average Value\n* cluster_size - Cluster Size\n* company_count - Company Count\n* coverage_rate - Coverage Rate\n* employment - Employment\n* ipo_activity - IPO Activity\n* median_value - Median Value\n* total_value - Total Value\n* viewer_count - Viewer Count",
            "enum": [
              "activity",
              "total_value",
              "median_value",
              "average_value",
              "company_count",
              "coverage_rate",
              "cluster_size",
              "ipo_activity",
              "acquisition_activity",
              "viewer_count",
              "employment"
            ],
            "x-enum-descriptions": [
              "Activity",
              "Total Value",
              "Median Value",
              "Average Value",
              "Company Count",
              "Coverage Rate",
              "Cluster Size",
              "IPO Activity",
              "Acquisition Activity",
              "Viewer Count",
              "Employment"
            ],
            "x-cb-field-enum-values": [
              {
                "value": "activity",
                "description": "Activity"
              },
              {
                "value": "total_value",
                "description": "Total Value"
              },
              {
                "value": "median_value",
                "description": "Median Value"
              },
              {
                "value": "average_value",
                "description": "Average Value"
              },
              {
                "value": "company_count",
                "description": "Company Count"
              },
              {
                "value": "coverage_rate",
                "description": "Coverage Rate"
              },
              {
                "value": "cluster_size",
                "description": "Cluster Size"
              },
              {
                "value": "ipo_activity",
                "description": "IPO Activity"
              },
              {
                "value": "acquisition_activity",
                "description": "Acquisition Activity"
              },
              {
                "value": "viewer_count",
                "description": "Viewer Count"
              },
              {
                "value": "employment",
                "description": "Employment"
              }
            ],
            "x-cb-field-type": "enum",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "blank",
              "eq",
              "includes",
              "not_eq",
              "not_includes"
            ]
          },
          "percent_change": {
            "type": "number",
            "format": "double",
            "x-cb-field-type": "decimal",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "between",
              "blank",
              "eq",
              "gt",
              "gte",
              "lt",
              "lte",
              "not_eq"
            ]
          },
          "reason_kind": {
            "type": "string",
            "description": "* exits - Exits\n* funding - Funding\n* labor_market - Labor Market\n* profile_views - Profile Views",
            "enum": [
              "funding",
              "exits",
              "profile_views",
              "labor_market"
            ],
            "x-enum-descriptions": [
              "Funding",
              "Exits",
              "Profile Views",
              "Labor Market"
            ],
            "x-cb-field-enum-values": [
              {
                "value": "funding",
                "description": "Funding"
              },
              {
                "value": "exits",
                "description": "Exits"
              },
              {
                "value": "profile_views",
                "description": "Profile Views"
              },
              {
                "value": "labor_market",
                "description": "Labor Market"
              }
            ],
            "x-cb-field-type": "enum",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "blank",
              "eq",
              "includes",
              "not_eq",
              "not_includes"
            ]
          },
          "timeframe": {
            "type": "string",
            "description": "* last_12_months - Last 12 Months\n* last_180_days - Last 180 Days\n* last_2_years - Last 2 Years\n* last_30_days - Last 30 Days\n* last_3_years - Last 3 Years\n* last_90_days - Last 90 Days\n* month_over_month - Month Over Month\n* since_last_clustering_cycle - Since Last Clustering Cycle\n* week_over_week - Week Over Week\n* year_over_year - Year Over Year",
            "enum": [
              "since_last_clustering_cycle",
              "last_12_months",
              "year_over_year",
              "last_30_days",
              "week_over_week",
              "month_over_month",
              "last_90_days",
              "last_180_days",
              "last_2_years",
              "last_3_years"
            ],
            "x-enum-descriptions": [
              "Since Last Clustering Cycle",
              "Last 12 Months",
              "Year Over Year",
              "Last 30 Days",
              "Week Over Week",
              "Month Over Month",
              "Last 90 Days",
              "Last 180 Days",
              "Last 2 Years",
              "Last 3 Years"
            ],
            "x-cb-field-enum-values": [
              {
                "value": "since_last_clustering_cycle",
                "description": "Since Last Clustering Cycle"
              },
              {
                "value": "last_12_months",
                "description": "Last 12 Months"
              },
              {
                "value": "year_over_year",
                "description": "Year Over Year"
              },
              {
                "value": "last_30_days",
                "description": "Last 30 Days"
              },
              {
                "value": "week_over_week",
                "description": "Week Over Week"
              },
              {
                "value": "month_over_month",
                "description": "Month Over Month"
              },
              {
                "value": "last_90_days",
                "description": "Last 90 Days"
              },
              {
                "value": "last_180_days",
                "description": "Last 180 Days"
              },
              {
                "value": "last_2_years",
                "description": "Last 2 Years"
              },
              {
                "value": "last_3_years",
                "description": "Last 3 Years"
              }
            ],
            "x-cb-field-type": "enum",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "blank",
              "eq",
              "includes",
              "not_eq",
              "not_includes"
            ]
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "x-cb-field-type": "datetime",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "between",
              "blank",
              "eq",
              "gte",
              "lte"
            ]
          },
          "uuid": {
            "type": "string",
            "format": "uuid",
            "x-cb-field-type": "uuid",
            "x-cb-searchable": true,
            "x-cb-search-operators": [
              "blank",
              "eq",
              "includes",
              "not_eq",
              "not_includes"
            ]
          }
        }
      }
    },
    "responses": {
      "GenericBadRequestError": {
        "description": "Bad Request",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Errors"
            }
          }
        }
      },
      "GenericNotFoundError": {
        "description": "Not Found",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Errors"
            }
          }
        }
      },
      "GenericInternalServerError": {
        "description": "Request Failed",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Errors"
            }
          }
        }
      },
      "MarketInsightCardLookupResponse": {
        "description": "Results are identifiers matching the search query",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/MarketInsightEntity"
            }
          }
        }
      }
    },
    "parameters": {
      "entity_id": {
        "name": "entity_id",
        "in": "path",
        "description": "UUID or permalink of desired entity",
        "required": true,
        "schema": {
          "title": "entity_id",
          "type": "string"
        }
      },
      "card_field_ids": {
        "name": "card_field_ids",
        "in": "query",
        "description": "Card fields to include on the specified card - array of field_id strings in JSON encoded as string",
        "schema": {
          "title": "card_field_ids",
          "type": "string"
        }
      },
      "after_id": {
        "name": "after_id",
        "in": "query",
        "description": "Lookup uuid of the last item in the previous page (not required for first page). Used to iterate a card's results starting at the beginning of the ordered set and moving forward. Suitable for implementing \"next page\" functionality. May not be provided simultaneously with before_id.",
        "schema": {
          "title": "after_id",
          "type": "string",
          "format": "uuid"
        }
      },
      "before_id": {
        "name": "before_id",
        "in": "query",
        "description": "Lookup uuid of the first item in the previous page (not required for first page). Used to iterate a card's results starting at the end of the ordered set and moving backward. Suitable for implementing \"previous page\" functionality. May not be provided simultaneously with after_id.",
        "schema": {
          "title": "before_id",
          "type": "string",
          "format": "uuid"
        }
      },
      "order": {
        "name": "order",
        "in": "query",
        "description": "Field name with order direction (asc/desc)",
        "schema": {
          "title": "order",
          "type": "string"
        }
      },
      "limit": {
        "name": "limit",
        "in": "query",
        "description": "Number of rows to return. Default is 100, min is 1, max is 100.",
        "schema": {
          "title": "limit",
          "type": "integer"
        }
      }
    },
    "securitySchemes": {
      "ApiKeyAuthHeader": {
        "type": "apiKey",
        "name": "X-cb-user-key",
        "in": "header"
      }
    }
  }
}
```