Retrieve removed asset events
Retrieve analytics events for removed assets.
get
https://{your-bynder-domain}/v7/analytics/api/v1/asset/remove
Query Parameters
limitinteger
The maximum number of analytics events to retrieve. Allowed values are between 1 and 10000.
Default:1000
Example:100
cursorstring
Cursor mark returned in the response headers to be used for pagination purposes.
Default:MA
Example:MTAwMA
fromDateTimestring(date-time)
Retrieve remove events occurred after this date. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.
Example:2022-01-01T01:00:00.000Z
toDateTimestring(date-time)
Set a date range together with the “fromDateTime” parameter. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.
Example:2022-06-01T01:00:00.000Z
Response
200 application/json
Response
200 application/json
Successful response
assetAuditstring
Example:ACCEPTED
assetIdstring
Example:CA510292-E39E-4B28-AB6444CDD2B1C5C0
assetNamestring
Example:Product Insights
assetTypestring
Example:image
dateTimestring(date-time)
Example:2021-11-15T10:07:57.781Z
eventTypestring
Example:asset.remove
fileNamestring
Example:CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights
idstring
Example:62de6d714e29485a81824fe3
userIdstring
Example:1A84D758-2B3A-141F-8F07D71AA1F223BD
get/v7/analytics/api/v1/asset/remove
Authentication
Query Parameters
200 application/json
Retrieve asset download events
This endpoint only offers data from 2023-11-01. Use the Asset Download endpoint for previous data.
get
https://{your-bynder-domain}/v7/analytics/api/v1/asset/v2/download
Query Parameters
limitinteger
The maximum number of analytics events to retrieve. Allowed values are between 1 and 10000.
Default:1000
Example:100
cursorstring
Cursor mark returned in the response headers to be used for pagination purposes.
Default:MA
Example:MTAwMA
fromDateTimestring(date-time)
Retrieve download events occurred after this date. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.
Example:2022-01-01T01:00
toDateTimestring(date-time)
Set a date range together with the “fromDateTime” parameter. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.
Example:2022-06-01T01:00
Response
200 application/json
Response
200 application/json
Successful response
assetIdstring
Id of the asset
Example:CA510292-E39E-4B28-AB6444CDD2B1C5C0
dateTimestring(date-time)
Date and time when the event occurred
Example:2021-11-15T10:07:57.781Z
downloadReasonsarray[string]
Reasons given on why the asset was downloaded
Example:reason1, reason2
eventIdstring
Id of the event
Example:1408aec2-3114-43dd-be20-ffb1246a5231
eventTypestring
Type of event
Example:AssetDownloadRequested
userIdstring
Id of the user that generated the event
Example:1A84D758-2B3A-141F-8F07D71AA1F223BD
get/v7/analytics/api/v1/asset/v2/download
Authentication
Query Parameters
200 application/json
Retrieve asset view events
This endpoint will be deprecated on July, 15th. Use the Asset Views V2 endpoint instead.
get
https://{your-bynder-domain}/v7/analytics/api/v1/asset/view
Query Parameters
limitinteger
The maximum number of analytics events to retrieve. Allowed values are between 1 and 10000.
Default:1000
cursorstring
Cursor mark returned in the response headers to be used for pagination purposes.
Default:MA
fromDateTimestring(date-time)
Retrieve view events occurred after this date. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.
toDateTimestring(date-time)
Set a date range together with the “fromDateTime” parameter. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.
Response
200
Response
200
Successful response
get/v7/analytics/api/v1/asset/view
Authentication
Query Parameters
200
Retrieve all events performed in a given asset
This endpoint will allow you to retrieve all the events performed in a given asset.
get
https://{your-bynder-domain}/v7/analytics/api/v1/asset/{assetId}
Query Parameters
limitinteger
The maximum number of analytics events to retrieve. Allowed values are between 1 and 10000.
Default:1000
Example:100
cursorstring
Cursor mark returned in the response headers to be used for pagination purposes.
Default:MA
Example:MTAwMA
fromDateTimestring(date-time)
Retrieve events performed in a given asset occurred after this date. ISO8601 format yyyy-mm-ddThh:mm[:ssZ] with optional seconds.
Example:2022-01-01T01:00
toDateTimestring(date-time)
Set a date range together with the “fromDateTime” parameter.
Example:2022-06-01T01:00
Path Parameters
assetIdstringrequired
Asset id.
Example:00000000-0000-0000-0000000000000000
Response
200 application/json
Response
200 application/json
Successful response
assetAuditstring
Example:ACCEPTED
assetIdstring
Example:CA510292-E39E-4B28-AB6444CDD2B1C5C0
assetNamestring
Example:Product Insights
assetTypestring
Example:image
dateTimestring(date-time)
Example:2021-11-15T10:07:57.781+00:00
eventTypestring
Example:asset.download
fileNamestring
Example:CA510292-E39E-4B28-AB6444CDD2B1C5C___Product Insights
idstring
Example:62de6d714e29485a81824fe3
mediaItemIdstring
Example:69293464-7721-4062-9E05EFAF23FE70E7
mediaItemTypestring
Example:original
userIdstring
Example:1A84D758-2B3A-141F-8F07D71AA1F223BD
get/v7/analytics/api/v1/asset/{assetId}
Authentication
Path Parameters
Query Parameters
200 application/json
Search Usage
These endpoints return information related to the specific event. You can enrich these events with specific data about the asset or the user by making use of the Assets API endpoints or the Users API endpoints.