SHshutterstock
videos

List updated videos

Changed on

This endpoint lists videos that have been updated in the specified time period to update content management systems (CMS) or digital asset management (DAM) systems. In most cases, use the interval parameter to show videos that were updated recently, but you can also use the start_date and end_date parameters to specify a range of no more than three days. Do not use the interval parameter with either start_date or end_date.

get/v2/videos/updated

Request

Query parameters

start_datestring date-or-date-time

Show videos updated on or after the specified date. The API will default to UTC (00:00:00) if no specific time is provided, ensuring consistency.

end_datestring date-or-date-time

Show videos updated before the specified date. The API will default to UTC (00:00:00) if no specific time is provided, ensuring consistency. Please note that the end date must be at least 5 minutes after the start date.

intervalstring

Show videos updated in the specified time period, where the time period is an interval (like SQL INTERVAL) such as 1 DAY, 6 HOUR, or 30 MINUTE; the default is 1 HOUR, which shows videos that were updated in the hour preceding the request

pageinteger

Page number

per_pageinteger

Number of results per page

sort'newest' | 'oldest'

Sort by oldest or newest videos first

Response

OK

messagestring

Server-generated message, if any

pageinteger

Current page that is returned

per_pageinteger

Number of results per page

total_countinteger

Total count of all results across all pages

Example response

{
  "data": [
    {
      "id": "123456789",
      "updated_time": "2020-05-29T12:10:22-05:00",
      "updates": [
        "addition",
        "edit"
      ]
    }
  ],
  "page": 1,
  "per_page": 5,
  "total_count": 13
}

Changes

  • b43cab3aaaaaRevision changes
    • info

      added the optional property // to the response with the status

  • d2e03e7f655dRevision changes
    • breaking

      for the query request parameter end_date, the format changed from date to date-or-date-time

    • breaking

      for the query request parameter start_date, the format changed from date to date-or-date-time