GEgettyimages
Events

Get metadata for a single event

Changed on

This endpoint returns the detailed event metadata for a specified event. Getty Images news, sports and entertainment photographers and videographers cover editorially relevant events occurring around the world.
All images or video clips produced in association with an event, are assigned the same EventID. EventIDs are part of the meta-data returned in SearchForImages 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 EventID. The Event framework may also be used to group similar content, such as "Hats from the Royal Wedding" or "Odd-ballOffbeat images of the week".

You'll need an API key and access token to use this resource.

get/v3/events/{id}

Request

  • Base URL
    https://api.gettyimages.com (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header Api-Key
    • or OAuth 2
      Authorization codehttps://authentication.gettyimages.com/oauth2/auth
      Client credentials
      Password
      Token URLhttps://authentication.gettyimages.com/oauth2/token
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Path parameters

idinteger required

An event id.

Query parameters

fieldsGettyImagesServicesConnectPublicControllersEventsSingleEventDetailFieldValues[]

A comma separated list of fields to return in the response.

Headers

Accept-Languagestring

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).

Response

OK

child_event_countinteger nullable
editorial_segmentsstring[] nullable
idinteger
image_countinteger nullable
namestring nullable
start_datestring date-time nullable
typestring nullable

Changes

  • 81cb0e852242Revision changes
    • info

      added the enum value child_events to the property items/ of the query request parameter fields

    • info

      added the enum value keywords to the property items/ of the query request parameter fields

    • info

      added the media type application/json for the response with the status