Build a market landscape

Before you begin

This example was verified with Advanced Financials access. Your API key must include the fields and collections requested below. Check your API package if an endpoint or field is unavailable. Complete your first API request to set CRUNCHBASE_API_KEY in bash or zsh. Commands below include response headers; look for HTTP 200, then read the JSON body.

Persona: Researchers and analysts

Use case: Build a market landscape

Primary APIs: Organization Search

Goal: Find software companies headquartered in California with funding announced since a chosen date. Sort by the most recent funding date to build a research list. This query uses reported funding activity; it does not retrieve a growth prediction.

Endpoint

https://api.crunchbase.com/v4/data/searches/organizations

API Reference & Documentation

Using Search APIs

Search Organizations

Query

This query returns software companies headquartered in California that have raised funding since January 1, 2025, along with their most recent funding date, amount, and round type.

Results are sorted by most recent funding activity, highlighting the most recently funded companies first.

Key Entities

field_id	What this field does	operator_id (these are the compatible operators per field)
identifier	Identifies the company	blank;contains;eq;includes;not_contains;not_eq;not_includes;starts
location_identifiers	Identifies the headquarters of the organization	blank;includes;includes_all;not_includes;not_includes_all
short_description	Includes a short description of the company	blank;contains;not_contains
category_groups	Identifies a list of industry groups associated with the company	blank;includes;includes_all;not_includes;not_includes_all
last_funding_at	Filters by the date of company's last funding round	between;blank;eq;gte;lte
last_funding_total	Filters by the amount of company's last funding round	between;blank;eq;gt;gte;lt;lte;not_eq
last_funding_type	Identifies the company's most recent funding round type	blank;eq;includes;not_eq;not_includes

curl --include --request POST \
  --url 'https://api.crunchbase.com/v4/data/searches/organizations' \
  --header "X-cb-user-key: $CRUNCHBASE_API_KEY" \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "field_ids": [
    "identifier",
    "last_funding_at",
    "last_funding_total",
    "last_funding_type"
  ],
  "query": [
    {
      "type": "predicate",
      "field_id": "category_groups",
      "operator_id": "includes",
      "values": [
        "software-85b6"
      ]
    },
    {
      "type": "predicate",
      "field_id": "location_identifiers",
      "operator_id": "includes",
      "values": [
        "california-united-states"
      ]
    },
    {
      "type": "predicate",
      "field_id": "last_funding_at",
      "operator_id": "gte",
      "values": [
        "2025-01-01"
      ]
    }
  ],
  "order": [
    {
      "sort": "desc",
      "field_id": "last_funding_at"
    }
  ],
  "limit": 3
}'

Response

Response examples below are historical, shortened JSON samples; search samples show one entity and card samples show at most one record per card. Other fields or records may be omitted. Counts and values change; count is the total matching records, while entities contains the returned page.

The response shows matching companies, with each result returning the organization’s identity and most recent funding details.

In the displayed example, Sophia Space most recently raised $245,542 on January 9, 2026.

{
  "count": 2663,
  "entities": [
    {
      "uuid": "baaacb59-1024-4c5c-ba71-8ff539842c07",
      "properties": {
        "identifier": {
          "permalink": "sophia-space",
          "image_id": "1783d14974e244f4ba61791ccf39de2b",
          "uuid": "baaacb59-1024-4c5c-ba71-8ff539842c07",
          "entity_def_id": "organization",
          "value": "Sophia Space"
        },
        "last_funding_type": "seed",
        "last_funding_at": "2026-01-09",
        "last_funding_total": {
          "value_usd": 245542,
          "currency": "USD",
          "value": 245542
        }
      }
    }
  ]
}

Outcome

The example reports 2,663 matching organizations. With limit=3, this request retrieves up to three organizations. Paginate through the results to retrieve additional matches for your market landscape.

Check your result

Inspect the returned fields against your filters. An empty entities array is a valid result: broaden one filter at a time if needed. Fixed dates are example inputs; adjust them to your research period.

Search requests here use limit: 3 for a small first page. For a complete result set, follow search pagination while preserving the filters and ordering. For request failures, use the shared request and retry guidance.