Celebrity

Find Celebrity by Name ordered by rank.

get

Find celebrity using name ordered by rank.

Authorizations

ApiKeyHeader & ApiKeyQuery

Ocp-Apim-Subscription-KeystringRequired

Authorize requests passing your apiKey in HTTP header.

subscription-KeystringRequired

Authorize requests passing your apiKey in Querystring.

Query parameters

StartsWithstringOptional

LimitResultsTointeger · int32Optional

Header parameters

Acceptstring · enumRequired

Accept Header

Possible values:

Responses

200

OK.

application/jsonapplication/xmltext/csvtext/html

CelebrityRankedResponse

FilePathstringOptional

IdstringOptional

NamestringOptional

Rankinteger · int64Optional

Ratingnumber · doubleOptional

204

No content.

400

Bad request.

401

Unauthorized.

403

Forbidden. The subscription key does not have permission to access this method.

404

Not found. The item you requested could not be found or has been deleted.

409

Conflict.

429

Too many requests.

500

Internal server error.

503

Service unavailable.

get

/RankedSearch/

HTTPcURLJavaScriptPython

GET /api/Celebrity/RankedSearch/ HTTP/1.1
Host: api.origin.fabricdata.com
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Accept: application/json

[
  {
    "Description": {
      "Description": "text",
      "DescriptionType": "text",
      "Attribution": "text",
      "Language": "text",
      "LanguageDetail": {
        "Id": 1,
        "IsoCode": "text",
        "Name": "text",
        "FabricId": "text",
        "IETFCode": "text"
      }
    },
    "FilePath": "text",
    "Id": "text",
    "Name": "text",
    "Rank": 1,
    "Rating": 1
  }
]

Search celebrities.

get

Search celebrity meta data and images. Each image in our database is related to a specific movie, TV or game title and is promotional of that title. If you have title pages or articles about that title, then offering an image gallery on that page is obviously promotional. If you are doing editorial about another topic and use an image from IVA, you need to reference or otherwise indicate the title of the film, TV show or game so as to be promotional.

Authorizations

ApiKeyHeader & ApiKeyQuery

Ocp-Apim-Subscription-KeystringRequired

Authorize requests passing your apiKey in HTTP header.

subscription-KeystringRequired

Authorize requests passing your apiKey in Querystring.

Query parameters

PackagestringOptional

Package is based on subscription which will be set at the customer level.

Idsstring[]Optional

Search person using one or more Ids. Ex: Person/123

Skipinteger · int32Optional

Rows to skip, used for paging. Default is 0.

Takeinteger · int32Optional

Rows to return, used for paging. Default is 10, limit is 10.

NamestringOptional

Filter results based on Name.

Culturestring · enumOptional

Specify the country and language

Possible values:

FaceDetails_Ageinteger · int32Optional

People with images with estimated age.

FaceDetails_BeardbooleanOptional

People images with a beard.

FaceDetails_MustachebooleanOptional

People images with a mustache.

FaceDetails_EyeglassesbooleanOptional

People images wearing eyeglasses.

FaceDetails_SunglassesbooleanOptional

People images wearing sunglasses.

FaceDetails_EyesOpenbooleanOptional

People images with eyes open.

FaceDetails_MouthOpenbooleanOptional

People images with mouth open.

FaceDetails_Genderstring · enumOptional

People images based on gender.

Possible values:

FaceDetails_SmilebooleanOptional

People images with smile.

MinImageHeightinteger · int32Optional

People with images greater than or equal to image height.

MinImageWidthinteger · int32Optional

People with images greater than or equal to image width.

ImageTypestring · enumOptional

People with images of type.

Possible values:

Minimum_IvaRatinginteger · int32Optional

Filter results with a minimum Rating greater than or equal to this value. (0 to 100)

ImageTagsstring[]Optional

People with image containing tags.

OfficialImagebooleanOptional

Limit People with official images.

ImageEntertainmentIdsstring[]Optional

People with images from EntertainmentIds. Ex: Movie/1234

BirthNamestringOptional

Filter by birth name.

Genderstring · enumOptional

Filter people by gender. (m or f)

Possible values:

BirthDatestring · date-timeOptional

Birth Date

BirthYearinteger · int32Optional

Birth Year

