Skip to main content

Company APIs

Crustdata empowers you to enrich your data with comprehensive information about companies from multiple sources.

  1. Company Enrichment API
  2. Company Discovery: Screening API

Company Enrichment API​

This endpoint enriches company data by retrieving detailed information about one or multiple companies using either their domain, name, or ID.

Key Features​

  • Multi-company enrichment in one call
  • Customize the response by specifying exactly which fields you want to retrieve
  • Capability to enrich companies real-time if the company is not present in our database
  • Enriched information about organizations from our extensive dataset, for example: Glassdoor, LinkedIN, G2, Web Traffic, News Articles, etc.

Using the fields Parameter​

The fields parameter allows you to customize the response by specifying exactly which fields you want to retrieve. This can help reduce payload size and improve performance.

tip
  • Nested Fields: You can specify nested fields up to the levels defined in the response structure (see Field Structure below). Fields nested beyond the allowed levels or within lists (arrays) cannot be individually accessed.
  • Default Fields:
    • Top-Level Non-Object Fields: If you do not specify the fields parameter, the response will include all top-level non-object fields by default (e.g., company_name, company_id).
    • Object Fields: By default, the response will not include object fields like decision_makers and founders.profiles, even if you have access to them. To include these fields, you must explicitly specify them using the fields parameter.
  • User Permissions: Access to certain fields may be restricted based on your user permissions. If you request fields you do not have access to, the API will return an error indicating unauthorized access.

Usage​

You can try out this API here.

Company Enrichment with company_domain​

Ideal for users who have one or more company website domains and need to fetch detailed profiles.

curl 'https://api.crustdata.com/screener/company?company_domain=hubspot.com,google.com' \ --header 'Accept: application/json, text/plain, */*' \ --header 'Accept-Language: en-US,en;q=0.9' \ --header 'Authorization: Token $token'

Company Enrichment with specific fields​

curl 'https://api.crustdata.com/screener/company?company_domain=swiggy.com&fields=company_name,headcount.linkedin_headcount' \ --header 'Authorization: Token $token' \ --header 'Accept: application/json

Getting recently posted jobs and news articles for a company​

curl 'https://api.crustdata.com/screener/company?company_domain=hubspot.com&fields=job_openings,news_articles' \ --header 'Authorization: Token $token' \ --header 'Accept: application/json

Realtime Company Enrichment​

If a company may not be tracked by Crustdata, but you want to enrich them within 10 minutes of the request, you can use this option.

curl --location 'https://api.crustdata.com/screener/company?company_linkedin_url=https://www.linkedin.com/company/usebramble&enrich_realtime=True' \
--header 'Accept: application/json, text/plain, /' \
--header 'Accept-Language: en-US,en;q=0.9' \
--header 'Authorization: Token $token'

Company Discovery: Screening API​

The Company Discovery API allows you to screen and filter companies based on various growth and firmographic criteria.

Key Features​

  • You can provide complex filters to discover companies.
  • You can enrich these companies with the previous Enrichment API.

Usage​

Below are examples of queries you can execute through this API. Try it out here.

Companies that have raised more than $5M in funding and have 50+ employees and majority of employees are in USA​

To get companies that meet the following criteria:

  • Have raised > $5,000,000 in total funding AND
  • Have headcount > 50 AND
  • Have largest headcount country as USA

Crustdata's company_id is a unique, unchanging numeric identifier for each company in our database. Use this request to retrieve information for companies with specific company_id values.

curl 'https://api.crustdata.com/screener/screen/' \
-H 'Accept: application/json, text/plain, /' \
-H 'Accept-Language: en-US,en;q=0.9' \
-H 'Authorization: Token $auth_token' \
-H 'Connection: keep-alive' \
-H 'Content-Type: application/json' \
-H 'Origin: https://crustdata.com' \
--data-raw '{
    "metrics": [
      {
        "metric_name": "linkedin_headcount_and_glassdoor_ceo_approval_and_g2"
      }
    ],
    "filters": {
      "op": "and",
      "conditions": [
                {
                  "column": "crunchbase_total_investment_usd",
                  "type": "=>",
                  "value": 5000000,
                  "allow_null": false
                },
                {
                  "column": "linkedin_headcount",
                  "type": "=>",
                  "value": 50,
                  "allow_null": false
                },
                {
                  "column": "largest_headcount_country",
                  "type": "(.)",
                  "value": "USA",
                  "allow_null": false
                }
      ]
    },
    "hidden_columns": [],
    "offset": 0,
    "count": 100,
    "sorts": []
  }' \
--compressed
info

Note: Currently, the only valid metric_name is linkedin_headcount_and_glassdoor_ceo_approval_and_g2.

Companies with given website domains (exact match)​

This request retrieves metrics for companies whose company_website_domain exactly matches any of the specified domains.

curl 'https://api.crustdata.com/screener/screen/' \
  -H 'Authorization: Token $auth_token' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "metrics": [{"metric_name": $metric_name}],
    "filters": {
        "op": "or",
        "conditions": [
                {"column": "company_website_domain", "type": "=", "value": "kets-quantum.com", "allow_null": false},
                {"column": "company_website_domain", "type": "=", "value": "kasada.io", "allow_null": false},
                {"column": "company_website_domain", "type": "=", "value": "nisos.com", "allow_null": false},
                {"column": "company_website_domain", "type": "=", "value": "nonamesecurity.com", "allow_null": false},
                {"column": "company_website_domain", "type": "=", "value": "medigate.io", "allow_null": false}
            ]
    },
    "hidden_columns": [],
    "offset": 0,
    "count": 100,
    "sorts": []
}' \
  --compressed

Companies with 31 to 50% of their employees skilled in "quality assurance"​

curl 'https://api.crustdata.com/screener/screen/' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Token $token' \
  --data-raw '{
    "metrics":[{"metric_name":"linkedin_headcount_and_glassdoor_ceo_approval_and_g2"}],
    "filters":{
      "op":"and",
      "conditions":[
        {"column": "linkedin_employee_skills_31_to_50_pct", "type":"(.)", "value":"quality assurance", "allow_null":false}
      ]
  },"offset":0,"count":150}' \
  --compressed