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.
Servers
- https://api.gettyimages.com
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
GI-Country-Code |
String | No |
Receive regionally relevant search results based on the value specified. Accepts only ISO Alpha-3 country codes. The Countries operation can be used to retrieve the codes. |
Accept-Language |
String | No |
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). |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
page |
Integer | No |
Request results starting at a page number (default is 1, maximum is 50). Default value: 1 |
sort_order |
String | No |
Specifies the order in which to sort the results. Default is Valid values:
|
phrase |
String | No |
Filters to events related to this phrase |
date_from |
String | No |
Filters to events that start on or after this date. Use ISO 8601 format (e.g., 1999-12-31). Defaults to UTC unless otherwise specified. |
date_to |
String | No |
Filters to events that start on or before this date. Use ISO 8601 format (e.g., 1999-12-31). Defaults to UTC unless otherwise specified. |
page_size |
Integer | No |
Request number of events to return in each page. Default is 30, maximum page_size is 100. Default value: 30 |
fields[] |
Array | No |
Specifies fields to return. Default set is 'id','name','start_date'. |
editorial_segment |
String | No |
Filters to events with a matching editorial segment. Valid values:
|
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.