---
title: "Search Event Entities"
method: POST
path: "/data/searches/events"
tags: ["Search"]
---

# Search Event Entities

`POST /data/searches/events`

## Request

- Base URL: `https://api.crunchbase.com/v4`
- URL: `https://api.crunchbase.com/v4/data/searches/events`
- Auth: API key in header `X-cb-user-key`

Can perform more complex filtering based on the query defined in the request body

## Request body

- EventEntitySearch: EntitySearch for Event search
  - `after_id` string, uuid: Used to paginate search results to the next page. after_id should be the uuid of the last item in the current page. May not be provided simultaneously with before_id.
  - `before_id` string, uuid: Used to paginate search results to the previous page. before_id should be the uuid of the first item in the current page. May not be provided simultaneously with after_id.
  - `field_ids` string[], required: The list of field_ids to include in the result
  - `limit` integer: Number of rows to return. Default is 100, min is 1, max is 1000.
  - `order` Order[]: Order in which the search results should be returned
    - `field_id` string, required: Name of the field to sort on
    - `nulls` 'first' | 'last'
    - `sort` 'asc' | 'desc', required
  - `query` Predicate[], required: Search query to perform on the designated entity
    - `field_id` string, required: The field to operate on
    - `operator_id` 'blank' | 'eq' | 'not_eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'starts' | 'contains' | 'not_contains' | 'between' | 'includes' | 'not_includes' | 'includes_all' | 'not_includes_all' | 'domain_eq' | 'not_domain_eq' | 'domain_blank' | 'domain_includes' | 'not_domain_includes', required: Search operations for use in predicates * between - Between. Provide two values in "values" * blank - Is blank. Possible values in "values" is "true" or "false" * contains - Contains * domain_blank - Domain is blank. Possible values in "values" is "true" or "false" * domain_eq - Domain equals * domain_includes - Domain includes any * eq - Equals * gt - Greater than * gte - Greater than or equal to * includes - Includes any * includes_all - Includes all * lt - Less than * lte - Less than or equal to * not_contains - Does not contain * not_domain_eq - Domain not equal * not_domain_includes - Domain does not include * not_eq - Does not equal * not_includes - Does not include * not_includes_all - Does not include all * starts - Starts with
    - `type` 'predicate', required: The type of the query (Predicate)
    - `values` union[]: Values array with data type matching field_id type
      - union
        - string
        - number
        - boolean

## Response `200`

Results are identifiers matching the search query