BirthDayOfMonthinteger · int32Optional

Birth Day of Month

BirthMonthOfYearinteger · int32Optional

Birth Month of Year

DeathDayOfMonthinteger · int32Optional

Birth Day of Month

DeathMonthOfYearinteger · int32Optional

Birth Month of Year

ExternalIdstringOptional

Filter results matching external Id

ExternalIdTypestring · enumOptional

Filter results matching external Id

Possible values:

ModifiedRecordsSincestring · date-timeOptional

Filter results based on timestamp. Returns >= value timestamp (UTC) provided.

SortByTimeStampbooleanOptional

Sort results based on last modified descending. Default is sorted by _score

IncludeDeletedbooleanOptional

Include Soft Deleted Records. Default (false)

SortBystringOptional

SortBy

AwardYearsinteger · int32[]Optional

List of award years to filter on.

AwardProgramIdsstring[]Optional

Limit to awards based on ProgramIds.

AwardPersonIdsstring[]Optional

Limit to awards based on PersonIds.

AwardWinnersbooleanOptional

Limit to award winners.

ExcludeFaceDetailsbooleanOptional

Exclude face details.

NextPageTokenstringOptional

Used for deep paging of record (typically beyond 10,000). Provide the NextPageToken returned from search results when using Timestamp sorting for optimal performance while paging large result sets. Skip is ignored when this parameter is provided.

Header parameters

Acceptstring · enumRequired

Accept Header

Possible values:

Responses

200

OK.

application/jsonapplication/xmltext/csvtext/html

SearchCelebrityResponse

Tookinteger · int64Optional

Totalinteger · int64Optional

MaxScorenumber · doubleOptional

MessagestringOptional

NextPageTokenstringOptional

204

No content.

400

Bad request.

401

Unauthorized.

403

Forbidden. The subscription key does not have permission to access this method.

404

Not found. The item you requested could not be found or has been deleted.

409

Conflict.

429

Too many requests.

500

Internal server error.

503

Service unavailable.

get

/Search/

HTTPcURLJavaScriptPython

GET /api/Celebrity/Search/ HTTP/1.1
Host: api.origin.fabricdata.com
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Accept: application/json

