---
title: "Get full company enrichment"
method: POST
path: "/company/enrich"
tags: ["Company APIs", "Enrich APIs"]
---

# Get full company enrichment

`POST /company/enrich`

Get comprehensive company data including firmographics, headcount, funding,
web traffic, employee reviews, people (founders, CXOs, decision makers), news,
and more. Identify the company by domain, name, profile URL, or Crustdata company ID.
Use the fields parameter to select specific data groups and reduce response size.

The API returns a top-level array with one result per submitted
identifier. The same endpoint supports multiple identifiers of one type in a single
request. No-match responses currently return `200` with an empty `matches` array.

<Note>
    Default `rate-limit` is 15 requests per minute. Send an email to [gtm@crustdata.co](mailto:gtm@crustdata.co) to discuss higher limits if needed for your use case.
</Note>

## Headers

- `x-api-version` '2025-11-01', required

## Request body

- union — Company identifiers plus optional field selection and exact_match. Provide exactly one identifier type (names, domains, crustdata_company_ids, or professional_network_profile_urls); each may contain one or more values.
  - object
    - `names` string[], nullable, required
    - `domains` string[], nullable
    - `crustdata_company_ids` integer[], nullable
    - `professional_network_profile_urls` string[], nullable
    - `fields` string[] — Field groups to include in `company_data`. When `fields` is omitted, only `crustdata_company_id` and `basic_info` are returned — sections such as `headcount`, `funding`, `people`, and `hiring` must be listed explicitly. Valid field groups for enrich: basic_info, revenue, headcount, funding, hiring, web_traffic, seo, competitors, employee_reviews, people, locations, taxonomy, followers, news, software_reviews, social_profiles, reviews, public_launches, market_intel, metadata, crustdata_company_id, updated_at, indexed_at. Not valid for enrich: roles, skills (search-only fields).
    - `exact_match` boolean, nullable — Whether to use exact matching (null means auto-detect)
  - object
    - `names` string[], nullable
    - `domains` string[], nullable, required
    - `crustdata_company_ids` integer[], nullable
    - `professional_network_profile_urls` string[], nullable
    - `fields` string[] — Field groups to include in `company_data`. When `fields` is omitted, only `crustdata_company_id` and `basic_info` are returned — sections such as `headcount`, `funding`, `people`, and `hiring` must be listed explicitly. Valid field groups for enrich: basic_info, revenue, headcount, funding, hiring, web_traffic, seo, competitors, employee_reviews, people, locations, taxonomy, followers, news, software_reviews, social_profiles, reviews, public_launches, market_intel, metadata, crustdata_company_id, updated_at, indexed_at. Not valid for enrich: roles, skills (search-only fields).
    - `exact_match` boolean, nullable — Whether to use exact matching (null means auto-detect)
  - object
    - `names` string[], nullable
    - `domains` string[], nullable
    - `crustdata_company_ids` integer[], nullable, required
    - `professional_network_profile_urls` string[], nullable
    - `fields` string[] — Field groups to include in `company_data`. When `fields` is omitted, only `crustdata_company_id` and `basic_info` are returned — sections such as `headcount`, `funding`, `people`, and `hiring` must be listed explicitly. Valid field groups for enrich: basic_info, revenue, headcount, funding, hiring, web_traffic, seo, competitors, employee_reviews, people, locations, taxonomy, followers, news, software_reviews, social_profiles, reviews, public_launches, market_intel, metadata, crustdata_company_id, updated_at, indexed_at. Not valid for enrich: roles, skills (search-only fields).
    - `exact_match` boolean, nullable — Whether to use exact matching (null means auto-detect)
  - object
    - `names` string[], nullable
    - `domains` string[], nullable
    - `crustdata_company_ids` integer[], nullable
    - `professional_network_profile_urls` string[], nullable, required
    - `fields` string[] — Field groups to include in `company_data`. When `fields` is omitted, only `crustdata_company_id` and `basic_info` are returned — sections such as `headcount`, `funding`, `people`, and `hiring` must be listed explicitly. Valid field groups for enrich: basic_info, revenue, headcount, funding, hiring, web_traffic, seo, competitors, employee_reviews, people, locations, taxonomy, followers, news, software_reviews, social_profiles, reviews, public_launches, market_intel, metadata, crustdata_company_id, updated_at, indexed_at. Not valid for enrich: roles, skills (search-only fields).
    - `exact_match` boolean, nullable — Whether to use exact matching (null means auto-detect)

## Response `200`

Enriched company matches returned as a top-level array

