Get Video Face Detections

Retrieve face detections for a specific file in a collection. Results are paginated with a default limit of 50 faces per request (maximum 100). Use limit and offset parameters to paginate through all results. This API is only available when the collection is created with collection_type ‘face-analysis’

GET /collections/{collection_id}/videos/{file_id}/face-detections

Retrieve face detections for a specific file in a collection

cURL

curl --request GET \
  --url https://api.cloudglue.dev/v1/collections/{collection_id}/videos/{file_id}/face-detections \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.cloudglue.dev/v1/collections/{collection_id}/videos/{file_id}/face-detections"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cloudglue.dev/v1/collections/{collection_id}/videos/{file_id}/face-detections', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cloudglue.dev/v1/collections/{collection_id}/videos/{file_id}/face-detections",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cloudglue.dev/v1/collections/{collection_id}/videos/{file_id}/face-detections"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.cloudglue.dev/v1/collections/{collection_id}/videos/{file_id}/face-detections")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cloudglue.dev/v1/collections/{collection_id}/videos/{file_id}/face-detections")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

200

{
  "collection_id": "<string>",
  "file_id": "<string>",
  "faces": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "face_bounding_box": {
        "height": 0.5,
        "width": 0.5,
        "top": 0.5,
        "left": 0.5
      },
      "frame_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "timestamp": 1,
      "thumbnail_url": "<string>"
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

For details on how to create a face-analysis collection, see Create Collection

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

collection_id · string · required

The ID of the collection

file_id · string · required

The ID of the file

Query Parameters

limit · integer

Maximum number of faces to return

Required range: 1 <= x <= 100

offset · integer

Number of faces to skip

Required range: x >= 0

Response

200

application/json

File face detections

collection_id · string · required

ID of the collection

file_id · string · required

ID of the file

faces · object[] · required

Array of detected faces

Show child attributes

total · integer · required

Total number of faces detected

limit · integer · required

Maximum number of faces returned per request

offset · integer · required

Number of faces skipped