- object: Search results include Event entities
  - `count` integer: Total number of Event entities
  - `entities` object[]: List of Event entities
    - `properties` Event
      - `categories` EntityIdentifier[]: Descriptive keyword for a Company (e.g. SaaS, Android, Cloud Computing, Medical Device)
        - `entity_def_id` 'acquisition' | 'acquisition_prediction' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'closure_prediction' | 'current_valuation_comparable' | 'current_valuation_estimate' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_prediction' | 'funding_round' | 'growth_event' | 'growth_insight' | 'growth_prediction' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'ipo_prediction' | 'job' | 'key_employee_change' | 'layoff' | 'layoff_prediction' | 'legal_proceeding' | 'location' | 'micro_category' | 'remain_private_prediction' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
        - `image_id` string
        - `permalink` string
        - `uuid` string, uuid, required: Universally Unique Identifier
        - `value` string
      - `category_groups` EntityIdentifier[]: Superset of Industries (e.g. Software, Mobile, Health Care)
        - `entity_def_id` 'acquisition' | 'acquisition_prediction' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'closure_prediction' | 'current_valuation_comparable' | 'current_valuation_estimate' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_prediction' | 'funding_round' | 'growth_event' | 'growth_insight' | 'growth_prediction' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'ipo_prediction' | 'job' | 'key_employee_change' | 'layoff' | 'layoff_prediction' | 'legal_proceeding' | 'location' | 'micro_category' | 'remain_private_prediction' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
        - `image_id` string
        - `permalink` string
        - `uuid` string, uuid, required: Universally Unique Identifier
        - `value` string
      - `created_at` string, date-time
      - `description` string: Text from Event's description
      - `ends_on` string, date: End date of the Event
      - `entity_def_id` 'event': * event - Event
      - `event_type` string[]: Type of Event (e.g. hackathon, meetup, conference)
      - `event_url` Link: An object representing both the url and some labeling text for that url
        - `label` string
        - `value` string
      - `identifier` EntityIdentifier, required: Every entity in the system has a unique identifier that contains all necessary properties to represent it.
        - `entity_def_id` 'acquisition' | 'acquisition_prediction' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'closure_prediction' | 'current_valuation_comparable' | 'current_valuation_estimate' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_prediction' | 'funding_round' | 'growth_event' | 'growth_insight' | 'growth_prediction' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'ipo_prediction' | 'job' | 'key_employee_change' | 'layoff' | 'layoff_prediction' | 'legal_proceeding' | 'location' | 'micro_category' | 'remain_private_prediction' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
        - `image_id` string
        - `permalink` string
        - `uuid` string, uuid, required: Universally Unique Identifier
        - `value` string
      - `image_id` string: The profile image of the event on Crunchbase
      - `image_url` string: The url of the profile image
      - `location_group_identifiers` LocationIdentifier[]: Regions of the Event (e.g. San Francisco Bay Area, Silicon Valley)
        - `entity_def_id` string, required: What type of entity this be
        - `image_id` string: Optionally provided location to obtain an image representing this entity
        - `location_type` 'city' | 'region' | 'country' | 'continent' | 'group'
        - `permalink` string: Optionally provided within Entity Def unique nice id of this entity
        - `uuid` string, uuid, required: Globally unique id of this entity
        - `value` string: Textual representation of this entity (i.e. its "name")
      - `location_identifiers` LocationIdentifier[]: Location of the Event (e.g. Japan, San Francisco, Europe, Asia)
        - `entity_def_id` string, required: What type of entity this be
        - `image_id` string: Optionally provided location to obtain an image representing this entity
        - `location_type` 'city' | 'region' | 'country' | 'continent' | 'group'
        - `permalink` string: Optionally provided within Entity Def unique nice id of this entity
        - `uuid` string, uuid, required: Globally unique id of this entity
        - `value` string: Textual representation of this entity (i.e. its "name")
      - `name` string: Event Name
      - `num_contestants` number: Total number of Contestants at the Event
      - `num_exhibitors` number: Total number of Exhibitors at the Event
      - `num_organizers` number: Total number of Organizers at the Event
      - `num_speakers` number: Total number of Speakers at the Event
      - `num_sponsors` number: Total number of Sponsors for the Event
      - `organizer_identifiers` EntityIdentifier[]: The organizer of the Event
        - `entity_def_id` 'acquisition' | 'acquisition_prediction' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'closure_prediction' | 'current_valuation_comparable' | 'current_valuation_estimate' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_prediction' | 'funding_round' | 'growth_event' | 'growth_insight' | 'growth_prediction' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'ipo_prediction' | 'job' | 'key_employee_change' | 'layoff' | 'layoff_prediction' | 'legal_proceeding' | 'location' | 'micro_category' | 'remain_private_prediction' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
        - `image_id` string
        - `permalink` string
        - `uuid` string, uuid, required: Universally Unique Identifier
        - `value` string
      - `permalink` string
      - `permalink_aliases` string[]: These are the alternative aliases to the primary permalink of the Organization
      - `rank` number: Algorithmic rank assigned to the top profiles on Crunchbase
      - `rank_event` number: Algorithmic rank assigned to the top 100,000 most active Events
      - `registration_url` Link: An object representing both the url and some labeling text for that url
        - `label` string
        - `value` string
      - `short_description` string: A short description of the Event
      - `starts_on` string, date: Start date of the Event
      - `updated_at` string, date-time
      - `uuid` string, uuid
      - `venue_name` string: Name of the Event venue
    - `uuid` string, uuid: UUID of the entity

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Request Failed

---

[API](https://skmtc.dev/crunchbase/apis/predictions-insights-package.md) - [All operations](https://skmtc.dev/crunchbase/apis/predictions-insights-package/llms.txt) - [OpenAPI document](https://skmtc.dev/crunchbase/apis/predictions-insights-package/revisions/e037dd30ce95?raw)