{ "opencollection": "1.0.0", "info": { "name": "Getty Images Events API", "version": "3" }, "request": { "auth": { "type": "apikey", "key": "Api-Key", "value": "{{Api-Key}}", "placement": "header" } }, "items": [ { "info": { "name": "Events", "type": "folder" }, "items": [ { "info": { "name": "GET /v3/asset-management/assets/send-events", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/v3/asset-management/assets/send-events", "headers": [ { "name": "Accept-Language", "value": "" } ], "params": [ { "name": "last_offset", "value": "", "type": "query", "description": "Specifies a date/time (with timezone information) for continuing retrieval of events.\r\nEvents occuring _after_ the `last_offset` value provided will be returned." }, { "name": "event_count", "value": "", "type": "query", "description": "Specifies the number of events to return. Default is 50, maximum value is 100." } ] } }, { "info": { "name": "Get metadata for multiple events", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/v3/events", "headers": [ { "name": "Accept-Language", "value": "" } ], "params": [ { "name": "ids", "value": "", "type": "query", "description": "A comma separated list of event ids." }, { "name": "fields", "value": "", "type": "query", "description": "A comma separated list of fields to return in the response." } ] }, "docs": "This endpoint returns the detailed event metadata for all specified events. Getty Images news, sports and entertainment photographers and\nvideographers cover editorially relevant events occurring around the world. All images or video clips produced in association with \nan event, are assigned the same EventID. EventIDs are part of the meta-data returned in SearchForImages Results. Only content \nproduced under a Getty Images brand name (Getty Images News, Getty Images Sports, Getty Images Enterta" }, { "info": { "name": "Get metadata for a single event", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/v3/events/:id", "headers": [ { "name": "Accept-Language", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "An event id." }, { "name": "fields", "value": "", "type": "query", "description": "A comma separated list of fields to return in the response." } ] }, "docs": "This endpoint returns the detailed event metadata for a specified event. Getty Images news, sports and entertainment \nphotographers and videographers cover editorially relevant events occurring around the world. \nAll images or video clips produced in association with an event, are assigned the same EventID. \nEventIDs are part of the meta-data returned in SearchForImages Results. Only content produced under a Getty Images \nbrand name (Getty Images News, Getty Images Sports, Getty Images Entertai" }, { "info": { "name": "Search for events", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/v3/search/events", "headers": [ { "name": "Accept-Language", "value": "" }, { "name": "GI-Country-Code", "value": "" } ], "params": [ { "name": "editorial_segment", "value": "", "type": "query", "description": "Filters to events with a matching editorial segment." }, { "name": "date_from", "value": "", "type": "query", "description": "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." }, { "name": "date_to", "value": "", "type": "query", "description": "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." }, { "name": "fields", "value": "", "type": "query", "description": "Specifies fields to return. Default set is 'id','name','start_date'." }, { "name": "page", "value": "", "type": "query", "description": "Request results starting at a page number (default is 1, maximum is 50)." }, { "name": "page_size", "value": "", "type": "query", "description": "Request number of events to return in each page. Default is 30, maximum page_size is 100." }, { "name": "phrase", "value": "", "type": "query", "description": "Filters to events related to this phrase" }, { "name": "sort_order", "value": "", "type": "query", "description": "Specifies the order in which to sort the results. Default is `newest`." } ] }, "docs": "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)" } ] } ], "bundled": true }