{
  "Took": 1,
  "Total": 1,
  "MaxScore": 1,
  "Hits": [
    {
      "Score": 1,
      "Source": {
        "Id": "text",
        "ProgramType": "text",
        "Packages": [
          "text"
        ],
        "Name": "text",
        "Gender": "text",
        "BirthDate": {
          "Date": "2026-02-23T21:33:01.156Z",
          "Type": "text",
          "Estimated": true
        },
        "BirthDayOfMonth": 1,
        "BirthMonthOfYear": 1,
        "DeathDayOfMonth": 1,
        "DeathMonthOfYear": 1,
        "BirthName": "text",
        "IvaRating": 1,
        "IvaRatingSort": 1,
        "DeathDate": {
          "Date": "2026-02-23T21:33:01.156Z",
          "Type": "text",
          "Estimated": true
        },
        "Modified": "2026-02-23T21:33:01.156Z",
        "AlternateNames": [
          "text"
        ],
        "Images": [
          {
            "FaceDetails": {
              "AgeRange": null,
              "Beard": {
                "Confidence": 1,
                "Value": true
              },
              "BoundingBox": {
                "Height": 1,
                "Left": 1,
                "Top": 1,
                "Width": 1
              },
              "BoundingBoxPixel": {
                "Height": 1,
                "Left": 1,
                "Top": 1,
                "Width": 1
              },
              "Confidence": 1,
              "Emotions": [
                {
                  "Confidence": 1,
                  "Type": "text"
                }
              ],
              "Eyeglasses": {
                "Confidence": 1,
                "Value": true
              },
              "EyesOpen": {
                "Confidence": 1,
                "Value": true
              },
              "Gender": {
                "Confidence": 1,
                "Value": "text"
              },
              "Landmarks": [
                {
                  "Type": "text",
                  "X": 1,
                  "Y": 1
                }
              ],
              "LandmarksPixel": [
                {
                  "Type": "text",
                  "X": 1,
                  "Y": 1
                }
              ],
              "MouthOpen": {
                "Confidence": 1,
                "Value": true
              },
              "Mustache": {
                "Confidence": 1,
                "Value": true
              },
              "Pose": null,
              "Quality": null,
              "Smile": null,
              "Sunglasses": {
                "Confidence": 1,
                "Value": true
              }
            },
            "EntertainmentId": "text",
            "ImageType": "text",
            "Attribution": "text",
            "Width": 1,
            "Height": 1,
            "Violence": 1,
            "Sexuality": 1,
            "Language": "text",
            "LanguageDetail": {
              "Id": 1,
              "IsoCode": "text",
              "Name": "text",
              "FabricId": "text",
              "IETFCode": "text"
            },
            "Tags": [
              "text"
            ],
            "Official": true,
            "FilePath": "text",
            "Modified": "2026-02-23T21:33:01.156Z",
            "Created": "2026-02-23T21:33:01.156Z"
          }
        ],
        "ExternalIds": [
          {
            "Name": "text",
            "Id": "text"
          }
        ],
        "VersionId": 1,
        "Descriptions": [
          {
            "Description": "text",
            "DescriptionType": "text",
            "Attribution": "text",
            "Language": "text",
            "LanguageDetail": {
              "Id": 1,
              "IsoCode": "text",
              "Name": "text",
              "FabricId": "text",
              "IETFCode": "text"
            }
          }
        ],
        "Tags": [
          "text"
        ],
        "TimeStamp": "2026-02-23T21:33:01.156Z",
        "Awards": [
          {
            "Year": 1,
            "Type": "text",
            "Category": "text",
            "CategoryType": "text",
            "ProgramId": "text",
            "PersonIds": [
              "text"
            ],
            "Winner": true,
            "Modified": "2026-02-23T21:33:01.156Z"
          }
        ],
        "Summary": {
          "Image": {
            "FaceDetails": {
              "AgeRange": null,
              "Beard": {
                "Confidence": 1,
                "Value": true
              },
              "BoundingBox": {
                "Height": 1,
                "Left": 1,
                "Top": 1,
                "Width": 1
              },
              "BoundingBoxPixel": {
                "Height": 1,
                "Left": 1,
                "Top": 1,
                "Width": 1
              },
              "Confidence": 1,
              "Emotions": [
                {
                  "Confidence": 1,
                  "Type": "text"
                }
              ],
              "Eyeglasses": {
                "Confidence": 1,
                "Value": true
              },
              "EyesOpen": {
                "Confidence": 1,
                "Value": true
              },
              "Gender": {
                "Confidence": 1,
                "Value": "text"
              },
              "Landmarks": [
                {
                  "Type": "text",
                  "X": 1,
                  "Y": 1
                }
              ],
              "LandmarksPixel": [
                {
                  "Type": "text",
                  "X": 1,
                  "Y": 1
                }
              ],
              "MouthOpen": {
                "Confidence": 1,
                "Value": true
              },
              "Mustache": {
                "Confidence": 1,
                "Value": true
              },
              "Pose": null,
              "Quality": null,
              "Smile": null,
              "Sunglasses": {
                "Confidence": 1,
                "Value": true
              }
            },
            "EntertainmentId": "text",
            "ImageType": "text",
            "Attribution": "text",
            "Width": 1,
            "Height": 1,
            "Violence": 1,
            "Sexuality": 1,
            "Language": "text",
            "LanguageDetail": {
              "Id": 1,
              "IsoCode": "text",
              "Name": "text",
              "FabricId": "text",
              "IETFCode": "text"
            },
            "Tags": [
              "text"
            ],
            "Official": true,
            "FilePath": "text",
            "Modified": "2026-02-23T21:33:01.156Z",
            "Created": "2026-02-23T21:33:01.156Z"
          },
          "Description": {
            "Description": "text",
            "DescriptionType": "text",
            "Attribution": "text",
            "Language": "text",
            "LanguageDetail": {
              "Id": 1,
              "IsoCode": "text",
              "Name": "text",
              "FabricId": "text",
              "IETFCode": "text"
            }
          },
          "ImageCount": 1,
          "AwardCount": 1,
          "ExternalIdCount": 1,
          "DescriptionCount": 1,
          "AlternateNameCount": 1
        }
      },
      "Id": "text"
    }
  ],
  "Message": "text",
  "NextPageToken": "text"
}

