# Celebrity API Docs

## General Information

\
The [Celebrity API](https://knowledgebase.fabricdata.com/origin/apis-all/celebrity-api-docs/celebrity) is used to get detailed information about the celebrities found in the Entertainment API. Get filmographies, birthdays, images and more!

Each subscription is tied to a solution and that solution contains the celebrities from the programs to which that solution has access. No matter which solution is right for you the implementation will be the same.

The Celebrity API contains endpoints that allow you to run searches for celebrities and celebrity images.

* [**/Celebrity/Search/**](https://knowledgebase.fabricdata.com/origin/apis-all/celebrity#get-search) Allows you to make simple or complex searches for celebrities and celebrity images included in your solution.
* [**/Celebrity/RankedSearch/**](https://knowledgebase.fabricdata.com/origin/apis-all/celebrity#get-rankedsearch) Allows you to find celebrities by name ordered by rank.

Review the examples below to see how to work with the Celebrity API. All metadata and images are intended to be ingested and cached by the customer. Only data records included in your solution will be returned by the API. If you have any questions please reach out to our support team.

*Related API Guides:* [*Entertainment API*](https://knowledgebase.fabricdata.com/origin/apis-all/entertainment-api-docs)*,* [*Video API*](https://knowledgebase.fabricdata.com/origin/apis-all/video-api-docs)*,* [*Image API*](https://knowledgebase.fabricdata.com/origin/apis-all/image-api-docs)*.*

*Open API/Swagger documentation can be found on the Celebrity API page.*

### “Promotional Use” of 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 Origin Nexus, you need to reference or otherwise indicate the title of the film, TV show or game so as to be promotional.

### Get All Celebrity Metadata Records

\
Get all celebrity metadata records with paging.

* Include extra data: Includes=Images, ExternalIds, Descriptions, AlternateNames
* Paging: Skip=0, Take=50

`https://ee.iva-api.com/api/Celebrity/Search/?Skip=0`
\
`&Take=50`
\
`&Includes=Images,Descriptions,ExternalIds,AlternateNames`
\
`&subscription-Key={YourKey}`

### Changed Data Since

\
Retrieve all celebrities that have changed since a certain date-time.

* Include extra data: Includes=Images, ExternalIds, Descriptions, AlternateNames
* Paging: Skip=0, Take=10

`https://ee.iva-api.com/api/celebrity/Search/?Skip=0`
\
`&Take=50`
\
`&ModifiedRecordsSince=2018-06-11%2004:05%20PM`
\
`&Includes=Images,Descriptions,ExternalIds,AlternateNames`
\
`&subscription-key={YourKey}`

### Filmography

\
In order to get a person's filmography you will need to use the Entertainment API.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://knowledgebase.fabricdata.com/origin/apis-all/celebrity-api-docs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.