Build a market landscape

Before you begin

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.

Primary APIs: Organization Search

Goal: Build a company research list ordered by most recent funding date. This query uses reported funding activity; it does not retrieve a growth prediction.

Endpoint

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

API reference and guides

Query

Find software companies headquartered in California that have raised funding since January 1, 2025. Return their most recent funding date, amount, and round type.

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

Fields used in this query

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`

Scroll to view all columns →

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
}'

Example 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
        }
      }
    }
  ]
}

Interpret the response

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. Follow the pagination guidance above for a complete result set, preserving the filters and ordering. For request failures, use the shared request and retry guidance.