Search celebrities.

post

Search celebrity meta data and images. Each image in our database is related to a specific movie, TV or game title and is promotional of that title. If you have title pages or articles about that title, then offering an image gallery on that page is obviously promotional. If you are doing editorial about another topic and use an image from IVA, you need to reference or otherwise indicate the title of the film, TV show or game so as to be promotional.

Authorizations

ApiKeyHeader & ApiKeyQuery

Ocp-Apim-Subscription-KeystringRequired

Authorize requests passing your apiKey in HTTP header.

subscription-KeystringRequired

Authorize requests passing your apiKey in Querystring.

Header parameters

Acceptstring · enumRequired

Accept Header

Possible values:

Body

application/x-www-form-urlencoded

PackagestringOptional

Package is based on subscription which will be set at the customer level.

IdsarrayOptional

Search person using one or more Ids. Ex: Person/123

SkipintegerOptional

Rows to skip, used for paging. Default is 0.

TakeintegerOptional

Rows to return, used for paging. Default is 10, limit is 10.

IncludesarrayOptional

Include sub objects from the person

NamestringOptional

Filter results based on Name.

CulturestringOptional

Specify the country and language

FaceDetails_AgeintegerOptional

People with images with estimated age.

FaceDetails_BeardbooleanOptional

People images with a beard.

FaceDetails_MustachebooleanOptional

People images with a mustache.

FaceDetails_EmotionsarrayOptional

Filter People images by emotions.

FaceDetails_EyeglassesbooleanOptional

People images wearing eyeglasses.

FaceDetails_SunglassesbooleanOptional

People images wearing sunglasses.

FaceDetails_EyesOpenbooleanOptional

People images with eyes open.

FaceDetails_MouthOpenbooleanOptional

People images with mouth open.

FaceDetails_GenderstringOptional

People images based on gender.

FaceDetails_SmilebooleanOptional

People images with smile.

MinImageHeightintegerOptional

People with images greater than or equal to image height.

MinImageWidthintegerOptional

People with images greater than or equal to image width.

ImageTypestringOptional

People with images of type.

ImageViolencearrayOptional

People with image violence scores.

Minimum_IvaRatingintegerOptional

Filter results with a minimum Rating greater than or equal to this value. (0 to 100)

ImageSexualityarrayOptional

People with image sexuality scores.

ImageTagsarrayOptional

People with image containing tags.

OfficialImagebooleanOptional

Limit People with official images.

ImageEntertainmentIdsarrayOptional

People with images from EntertainmentIds. Ex: Movie/1234

BirthNamestringOptional

Filter by birth name.

GenderstringOptional

Filter people by gender. (m or f)

BirthDatestringOptional

Birth Date

BirthYearintegerOptional

Birth Year

BirthDayOfMonthintegerOptional

Birth Day of Month

BirthMonthOfYearintegerOptional

Birth Month of Year

DeathDayOfMonthintegerOptional

Birth Day of Month

DeathMonthOfYearintegerOptional

Birth Month of Year

ExternalIdstringOptional

Filter results matching external Id

ExternalIdTypestringOptional

Filter results matching external Id

ModifiedRecordsSincestringOptional

Filter results based on timestamp. Returns >= value timestamp (UTC) provided.

SortByTimeStampbooleanOptional

Sort results based on last modified descending. Default is sorted by _score

IncludeDeletedbooleanOptional

Include Soft Deleted Records. Default (false)

SortBystringOptional

SortBy

AwardYearsarrayOptional

List of award years to filter on.

AwardTypesarrayOptional

List of award types Ex: Academy, GoldenGlobe, etc.

AwardCategoryTypesarrayOptional

List of award category types Ex: BestPicture, BestActor, etc.

AwardProgramIdsarrayOptional

Limit to awards based on ProgramIds.

AwardPersonIdsarrayOptional

Limit to awards based on PersonIds.

AwardWinnersbooleanOptional

Limit to award winners.

ExcludeFaceDetailsbooleanOptional

Exclude face details.

NextPageTokenstringOptional

Used for deep paging of record (typically beyond 10,000). Provide the NextPageToken returned from search results when using Timestamp sorting for optimal performance while paging large result sets. Skip is ignored when this parameter is provided.

