Search API examples

Below are a few common examples of using the Search API endpoints to help you request data for multiple entities & filter that data through various search criteria.

📘
Search request requirements
Include a JSON request body containing both field_ids and query. All other body parameters are optional.
Conditions in query are combined with AND: a result must match every condition.

Replace YOUR_API_KEY with your provisioned key. See Make your first API request for key setup.

Example 1: find funding rounds since 2012 that have at least four investors and $10M raised

POST /v4/data/searches/funding_rounds HTTP/1.1
Host: api.crunchbase.com
X-cb-user-key: YOUR_API_KEY
Accept: application/json
Content-Type: application/json

{
    "field_ids": [
        "identifier",
        "announced_on",
        "funded_organization_identifier",
        "money_raised",
        "investment_type"
    ],
    "order": [
        {
            "field_id": "announced_on",
            "sort": "asc"
        }
    ],
    "query": [
        {
            "type": "predicate",
            "field_id": "announced_on",
            "operator_id": "gte",
            "values": ["2012"]
        },
        {
            "type": "predicate",
            "field_id": "num_investors",
            "operator_id": "gte",
            "values": ["4"]
        },
        {
            "type": "predicate",
            "field_id": "money_raised",
            "operator_id": "gte",
            "values": [
                {"value": 10000000, "currency": "usd"}
            ]
        }
    ]
}

Example 2: find companies in Europe with $25M–$100M in funding

POST /v4/data/searches/organizations HTTP/1.1
Host: api.crunchbase.com
X-cb-user-key: YOUR_API_KEY
Accept: application/json
Content-Type: application/json

{
  "field_ids": [
    "identifier",
    "categories",
    "location_identifiers",
    "short_description",
    "rank_org_company"
  ],
  "order": [
    {
      "field_id": "rank_org_company",
      "sort": "asc"
    }
  ],
  "query": [
    {
      "type": "predicate",
      "field_id": "funding_total",
      "operator_id": "between",
      "values": [
        {
          "value": 25000000,
          "currency": "usd"
        },
        {
          "value": 100000000,
          "currency": "usd"
        }
      ]
    },
    {
      "type": "predicate",
      "field_id": "location_identifiers",
      "operator_id": "includes",
      "values": [
        "6106f5dc-823e-5da8-40d7-51612c0b2c4e"
      ]
    },
    {
      "type": "predicate",
      "field_id": "facet_ids",
      "operator_id": "includes",
      "values": [
        "company"
      ]
    }
  ]
}

Example 3: find biotech companies with 101–250 employees

POST /v4/data/searches/organizations HTTP/1.1
Host: api.crunchbase.com
X-cb-user-key: YOUR_API_KEY
Accept: application/json
Content-Type: application/json

{
  "field_ids": [
    "identifier",
    "categories",
    "location_identifiers",
    "short_description",
    "rank_org_company"
  ],
  "order": [
    {
      "field_id": "rank_org_company",
      "sort": "asc"
    }
  ],
  "query": [
    {
      "type": "predicate",
      "field_id": "num_employees_enum",
      "operator_id": "includes",
      "values": [
        "c_00101_00250"
      ]
    },
    {
      "type": "predicate",
      "field_id": "categories",
      "operator_id": "includes",
      "values": [
        "58842728-7ab9-5bd1-bb67-e8e55f6520a0"
      ]
    }
  ]
}

Example 4: find companies across multiple categories with 101–250 or 501–1,000 employees

POST /v4/data/searches/organizations HTTP/1.1
Host: api.crunchbase.com
X-cb-user-key: YOUR_API_KEY
Accept: application/json
Content-Type: application/json

{
  "field_ids": [
    "identifier",
    "categories",
    "location_identifiers",
    "short_description",
    "rank_org_company"
  ],
  "query": [
    {
      "type": "predicate",
      "field_id": "num_employees_enum",
      "operator_id": "includes",
      "values": [
        "c_00101_00250",
        "c_00501_01000"
      ]
    },
    {
      "type": "predicate",
      "field_id": "categories",
      "operator_id": "includes",
      "values": [
        "b8ca872c-983d-f8dd-3639-2660511203ef",
        "3f21415b-5784-6be6-3722-eb189190b7cd",
        "275ddcbc-27de-ff4f-4e50-6dc26ebf9570"
      ]
    }
  ]
}

Search request requirements

Example 1: find funding rounds since 2012 that have at least four investors and $10M raised

Example 2: find companies in Europe with $25M–$100M in funding

Example 3: find biotech companies with 101–250 employees

Example 4: find companies across multiple categories with 101–250 or 501–1,000 employees

What’s Next