This is one of several requests that demonstrates how Rovi can generate personalized entertainment recommendations for your customers. To understand this feature, we suggest working with these calls in this order:
| This Request . . . | Demonstrates . . . |
|
How an item taste profile gets added to a user taste profile. What an item taste profile looks like. What a user taste profile looks like. How personalized recommendations are generated from a user taste profile. |
ItemVector returns the taste profile of an item. A taste profile consists of normalized scores of Rovi entertainment categories, which are used to populate a user taste profile when a user performs an action on the item.
Note: You won't see the results of this call in an actual implementation of our personalized recommendations. This call and ProfileVector give you an inside look at how our personalization engine works.
| endpoint/itemvector? | nameid=nameid trackid=trackid albumid=albumid amgvideoid=amgvideoid cosmoprogramid=cosmoprogramid |
&apikey=apikey&sig=sig [&size=size] |
| Parameter | Required | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| apikey | Yes | Access code that authorizes your request for data from Rovi. | ||||||||
| endpoint | Yes | Database of the item.
| ||||||||
| sig | Yes | A calculated authorization code. To perform the calculation, execute the MD5 function on the concatenation of the following three strings:
Perform the calculation at the time of each request to be sure it's within a five-minute window of the server time. If you're testing the call in a browser, use our online signature generator to perform the calculation. | ||||||||
| albumid | Conditional | Rovi Music ID for an album, consisting of the prefix MW followed by a ten-digit number. For a request with an album ID, specify an endpoint of music. Here are some album IDs you can use for evaluation tests:
Condition: The request must contain just one of these parameters:
| ||||||||
| amgvideoid | Conditional | All Media Guide (AMG) database ID for a movie or TV series, consisting of a ten-character string that starts with V and is followed by 9 digits with leading spaces. For a request with an amgvideo ID, specify an endpoint of amgvideo. Here are some amgvideo IDs you can use for evaluation tests:
Condition: The request must contain just one of these parameters:
| ||||||||
| cosmoprogramid | Conditional | Cosmo database ID for a movie or television series. For a request with a Cosmo ID, specify an endpoint of video. Here are some Cosmo IDs you can use for evaluation tests:
Condition: The request must contain just one of these parameters:
| ||||||||
| nameid | Conditional | Rovi Name ID for a person or group that has worked in music, consisting of the prefix MN followed by a ten-digit number. For a request with a name ID, specify an endpoint of music. Here are some name IDs you can use for evaluation tests:
Condition: The request must contain just one of these parameters:
| ||||||||
| trackid | Conditional | Rovi Music ID for a song, consisting of the prefix MT followed by a ten-digit number. For a request with a track ID, specify an endpoint of music. Here are some track IDs you can use for evaluation tests:
Condition: The request must contain just one of these parameters:
| ||||||||
| size | No | Number of categories to return. Default is 20. |
| Response | Type | Description |
|---|---|---|
| controlSet | ControlSet | The HTTP response status. |
| id | string | Server transaction ID for the response. |
| Response | Type | Description |
|---|---|---|
| results | result [ ] | Taste profile of the item requested. |