Responses

200

OK.

application/jsonapplication/xmltext/csvtext/html

SearchCelebrityResponse

Tookinteger · int64Optional

Totalinteger · int64Optional

MaxScorenumber · doubleOptional

MessagestringOptional

NextPageTokenstringOptional

204

No content.

400

Bad request.

401

Unauthorized.

403

Forbidden. The subscription key does not have permission to access this method.

404

Not found. The item you requested could not be found or has been deleted.

409

Conflict.

429

Too many requests.

500

Internal server error.

503

Service unavailable.

post

/Search/

HTTPcURLJavaScriptPython

POST /api/Celebrity/Search/ HTTP/1.1
Host: api.origin.fabricdata.com
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Accept: application/json
Content-Type: application/x-www-form-urlencoded
Content-Length: 990

"Package='text'&Ids=[]&Skip=1&Take=1&Includes=[]&Name='text'&Culture='text'&FaceDetails_Age=1&FaceDetails_Beard=true&FaceDetails_Mustache=true&FaceDetails_Emotions=[]&FaceDetails_Eyeglasses=true&FaceDetails_Sunglasses=true&FaceDetails_EyesOpen=true&FaceDetails_MouthOpen=true&FaceDetails_Gender='text'&FaceDetails_Smile=true&MinImageHeight=1&MinImageWidth=1&ImageType='text'&ImageViolence=[]&Minimum_IvaRating=1&ImageSexuality=[]&ImageTags=[]&OfficialImage=true&ImageEntertainmentIds=[]&BirthName='text'&Gender='text'&BirthDate='text'&BirthYear=1&BirthDayOfMonth=1&BirthMonthOfYear=1&DeathDayOfMonth=1&DeathMonthOfYear=1&ExternalId='text'&ExternalIdType='text'&ModifiedRecordsSince='text'&SortByTimeStamp=true&IncludeDeleted=true&SortBy='text'&AwardYears=[]&AwardTypes=[]&AwardCategoryTypes=[]&AwardProgramIds=[]&AwardPersonIds=[]&AwardWinners=true&ExcludeFaceDetails=true&NextPageToken='text'"

