Search
K
Analytics

Retrieve asset download events

get
https://{your-bynder-domain}/v7/analytics/api/v1/asset/download

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 download 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

Successful response

get/v7/analytics/api/v1/asset/download
 
200

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

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

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

Successful response

get/v7/analytics/api/v1/asset/view
 
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

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}
 
200 application/json