- EnrichResult[] — Top-level array returned by /company/enrich with one entry per submitted identifier.
  - `matched_on` string — The specific input value (e.g., 'google.com')
  - `match_type` 'name' | 'domain' | 'crustdata_company_id' | 'professional_network_profile_url'
  - `matches` EnrichMatch[]
    - `confidence_score` number, float
    - `company_data` CompanyEnrich — Fully-enriched company profile with firmographics, headcount, funding, web traffic, employee reviews, people, news, and more.
      - `crustdata_company_id` integer
      - `updated_at` string, date-time, nullable
      - `indexed_at` string, date-time, nullable
      - `metadata` object
        - `growth_calculation_date` string, nullable
      - `basic_info` object
        - `crustdata_company_id` integer
        - `name` string, nullable
        - `primary_domain` string, nullable
        - `all_domains` string[], nullable
        - `website` string, nullable
        - `professional_network_url` string, nullable
        - `professional_network_id` string, nullable
        - `profile_name` string, nullable
        - `logo_permalink` string, nullable
        - `description` string, nullable
        - `company_type` string, nullable
        - `year_founded` integer, nullable
        - `employee_count_range` string, nullable
        - `markets` string[], nullable
        - `industries` string[], nullable
      - `revenue` object
        - `estimated` object
          - `lower_bound_usd` integer
          - `upper_bound_usd` integer
          - `timeseries` object[]
        - `public_markets` object
          - `ipo_date` string, date
          - `stock_symbols` string[]
          - `fiscal_year_end` string
        - `acquisition_status` string, nullable
      - `headcount` object — Employee footprint
        - `total` integer, nullable
        - `largest_headcount_country` string, nullable
        - `timeseries` object[], nullable
          - `date` string
          - `employee_count` integer
        - `growth_percent` object — Headcount growth percent by period. Keys are period aliases: `mom` (month-over-month), `qoq` (quarter-over-quarter), `six_months`, `yoy` (year-over-year), `two_years`. Values are percentage changes over the trailing window. <Note> `/company/search` returns the same growth data under different period keys (`1m`, `3m`, `6m`, `12m`) and exposes per-period filtering via `headcount.growth_percent.{1m,3m,6m,12m}` paths. </Note>
        - `growth_absolute` object — Headcount absolute change by period. Keys are period aliases: `mom`, `qoq`, `six_months`, `yoy`, `two_years`. Values are absolute employee-count deltas over the trailing window.
        - `by_role_absolute` object
        - `by_role_percent` object
        - `by_region_absolute` object
        - `by_region_percent` object
        - `by_skill_absolute` object
        - `by_skill_percent` object
        - `by_function_timeseries` object — Timeseries headcount broken down by function or geo region. Top-level keys are CURRENT_FUNCTION and GEO_REGION; each value is a map of name (e.g. "Engineering" or "United States") to a list of {date, employee_count} points.
          - `CURRENT_FUNCTION` object, nullable
          - `GEO_REGION` object, nullable
      - `software_reviews` object
        - `review_count` integer
        - `average_rating` number
        - `review_count_mom_pct` number, nullable
        - `review_count_qoq_pct` number, nullable
        - `review_count_yoy_pct` number, nullable
      - `funding` object
        - `total_investment_usd` number, nullable
        - `last_round_amount_usd` number, nullable
        - `last_fundraise_date` string, date, nullable
        - `last_round_type` string, nullable
        - `milestones` object[], nullable
          - `date` string, date, nullable
          - `funding_date` string, date, nullable
          - `amount_usd` number, nullable
          - `round_type` string, nullable — Funding round type (e.g. seed, series_a, series_c).
          - `investors` string, nullable
          - `lead_investors` string, nullable
        - `investors` string[], nullable
        - `investors_detailed` object[], nullable
          - `name` string, nullable
          - `uuid` string, nullable
          - `type` string, nullable
          - `categories` string[], nullable
          - `permalink` string, nullable — Crunchbase permalink slug for the investor.
          - `crunchbase_profile_url` string, nullable — Full Crunchbase profile URL for the investor.
        - `acquisitions` object[], nullable
          - `acquiree_company_id` integer, nullable
          - `acquiree_company_name` string, nullable
          - `acquiree_crunchbase_url` string, nullable
          - `acquirer_company_id` integer, nullable
          - `acquirer_company_name` string, nullable
          - `acquirer_crunchbase_url` string, nullable
          - `announced_on_date` string, date, nullable
          - `transaction_text` string, nullable
        - `acquired_by` object[], nullable
          - `name` string, nullable
          - `crustdata_company_id` integer, nullable
          - `date` string, date, nullable
          - `amount_usd` number, nullable
      - `hiring` object
        - `recent_titles_csv` string
        - `openings_count` integer
        - `openings_growth_percent` object
        - `by_function_qoq_pct` object
        - `by_function_6m_pct` object
        - `open_jobs_timeseries` object[]
          - `date` string
          - `open_jobs` integer, nullable
        - `recent_openings` object[]
          - `title` string, nullable
          - `url` string, nullable — Job posting URL.
          - `number_of_openings` integer, nullable
          - `category` string, nullable — Job category / function (e.g. Sales, Engineering).
          - `description` string, nullable
          - `date_added` string, date-time, nullable
          - `date_updated` string, date-time, nullable
          - `location_text` string, nullable — Free-form location string from the job posting.
      - `web_traffic` object — Per-domain traffic metrics keyed by domain name.
        - `domain_traffic` object — Dict keyed by domain name, each value is a traffic metrics object.
      - `seo` object — SEO and paid-search traffic metrics
        - `total_organic_results` integer, nullable
        - `average_seo_organic_rank` number, nullable
        - `monthly_google_ads_budget` number, nullable
        - `monthly_paid_clicks` integer, nullable
        - `monthly_organic_clicks` integer, nullable
        - `monthly_organic_value` number, nullable
        - `average_ad_rank` number, nullable
        - `total_ads_purchased` integer, nullable
        - `lost_ranked_seo_keywords` integer, nullable
        - `gained_ranked_seo_keywords` integer, nullable
        - `newly_ranked_seo_keywords` integer, nullable
      - `competitors` object — Competitor domains aggregated from SEO and market intelligence signals
        - `all_domains` string[], nullable — All competitor domains from companies_competitors table
        - `paid_seo` string[], nullable — Paid-search competitors from data_lab_spyfu_web_traffic
        - `organic_seo` string[], nullable — Organic SEO competitors from data_lab_spyfu_web_traffic
      - `reviews` object, nullable — Other (non-employee) reviews bucket. May be null when not populated.
        - `other` object[], nullable
          - `source` string, nullable
          - `rating` number, nullable
          - `body` string, nullable
          - `reviewer_name` string, nullable
          - `url` string, nullable
          - `created_at` string, nullable
      - `employee_reviews` object — Employee review and rating metrics.
        - `overall_rating` object, nullable — Overall company rating with star distribution
          - `rating` number, nullable
          - `total_count` integer, nullable
          - `rating_1_count` integer, nullable
          - `rating_2_count` integer, nullable
          - `rating_3_count` integer, nullable
          - `rating_4_count` integer, nullable
          - `rating_5_count` integer, nullable
        - `company_ceo` object, nullable — CEO information including approval rating
          - `ceo_rating` number, nullable — CEO approval rating percentage
        - `primary_industry` object, nullable — Primary industry classification
          - `name` string, nullable
          - `sector_name` string, nullable
        - `culture_and_values_rating` number, nullable
        - `diversity_and_inclusion_rating` number, nullable
        - `work_life_balance_rating` number, nullable
        - `senior_management_rating` number, nullable
        - `compensation_and_benefits_rating` number, nullable
        - `career_opportunities_rating` number, nullable
        - `recommend_to_friend_rating` number, nullable
        - `business_outlook_rating` number, nullable — Business outlook rating
        - `office_locations` object[], nullable
          - `city_name` string, nullable
          - `city_long_name` string, nullable
          - `state` string, nullable
          - `country` string, nullable
          - `continent_name` string, nullable
          - `address_line1` string, nullable
          - `address_line2` string, nullable
          - `zip_code` string, nullable
          - `latitude` number, nullable
          - `longitude` number, nullable
        - `awards` object[], nullable
          - `name` string, nullable
          - `source` string, nullable
          - `year` string, nullable
        - `metadata` object, nullable
          - `last_scraped_at` string, nullable
          - `rating_as_of_date` string, nullable
      - `people` object
        - `decision_makers` PersonProfile[]
          - `crustdata_person_id` integer, nullable
          - `basic_profile` object, nullable
            - `name` string, nullable
            - `headline` string, nullable
            - `current_title` string, nullable
            - `summary` string, nullable
            - `languages` string[], nullable
            - `last_updated` string, nullable
            - `profile_picture_permalink` string, nullable
            - `location` object, nullable
              - …
          - `professional_network` object, nullable
            - `profile_picture_url` string, nullable
            - `profile_picture_permalink` string, nullable
            - `name` string, nullable
            - `headline` string, nullable
            - `current_title` string, nullable
            - `summary` string, nullable
            - `location` object, nullable
              - …
            - `connections` integer, nullable
          - `skills` object, nullable
            - `professional_network_skills` string[], nullable
          - `social_handles` object, nullable
            - `professional_network_identifier` object, nullable
              - …
            - `twitter_identifier` object, nullable
              - …
          - `experience` object, nullable
            - `employment_details` object, nullable
              - …
          - `education` object, nullable
            - `schools` PersonProfileSchool[], nullable
              - …
          - `updated_at` string, nullable
        - `founders` PersonProfile[]
          - `crustdata_person_id` integer, nullable
          - `basic_profile` object, nullable
            - `name` string, nullable
            - `headline` string, nullable
            - `current_title` string, nullable
            - `summary` string, nullable
            - `languages` string[], nullable
            - `last_updated` string, nullable
            - `profile_picture_permalink` string, nullable
            - `location` object, nullable
              - …
          - `professional_network` object, nullable
            - `profile_picture_url` string, nullable
            - `profile_picture_permalink` string, nullable
            - `name` string, nullable
            - `headline` string, nullable
            - `current_title` string, nullable
            - `summary` string, nullable
            - `location` object, nullable
              - …
            - `connections` integer, nullable
          - `skills` object, nullable
            - `professional_network_skills` string[], nullable
          - `social_handles` object, nullable
            - `professional_network_identifier` object, nullable
              - …
            - `twitter_identifier` object, nullable
              - …
          - `experience` object, nullable
            - `employment_details` object, nullable
              - …
          - `education` object, nullable
            - `schools` PersonProfileSchool[], nullable
              - …
          - `updated_at` string, nullable
        - `cxos` PersonProfile[]
          - `crustdata_person_id` integer, nullable
          - `basic_profile` object, nullable
            - `name` string, nullable
            - `headline` string, nullable
            - `current_title` string, nullable
            - `summary` string, nullable
            - `languages` string[], nullable
            - `last_updated` string, nullable
            - `profile_picture_permalink` string, nullable
            - `location` object, nullable
              - …
          - `professional_network` object, nullable
            - `profile_picture_url` string, nullable
            - `profile_picture_permalink` string, nullable
            - `name` string, nullable
            - `headline` string, nullable
            - `current_title` string, nullable
            - `summary` string, nullable
            - `location` object, nullable
              - …
            - `connections` integer, nullable
          - `skills` object, nullable
            - `professional_network_skills` string[], nullable
          - `social_handles` object, nullable
            - `professional_network_identifier` object, nullable
              - …
            - `twitter_identifier` object, nullable
              - …
          - `experience` object, nullable
            - `employment_details` object, nullable
              - …
          - `education` object, nullable
            - `schools` PersonProfileSchool[], nullable
              - …
          - `updated_at` string, nullable
      - `locations` object
        - `country` string, nullable
        - `headquarters` string, nullable
        - `street_address` string, nullable — HQ street address (e.g. "510 Townsend St.")
        - `state` string, nullable
        - `all_office_addresses` string[], nullable
      - `social_profiles` object
        - `crunchbase` object
          - `url` string, nullable
          - `uuid` string, nullable
        - `twitter_url` string, nullable
        - `professional_network` string, nullable — Profile URL for the company. Same value also surfaced at basic_info.professional_network_url.
      - `taxonomy` object
        - `professional_network_specialities` string[], nullable
        - `professional_network_industry` string, nullable
        - `professional_network_industries` string[], nullable
        - `categories` string[], nullable
        - `primary_naics_detail` object, nullable
        - `sic_detail_list` object[], nullable
      - `news` object[], nullable
        - `source` string, nullable — Source of the article (crunchbase or google_news)
        - `article_url` string, nullable — URL of the news article
        - `article_title` string, nullable — Title of the news article
        - `article_publisher_name` string, nullable — Name of the publisher
        - `article_publish_date` string, date, nullable — Date the article was published
        - `publisher_domain` string, nullable — Domain of the publisher (only available for google_news source)
        - `confidence_score` number, nullable — Confidence score for the article-company relationship (only available for google_news source, minimum 0.79)
      - `followers` object
        - `count` integer, nullable
        - `mom_percent` number, nullable
        - `qoq_percent` number, nullable
        - `six_months_growth_percent` number, nullable
        - `yoy_percent` number, nullable
        - `timeseries` object[]
          - `date` string
          - `follower_count` integer
      - `public_launches` object, nullable — Product-launch data including launches, makers, and reviews.
        - `slug` string, nullable
        - `company_name` string, nullable
        - `company_website_url` string, nullable
        - `angel_list_url` string, nullable
        - `facebook_url` string, nullable
        - `instagram_url` string, nullable
        - `github_url` string, nullable
        - `twitter_url` string, nullable
        - `threads_url` string, nullable
        - `linkedin_url` string, nullable
        - `producthunt_url` string, nullable
        - `description` string, nullable
        - `rating` number, nullable
        - `num_upvotes` integer, nullable
        - `num_reviews` integer, nullable
        - `num_followers` integer, nullable
        - `last_updated` string, nullable
        - `categories` string[], nullable — ProductHunt category labels (plain strings).
        - `makers` object[], nullable
          - `username` string, nullable
          - `name` string, nullable
          - `headline` string, nullable
          - `about` string, nullable
          - `num_badges` integer, nullable
          - `num_votes` integer, nullable
          - `website_urls` string[], nullable
          - `last_updated` integer, nullable — Unix epoch seconds
        - `reviews` object[], nullable
          - `review_id` integer, nullable
          - `user` object, nullable
            - `username` string, nullable
            - `name` string, nullable
            - `headline` string, nullable
            - `about` string, nullable
            - `num_badges` integer, nullable
            - `num_votes` integer, nullable
            - `website_urls` string[], nullable
            - `last_updated` integer, nullable
          - `content` string, nullable
          - `posted_at` integer, nullable — Unix epoch seconds
          - `num_upvotes` integer, nullable
          - `num_replies` integer, nullable
          - `last_updated` integer, nullable — Unix epoch seconds
        - `launches` object[], nullable
          - `launch_id` integer, nullable
          - `slug` string, nullable
          - `name` string, nullable
          - `tagline` string, nullable
          - `description` string, nullable
          - `launched_at` integer, nullable — Unix epoch seconds
          - `num_upvotes` integer, nullable
          - `num_comments` integer, nullable
          - `day_rank` integer, nullable
          - `week_rank` integer, nullable
          - `month_rank` integer, nullable
          - `year_rank` integer, nullable
          - `golden_kitty_award` integer, nullable
          - `last_updated` integer, nullable — Unix epoch seconds
      - `market_intel` object, nullable — Market-intelligence data including products and reviews.
        - `slug` string, nullable
        - `company_name` string, nullable
        - `company_website_url` string, nullable
        - `description` string, nullable
        - `year_founded` integer, nullable — Year the company was founded.
        - `head_office_city` string, nullable
        - `head_office_country` string, nullable
        - `num_employees_min` integer, nullable
        - `num_employees_max` integer, nullable
        - `products` object[], nullable
          - `slug` string, nullable
          - `name` string, nullable
          - `category` string, nullable
          - `competitors` string[], nullable
          - `last_updated` integer, nullable — Unix epoch seconds
        - `reviews` object[], nullable
          - `review_id` integer, nullable
          - `headline` string, nullable
          - `summary` string, nullable
          - `overall_rating` integer, nullable
          - `num_upvotes` integer, nullable
          - `num_downvotes` integer, nullable
          - `liked_summary` string, nullable
          - `disliked_summary` string, nullable
          - `purchase_reasons` string, nullable — Stringified list of purchase reasons.
          - `key_decision_factors` string, nullable — Stringified list of key decision factors.
          - `competitors_considered` string, nullable — Stringified list of competitors considered.
          - `evaluation_and_contracting_rating` integer, nullable
          - `integration_and_deployment_rating` integer, nullable
          - `service_and_support_rating` integer, nullable
          - `product_capabilities_rating` integer, nullable
          - `deployment_architecture` string, nullable
          - `deployment_countries` string, nullable
          - `reviewer_title` string, nullable
          - `reviewer_function` string, nullable
          - `reviewer_industry` string, nullable
          - `reviewer_company_size` string, nullable
          - `submitted_at` integer, nullable — Unix epoch seconds
          - `last_updated` integer, nullable — Unix epoch seconds

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized - invalid or missing API key
- `403` — Enrich not allowed for this account
- `404` — No data found
- `500` — Internal server error

---

[API](https://skmtc.dev/crustdata/apis/batch-api.md) · [All operations](https://skmtc.dev/crustdata/apis/batch-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/crustdata/batch-api/revisions/581689e66ae7/schema)