Get Segment By Timestamp

POST

Returns metadata for the segment containing the requested absolute timestamp. This endpoint should only be used for videos that were ingested with frame-level timestamps.

Path parameters

videoRidstringRequired

Request

This endpoint expects an object.

timestampobjectRequired

Response

This endpoint returns an optional object.

ridstring

videoRidstring

dataHandleobject

frameRatedouble

The average frame rate (FPS) of the segment calculated as total frames / duration in seconds.

durationSecondsdouble

The duration of a segment in media time.

timestampsobject

for videos with frame-level timestamps, we provide mappings, otherwise we just include a single list of timestamps.

Segment Video Async

Up Next

Built with

1	curl -X POST https://api.gov.nominal.io/api/video/v1/videos/videoRid/get-segment-by-timestamp \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"timestamp": {
6	"seconds": 1000000,
7	"nanos": 1000000
8	}
9	}'

1	{
2	"rid": "rid",
3	"videoRid": "videoRid",
4	"dataHandle": {
5	"type": "s3",
6	"s3": "dataHandle"
7	},
8	"frameRate": 1.1,
9	"durationSeconds": 1.1,
10	"timestamps": {
11	"type": "timestamps",
12	"timestamps": [
13	{
14	"seconds": 1000000,
15	"nanos": 1000000,
16	"picos": 1
17	},
18	{
19	"seconds": 1000000,
20	"nanos": 1000000,
21	"picos": 1
22	}
23	]
24	}
25	}