{ "opencollection": "1.0.0", "info": { "name": "Getty Images Assets API", "version": "3" }, "request": { "auth": { "type": "apikey", "key": "Api-Key", "value": "{{Api-Key}}", "placement": "header" } }, "items": [ { "info": { "name": "Assets", "type": "folder" }, "items": [ { "info": { "name": "Get asset change notifications.", "type": "http" }, "http": { "method": "PUT", "url": "{{baseUrl}}/v3/asset-changes/change-sets", "params": [ { "name": "channel_id", "value": "", "type": "query", "description": "Specifies the id of the channel for the asset data. Valid channel ids can be found in the results of the Get Partner Channel query." }, { "name": "batch_size", "value": "", "type": "query", "description": "Specifies the number of assets to return. The default is 2200; maximum is 2200." } ] }, "docs": "# Asset Changes\n\nGet notifications about new, updated or deleted assets for a specific channel.\n\n## Quickstart\n\nYou'll need an API key and an access token to use this resource. \n\nMaximum batch size is 2200.\n\nChange-sets must be confirmed before a new batch of notifications can be retrieved from this endpoint. Use the DELETE asset-changes/change-sets/{change-set-id} endpoint to confirm reciept of these notifications.\n\nValues returned for asset_type include Image, Film, and null. Values returned " }, { "info": { "name": "Confirm asset change notifications.", "type": "http" }, "http": { "method": "DELETE", "url": "{{baseUrl}}/v3/asset-changes/change-sets/:change-set-id", "params": [ { "name": "change-set-id", "value": "", "type": "path", "description": "Specify the change-set-id associated with a transaction resource whose receipt you want to confirm." } ] }, "docs": "# Delete Asset Changes\n\nConfirm asset changes acknowledges receipt of asset changes (from the PUT asset-changes endpoint).\n\n## Quickstart\n\nYou'll need an API key and an access token to use this resource.\n\nUse the change_set_id from the PUT asset-changes/change-sets endpoint to confirm receipt of notifications.\n" }, { "info": { "name": "Get a list of asset change notification channels.", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/v3/asset-changes/channels" }, "docs": "# Get Partner Channels\n\nRetrieves the channel data for the partner. This data can be used to populate the channel_id parameter in the Put Asset Changes query.\n\n## Quickstart\n\nYou'll need an API key and an access token to use this resource.\n\nPartners who have a channel that has been removed should contact their sales representative to be set up again.\n\n" }, { "info": { "name": "Endpoint for acquiring extended licenses with iStock credits for an asset.", "type": "http" }, "http": { "method": "POST", "url": "{{baseUrl}}/v3/asset-licensing/:assetId", "headers": [ { "name": "Accept-Language", "value": "" } ], "params": [ { "name": "assetId", "value": "", "type": "path", "description": "Getty Images assetId - examples 520621493, 112301284" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Endpoint for acquiring extended licenses with iStock credits for an asset." }, { "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": "Add assets to a board", "type": "http" }, "http": { "method": "PUT", "url": "{{baseUrl}}/v3/boards/:board_id/assets", "headers": [ { "name": "Accept-Language", "value": "" } ], "params": [ { "name": "board_id", "value": "", "type": "path", "description": "Specify the board to add assets to." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Add assets to a board" }, { "info": { "name": "Remove assets from a board", "type": "http" }, "http": { "method": "DELETE", "url": "{{baseUrl}}/v3/boards/:board_id/assets", "headers": [ { "name": "Accept-Language", "value": "" } ], "params": [ { "name": "board_id", "value": "", "type": "path", "description": "Specify the board to remove assets from." }, { "name": "asset_ids", "value": "", "type": "query", "description": "List the assets to be removed from the board." } ] }, "docs": "Remove assets from a board" }, { "info": { "name": "Add an asset to a board", "type": "http" }, "http": { "method": "PUT", "url": "{{baseUrl}}/v3/boards/:board_id/assets/:asset_id", "headers": [ { "name": "Accept-Language", "value": "" } ], "params": [ { "name": "board_id", "value": "", "type": "path", "description": "Specify the board to add an asset to." }, { "name": "asset_id", "value": "", "type": "path", "description": "Specify the asset to add to the board. If it is already in the board's asset collection, no action is taken." } ] }, "docs": "Add an asset to a board" }, { "info": { "name": "Remove an asset from a board", "type": "http" }, "http": { "method": "DELETE", "url": "{{baseUrl}}/v3/boards/:board_id/assets/:asset_id", "headers": [ { "name": "Accept-Language", "value": "" } ], "params": [ { "name": "board_id", "value": "", "type": "path", "description": "Specify the board to remove an asset from." }, { "name": "asset_id", "value": "", "type": "path", "description": "Specify the asset to remove from the board." } ] }, "docs": "Remove an asset from a board" }, { "info": { "name": "Get Previously Purchased Images and Video", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/v3/purchased-assets", "headers": [ { "name": "Accept-Language", "value": "" } ], "params": [ { "name": "date_to", "value": "", "type": "query", "description": "If specified, retrieves previous purchases on or before this date. Dates should be submitted in ISO 8601 format (i.e., YYYY-MM-DD)." }, { "name": "page", "value": "", "type": "query", "description": "Identifies page to return. Default is 1." }, { "name": "page_size", "value": "", "type": "query", "description": "Specifies page size. Default is 75, maximum page_size is 100." }, { "name": "date_from", "value": "", "type": "query", "description": "If specified, retrieves previous purchases on or after this date. Dates should be submitted in ISO 8601 format (i.e., YYYY-MM-DD)." }, { "name": "company_purchases", "value": "", "type": "query", "description": "If specified, returns the list of previously purchased assets for all users in your company. Your account must be enabled for this functionality. Contact your Getty Images account rep for more information. Default is false." } ] }, "docs": "This endpoint returns a list of all assets purchased on gettyimages.com by the username used for authentication. \nUse of this endpoint requires configuration changes to your API key. Please contact your sales representative\nto learn more.\n\nYou'll need an API key and access token to use this resource.\n" } ] } ], "bundled": true }