---
title: "Lookup a MarketInsight"
method: GET
path: "/data/entities/market_insights/{entity_id}"
tags: ["Entity"]
---

# Lookup a MarketInsight

`GET /data/entities/market_insights/{entity_id}`

## Request

- Base URL: `https://api.crunchbase.com/v4`
- URL: `https://api.crunchbase.com/v4/data/entities/market_insights/{entity_id}`
- Auth: API key in header `X-cb-user-key`

## Path parameters

- `entity_id` string, required

## Query parameters

- `field_ids` MarketInsightFieldId[]
- `card_ids` string[]

## Response `200`

Single MarketInsight result

- MarketInsightEntity
  - `cards` object
    - `fields` MarketInsight
      - `created_at` string, date-time
      - `direction` 'c100_growing' | 'c200_stable' | 'c300_declining': * c100_growing - Growing * c200_stable - Stable * c300_declining - Declining
      - `entity_def_id` 'market_insight': Market Insight * market_insight - Market Insight
      - `generated_on` string, date
      - `identifier` EntityIdentifier, required: Every entity in the system has a unique identifier that contains all necessary properties to represent it.
        - `entity_def_id` 'acquisition' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'current_valuation_comparable' | 'current_valuation_estimate' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_round' | 'growth_event' | 'growth_insight' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'job' | 'key_employee_change' | 'layoff' | 'legal_proceeding' | 'location' | 'micro_category' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
        - `image_id` string
        - `permalink` string
        - `uuid` string, uuid, required: Universally Unique Identifier
        - `value` string
      - `subject` EntityIdentifier: Every entity in the system has a unique identifier that contains all necessary properties to represent it.
        - `entity_def_id` 'acquisition' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'current_valuation_comparable' | 'current_valuation_estimate' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_round' | 'growth_event' | 'growth_insight' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'job' | 'key_employee_change' | 'layoff' | 'legal_proceeding' | 'location' | 'micro_category' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
        - `image_id` string
        - `permalink` string
        - `uuid` string, uuid, required: Universally Unique Identifier
        - `value` string
      - `updated_at` string, date-time
      - `uuid` string, uuid
    - `market_insight_reasons` MarketInsightReason[]
      - `created_at` string, date-time
      - `entity_def_id` 'market_insight_reason': Market Insight Reason * market_insight_reason - Market Insight Reason
      - `identifier` EntityIdentifier, required: Every entity in the system has a unique identifier that contains all necessary properties to represent it.
        - `entity_def_id` 'acquisition' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'current_valuation_comparable' | 'current_valuation_estimate' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_round' | 'growth_event' | 'growth_insight' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'job' | 'key_employee_change' | 'layoff' | 'legal_proceeding' | 'location' | 'micro_category' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
        - `image_id` string
        - `permalink` string
        - `uuid` string, uuid, required: Universally Unique Identifier
        - `value` string
      - `market_insight` EntityIdentifier: Every entity in the system has a unique identifier that contains all necessary properties to represent it.
        - `entity_def_id` 'acquisition' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'current_valuation_comparable' | 'current_valuation_estimate' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_round' | 'growth_event' | 'growth_insight' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'job' | 'key_employee_change' | 'layoff' | 'legal_proceeding' | 'location' | 'micro_category' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
        - `image_id` string
        - `permalink` string
        - `uuid` string, uuid, required: Universally Unique Identifier
        - `value` string
      - `market_insight_generated_on` string, date
      - `market_insight_subject` EntityIdentifier: Every entity in the system has a unique identifier that contains all necessary properties to represent it.
        - `entity_def_id` 'acquisition' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'current_valuation_comparable' | 'current_valuation_estimate' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_round' | 'growth_event' | 'growth_insight' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'job' | 'key_employee_change' | 'layoff' | 'legal_proceeding' | 'location' | 'micro_category' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
        - `image_id` string
        - `permalink` string
        - `uuid` string, uuid, required: Universally Unique Identifier
        - `value` string
      - `metric_basis` 'activity' | 'total_value' | 'median_value' | 'average_value' | 'company_count' | 'coverage_rate' | 'cluster_size' | 'ipo_activity' | 'acquisition_activity' | 'viewer_count' | 'employment': * acquisition_activity - Acquisition Activity * activity - Activity * average_value - Average Value * cluster_size - Cluster Size * company_count - Company Count * coverage_rate - Coverage Rate * employment - Employment * ipo_activity - IPO Activity * median_value - Median Value * total_value - Total Value * viewer_count - Viewer Count
      - `percent_change` number, double
      - `reason_kind` 'funding' | 'exits' | 'profile_views' | 'labor_market': * exits - Exits * funding - Funding * labor_market - Labor Market * profile_views - Profile Views
      - `timeframe` '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': * last_12_months - Last 12 Months * last_180_days - Last 180 Days * last_2_years - Last 2 Years * last_30_days - Last 30 Days * last_3_years - Last 3 Years * last_90_days - Last 90 Days * month_over_month - Month Over Month * since_last_clustering_cycle - Since Last Clustering Cycle * week_over_week - Week Over Week * year_over_year - Year Over Year
      - `updated_at` string, date-time
      - `uuid` string, uuid
  - `properties` MarketInsight
    - `created_at` string, date-time
    - `direction` 'c100_growing' | 'c200_stable' | 'c300_declining': * c100_growing - Growing * c200_stable - Stable * c300_declining - Declining
    - `entity_def_id` 'market_insight': Market Insight * market_insight - Market Insight
    - `generated_on` string, date
    - `identifier` EntityIdentifier, required: Every entity in the system has a unique identifier that contains all necessary properties to represent it.
      - `entity_def_id` 'acquisition' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'current_valuation_comparable' | 'current_valuation_estimate' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_round' | 'growth_event' | 'growth_insight' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'job' | 'key_employee_change' | 'layoff' | 'legal_proceeding' | 'location' | 'micro_category' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
      - `image_id` string
      - `permalink` string
      - `uuid` string, uuid, required: Universally Unique Identifier
      - `value` string
    - `subject` EntityIdentifier: Every entity in the system has a unique identifier that contains all necessary properties to represent it.
      - `entity_def_id` 'acquisition' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'current_valuation_comparable' | 'current_valuation_estimate' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_round' | 'growth_event' | 'growth_insight' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'job' | 'key_employee_change' | 'layoff' | 'legal_proceeding' | 'location' | 'micro_category' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
      - `image_id` string
      - `permalink` string
      - `uuid` string, uuid, required: Universally Unique Identifier
      - `value` string
    - `updated_at` string, date-time
    - `uuid` string, uuid

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Request Failed

---

[API](https://skmtc.dev/crunchbase/apis/insights-only-package.md) - [All operations](https://skmtc.dev/crunchbase/apis/insights-only-package/llms.txt) - [OpenAPI document](https://skmtc.dev/crunchbase/apis/insights-only-package/revisions/fe896609f5d0?raw)