Our Celebrity Recognition API detects the presence of well-known figures in images. It is powered by our face detection and face similarity models, as well as a curated and constantly updated Custom Search Index. Our index now contains over 40,000 figures.

Given an input image, the model detects all faces present and returns a bounding box (defined as a set of vertices) and a match for each, as well as a confidence score. It also returns an attribute category, which describes what type of famous figure the recognized individual is.

In this API's JSON response, match is defined as a string corresponding to the name of the matching famous figure. If a face is not matched with any figure in the index, it is not included in the response. If there are no matches found, the bounding_poly property of the response will be empty.

An example of a full JSON response is shown below:

{
  "status": [
    {
      "status": { "code": "0", "message": "SUCCESS" },
      "response": {
        "input": {
          "hash": <HASH>,
          "charge": 0.00001,
          "media": {
            "url": null,
            "filename": "0x0.jpg",
            "type": "PHOTO",
            "mime_type": "jpeg",
            "mimetype": "image/jpeg",
            "width": 416,
            "height": 416,
            "num_frames": 1,
            "duration": 0
          },
          "id": <ID>,
          "model_type": "CELEBRITY_RECOGNITION",
          "model": "facenet_ensemble_v2",
          "created_on": "2025-04-21T22:43:23.012Z",
          "inference_client_version": "0.0.0",
          "model_version": 1,
          "user_id": <USER_ID>,
          "project_id": <PROJECT_ID>,
          "config_version": 1,
          "config_tag": "default"
        },
        "output": [
          {
            "time": 0,
            "bounding_poly": [
              {
                "classes": [
                  {
                    "class": "Xi Jinping",
                    "score": 0.9602784514427184,
                    "category": "politician"
                  }
                ],
                "vertices": [
                  { "y": 39.45117950439453, "x": 122.70075988769533 },
                  { "y": 286.9783630371094, "x": 122.70075988769533 },
                  { "y": 286.9783630371094, "x": 332.2042541503906 },
                  { "y": 39.45117950439453, "x": 332.2042541503906 }
                ],
                "meta": { "type": "face" },
                "dimensions": {
                  "top": 39.45117950439453,
                  "right": 332.2042541503906,
                  "left": 122.70075988769533,
                  "bottom": 286.9783630371094
                }
              }
            ]
          }
        ]
      }
    }
  ]
}