Examples: Search API

Examples for using Crunchbase's Search API endpoints

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.

πŸ“˜

Key Reminder

  • Search API calls must have a request body
  • "field_ids" and "query" are both required parameters to have in the request body
  • all other parameters are optional in the request body
  • "Query" Supports "AND" Only

Example 1: find funding rounds since 2012 that have 4+ investors & raised $10M+ USD

POST https://api.crunchbase.com/api/v4/searches/funding_rounds?user_key=INSERT_KEY_HERE

--Body Request--
{
    "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": "lte",
            "values": ["4"]
        },
        {
            "type": "predicate",
            "field_id": "money_raised",
            "operator_id": "gte",
            "values": [
                {"value": 10000000, "currency": "usd"}
            ]
        }
    ]
}

Example 2: find companies in Europe w/ $25M-$100M USD in funding

POST https://api.crunchbase.com/api/v4/searches/organizations?user_key=INSERT_KEY_HERE

--Body Request--
{
  "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 w/ 101-250 number of employees

POST https://api.crunchbase.com/api/v4/searches/organizations?user_key=INSERT_KEY_HERE

--Body Request--
{
  "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 that have either "101-250" or "501-1000" number of employees (using "Includes Any" search operator)

POST https://api.crunchbase.com/api/v4/searches/organizations?user_key=INSERT_KEY_HERE

--Body Request--
{
  "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"
      ]
    }
  ]
}