📣 VideoGPT Deep Links Across All Gallery Layouts

Read more
Assets

Export asset IDs and metadata to CSV

Export a library inventory containing asset IDs, titles, and other metadata. This is a media inventory, separate from a viewer-analytics report.

Prepare an authorized export

Use an API key for the intended Cincopa account. Review the API-token guide when creating or managing the credential.

The export endpoint responds with a missing-key error when no key is supplied. A successful export also requires a valid key with access to the account's assets; the URL alone does not grant access.

Build the export request

Example code

https://mhskmcccw8.execute-api.us-east-1.amazonaws.com/default/exportAssetsListToCSV?apikey=YOUR_API_KEY&fields=rid,caption,type,modified,filename,filesize,description,tags

Replace YOUR_API_KEY in your own trusted environment. The selected fields are:

  • rid: asset ID.
  • caption: asset title.
  • type: asset type.
  • modified: modification date.
  • filename: source filename.
  • filesize: size in bytes.
  • description: asset description.
  • tags: asset tags.

Run the request to start the CSV download, then open the result in your spreadsheet or text tool. Import identifier columns as text if your tool would otherwise reformat them.

Handle the key and file carefully

An API key in a request URL can be stored in browser history or logs. Do not share a completed URL, publish it in a page, or include it in screenshots. For automation, keep credentials in a trusted server-side process and restrict access to exported metadata.

If the request fails, check the key, account access, selected field names, and the error returned. Do not send an API key in a public support message.

Understand the result

To convert bytes to KiB, divide by 1024. To convert bytes to MiB, divide by 1024 × 1024. Keep asset IDs unchanged so you can match rows back to your library.

Use asset metadata to update titles, descriptions, and tags. For plays, viewers, and watch-time data, follow Export Analytics Data instead.