{
  "Took": 1,
  "Total": 1,
  "MaxScore": 1,
  "Hits": [
    {
      "Score": 1,
      "Source": {
        "Id": "text",
        "ProgramType": "text",
        "Packages": [
          "text"
        ],
        "Name": "text",
        "Gender": "text",
        "BirthDate": {
          "Date": "2026-02-23T21:33:01.156Z",
          "Type": "text",
          "Estimated": true
        },
        "BirthDayOfMonth": 1,
        "BirthMonthOfYear": 1,
        "DeathDayOfMonth": 1,
        "DeathMonthOfYear": 1,
        "BirthName": "text",
        "IvaRating": 1,
        "IvaRatingSort": 1,
        "DeathDate": {
          "Date": "2026-02-23T21:33:01.156Z",
          "Type": "text",
          "Estimated": true
        },
        "Modified": "2026-02-23T21:33:01.156Z",
        "AlternateNames": [
          "text"
        ],
        "Images": [
          {
            "FaceDetails": {
              "AgeRange": null,
              "Beard": {
                "Confidence": 1,
                "Value": true
              },
              "BoundingBox": {
                "Height": 1,
                "Left": 1,
                "Top": 1,
                "Width": 1
              },
              "BoundingBoxPixel": {
                "Height": 1,
                "Left": 1,
                "Top": 1,
                "Width": 1
              },
              "Confidence": 1,
              "Emotions": [
                {
                  "Confidence": 1,
                  "Type": "text"
                }
              ],
              "Eyeglasses": {
                "Confidence": 1,
                "Value": true
              },
              "EyesOpen": {
                "Confidence": 1,
                "Value": true
              },
              "Gender": {
                "Confidence": 1,
                "Value": "text"
              },
              "Landmarks": [
                {
                  "Type": "text",
                  "X": 1,
                  "Y": 1
                }
              ],
              "LandmarksPixel": [
                {
                  "Type": "text",
                  "X": 1,
                  "Y": 1
                }
              ],
              "MouthOpen": {
                "Confidence": 1,
                "Value": true
              },
              "Mustache": {
                "Confidence": 1,
                "Value": true
              },
              "Pose": null,
              "Quality": null,
              "Smile": null,
              "Sunglasses": {
                "Confidence": 1,
                "Value": true
              }
            },
            "EntertainmentId": "text",
            "ImageType": "text",
            "Attribution": "text",
            "Width": 1,
            "Height": 1,
            "Violence": 1,
            "Sexuality": 1,
            "Language": "text",
            "LanguageDetail": {
              "Id": 1,
              "IsoCode": "text",
              "Name": "text",
              "FabricId": "text",
              "IETFCode": "text"
            },
            "Tags": [
              "text"
            ],
            "Official": true,
            "FilePath": "text",
            "Modified": "2026-02-23T21:33:01.156Z",
            "Created": "2026-02-23T21:33:01.156Z"
          }
        ],
        "ExternalIds": [
          {
            "Name": "text",
            "Id": "text"
          }
        ],
        "VersionId": 1,
        "Descriptions": [
          {
            "Description": "text",
            "DescriptionType": "text",
            "Attribution": "text",
            "Language": "text",
            "LanguageDetail": {
              "Id": 1,
              "IsoCode": "text",
              "Name": "text",
              "FabricId": "text",
              "IETFCode": "text"
            }
          }
        ],
        "Tags": [
          "text"
        ],
        "TimeStamp": "2026-02-23T21:33:01.156Z",
        "Awards": [
          {
            "Year": 1,
            "Type": "text",
            "Category": "text",
            "CategoryType": "text",
            "ProgramId": "text",
            "PersonIds": [
              "text"
            ],
            "Winner": true,
            "Modified": "2026-02-23T21:33:01.156Z"
          }
        ],
        "Summary": {
          "Image": {
            "FaceDetails": {
              "AgeRange": null,
              "Beard": {
                "Confidence": 1,
                "Value": true
              },
              "BoundingBox": {
                "Height": 1,
                "Left": 1,
                "Top": 1,
                "Width": 1
              },
              "BoundingBoxPixel": {
                "Height": 1,
                "Left": 1,
                "Top": 1,
                "Width": 1
              },
              "Confidence": 1,
              "Emotions": [
                {
                  "Confidence": 1,
                  "Type": "text"
                }
              ],
              "Eyeglasses": {
                "Confidence": 1,
                "Value": true
              },
              "EyesOpen": {
                "Confidence": 1,
                "Value": true
              },
              "Gender": {
                "Confidence": 1,
                "Value": "text"
              },
              "Landmarks": [
                {
                  "Type": "text",
                  "X": 1,
                  "Y": 1
                }
              ],
              "LandmarksPixel": [
                {
                  "Type": "text",
                  "X": 1,
                  "Y": 1
                }
              ],
              "MouthOpen": {
                "Confidence": 1,
                "Value": true
              },
              "Mustache": {
                "Confidence": 1,
                "Value": true
              },
              "Pose": null,
              "Quality": null,
              "Smile": null,
              "Sunglasses": {
                "Confidence": 1,
                "Value": true
              }
            },
            "EntertainmentId": "text",
            "ImageType": "text",
            "Attribution": "text",
            "Width": 1,
            "Height": 1,
            "Violence": 1,
            "Sexuality": 1,
            "Language": "text",
            "LanguageDetail": {
              "Id": 1,
              "IsoCode": "text",
              "Name": "text",
              "FabricId": "text",
              "IETFCode": "text"
            },
            "Tags": [
              "text"
            ],
            "Official": true,
            "FilePath": "text",
            "Modified": "2026-02-23T21:33:01.156Z",
            "Created": "2026-02-23T21:33:01.156Z"
          },
          "Description": {
            "Description": "text",
            "DescriptionType": "text",
            "Attribution": "text",
            "Language": "text",
            "LanguageDetail": {
              "Id": 1,
              "IsoCode": "text",
              "Name": "text",
              "FabricId": "text",
              "IETFCode": "text"
            }
          },
          "ImageCount": 1,
          "AwardCount": 1,
          "ExternalIdCount": 1,
          "DescriptionCount": 1,
          "AlternateNameCount": 1
        }
      },
      "Id": "text"
    }
  ],
  "Message": "text",
  "NextPageToken": "text"
}