---
title: "Search for events"
method: GET
path: "/v3/search/events"
tags: ["Search"]
---

# Search for events

`GET /v3/search/events`

Use this endpoint to search Getty Images news, sports and entertainment events. Getty Images photographers and videographers cover editorially-relevant events occurring around the world. All images or video clips produced in association with a specific event are assigned the same event ID. Event IDs are part of the metadata returned in Search results. Only content produced under a Getty Images brand name (Getty Images News, Getty Images Sports, Getty Images Entertainment, Film Magic, Wire Image) will be consistently assigned an event ID.

This endpoint will provide events based on a search phrase or editorial segment and an optional from/to date filter. You can show different information in the response by specifying values on the "fields" parameter. The results will include events whose associated images or videos may not be included in your product(s).

This endpoint requires only an API key.  An access token is NOT required.

## Query parameters

- `editorial_segment` 'archival' | 'entertainment' | 'news' | 'publicity' | 'royalty' | 'sport'
- `date_from` string, date-time
- `date_to` string, date-time
- `fields` GettyImagesServicesConnectPublicControllersSearchModelEventFieldValues[]
- `page` integer
- `page_size` integer
- `phrase` string
- `sort_order` 'newest' | 'oldest'

## Headers

- `Accept-Language` string — Provide a header to specify the language of result values. Supported values: cs (iStock only), de, en-GB, en-US, es, fi (iStock only), fr, hu (iStock only), id (iStock only), it, ja, ko (creative assets only), nl, pl (creative assets only), pt-BR, pt-PT, ro (iStock only), ru (creative assets only), sv, th (iStock only), tr, uk (iStock only), vi (iStock only), zh-HK (creative assets only).
- `GI-Country-Code` string — Use of this parameter requires configuration changes to your API key. Please contact your sales representative to learn more.

## Response `200`

OK

- GettyImagesServicesConnectPublicModelsEventsEventsSearchResult
  - `events` GettyImagesServicesConnectPublicModelsEventsEvent[], nullable
    - `child_event_count` integer, nullable
    - `child_events` GettyImagesServicesConnectPublicModelsEventsChildEvent[], nullable
      - `editorial_segments` string[], nullable
      - `hero_image` GettyImagesServicesConnectPublicModelsHeroImage
        - `id` string, nullable
        - `display_sizes` GettyImagesServicesConnectPublicModelsHeroImageDisplaySize[], nullable
          - `name` string, nullable
          - `is_watermarked` boolean
          - `uri` string, nullable
      - `id` integer
      - `image_count` integer, nullable
      - `keywords` GettyImagesServicesConnectPublicModelsEventsEventKeyword[], nullable
        - `keyword_id` string, nullable
        - `text` string, nullable
        - `type` string, nullable
        - `relevance` integer, nullable
      - `location` GettyImagesServicesConnectPublicModelsLocationEvent
        - `city` string, nullable
        - `country` string, nullable
        - `state_province` string, nullable
        - `venue` string, nullable
      - `name` string, nullable
      - `start_date` string, date-time, nullable
      - `type` string, nullable
    - `editorial_segments` string[], nullable
    - `hero_image` GettyImagesServicesConnectPublicModelsHeroImage
      - `id` string, nullable
      - `display_sizes` GettyImagesServicesConnectPublicModelsHeroImageDisplaySize[], nullable
        - `name` string, nullable
        - `is_watermarked` boolean
        - `uri` string, nullable
    - `id` integer
    - `image_count` integer, nullable
    - `keywords` GettyImagesServicesConnectPublicModelsEventsEventKeyword[], nullable
      - `keyword_id` string, nullable
      - `text` string, nullable
      - `type` string, nullable
      - `relevance` integer, nullable
    - `location` GettyImagesServicesConnectPublicModelsLocationEvent
      - `city` string, nullable
      - `country` string, nullable
      - `state_province` string, nullable
      - `venue` string, nullable
    - `name` string, nullable
    - `start_date` string, date-time, nullable
    - `type` string, nullable
  - `result_count` integer

## Other responses

- `400` — InvalidParameterValue
- `401` — AuthorizationTokenRequired
- `403` — UnauthorizedDisplaySize

---

[API](https://skmtc.net/gettyimages/apis/getty-images-api.md) · [All operations](https://skmtc.net/gettyimages/apis/getty-images-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettyimages/getty-images-api/revisions/d069958d92a6/schema)