This method is available on following paths:
  • GET /v0/faces/meta/{meta}/
  • GET /v0/faces/gallery/{gallery}/meta/{meta}/

Returns the list of faces having provided meta. The method is case-sensitive and required the provided string to completely match the stored meta string.

Note that meta needs to be URL encoded, and according to the standard, spaces needs to be encoded as %20 (not +) in this part of the URL.

Parameters

Parameter Description Type Accepted in
gallery

Gallery name

Example:
default
string path
min_id

Pagination parameter

int query
max_id

Pagination parameter

int query
meta

Metadata string to filter faces by.

Example:
Sam Berry
string path

Responses

Status code Description
200

Faces as they are stored

Example:
{
  "next_page": "/faces/?max_id=2333",
  "results": [
    {
      "id": 2563,
      "meta": "Angelina Jolie",
      "photo_hash": "dc7ac54590729669ca869a18d92cd05e",
      "timestamp": "2016-06-13T11:06:42.075754",
      "x1": 225,
      "x2": 307,
      "y1": 345,
      "y2": 428
    },
    {
      "galleries": [
        "default",
        "ppl"
      ],
      "id": 2333,
      "meta": "Sam Berry",
      "photo_hash": "dc7ac54590729669ca869a18d92cd05e",
      "timestamp": "2016-06-13T11:06:42.075754",
      "x1": 225,
      "x2": 307,
      "y1": 345,
      "y2": 428
    }
  ]
}