endpoint -Specific Update Requests

Celebrity Update Requests

All endpoints follow the basic update process described in General Update Process. You can retrieve Celebrity updates using updateIdin the request:

  • updateId - Unique update token, used to retrieve celebrities since specific update point. It can be combined with limit to ingest specified batch size. 
  • personId - Unique celebrity identifier. To be used for evaluation and troubleshooting purposes, not programmatic ingestion

Programs Update Requests

You can retrieve Programs updates using:

  • updateId - Unique update token, used to retrieve programs since specific update point. It can be combined with limit to ingest specified batch size
  • tmsId - Retrieve specific program records. To be used for evaluation and troubleshooting purposes, not programmatic ingestion

When requesting updates, the most recent version of a program is returned. Updates are not 'replayed' as a log of changes.  For example, if a program is added, modified once, and then modified again, the next call for updates includes the program only once in the response, with latest updateId.  updateIds in a response are not consecutive, although programs are sorted by updateId.

Note: In v3/Programs, updateIdapplies to a TMSId-specific version, so multiple TMSIds with same rootId (language variations of same program) will each be marked with unique updateIds.