This request offers insight into some of the custom capabilities available from Rovi Advanced Search. This is one of several Advanced Search requests that show how Rovi can return entertainment content customers are looking for.
Advanced Predictive Search can suggest search words or phrases based on the following filters specified in the request, including the following which are unique to Rovi Advanced Search:
Note: The more parameters added to this request, especially boost parameters, the less instantaneous the response.
endpoint/autocomplete?apikey=apikey&sig=sig&query=query&entitytype=entitytype [&available‑clu=available‑clu] [&available‑start=available‑start] [&available‑end=available‑end] [&boost=boost] [&filter=filter] [&format=format] [&size=size]
♫ Music-related requests 日 Movie-related requests ⊑⊒ TV-related requests
|apikey||Yes||Access code that authorizes your request for data from Rovi.|
|endpoint||Yes|| Database to search.
|entitytype||Yes|| Type of content to search for.
To return data from multiple entity types within an endpoint, specify multiple entitytype parameters like this: entitytype=tvseries&entitytype=movie. Note: The top results may come from just one of the entity types. Order of results is determined by relevance and is not deliberately balanced across the searched entity types.
|query||Yes||The search string. Replace spaces with plus (+) or percent20 (%20) symbols. Character case does not affect the results (search is not case-sensitive).|
|sig||Yes|| A calculated, 32-hex-digit authorization code. To perform the calculation, execute the MD5 function on the concatenation of the following three ASCII strings:
Express the alpha hex digits as lower case.
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.
|available-clu||No|| Service ID of a television service to match against. Specified like this: available‑clu=360861. Notes:
|available-end||No|| If you specify the available‑clu parameter, available‑end specifies the end of the broadcast time window in one of the following formats:
If not specified, the end time is two weeks after the time of the request.
|available‑start||No|| If you specify the available‑clu parameter, available‑start specifies the start of the broadcast time window in one of the following formats:
If not specified, the start time is the time of the request.
|boost||No|| Sort-order priorities you can increase or decrease by a decimal value between -1 and 1. To boost the priority of new content by 50%, for example, specify boost=new:0.5. The priorities you can increase and decrease are:
To boost multiple factors, specify multiple parameters: boost=new:0.5&boost=alltime:‑0.4. Note: The sum of the absolute values of all factors must be less than or equal to 1. That is, add all of the absolute values together and make sure the total is less than or equal to 1.
If you are using the available-clu parameter, you can also use the boost parameter to filter out results that are not available on the television service. Specified without a value, like this: boost=availability.
|filter||No|| Field content that determines which results are returned. Like a WHERE clause in an SQL statement, this parameter selects only results with fields that meet your criteria.
The selection operators include:
The following shows which fields you can select.
|format||No|| Format of the returned data: json or xml. The default is XML.
Alternatively you can specify the response format in an HTTP Accept header with either of these Accept field content types:
If you specify both, the format parameter overrides the Accept header.
|size||No||The number of items you want to be returned. The default is 20.|
|controlSet||ControlSet||The HTTP response status.|
|id||string||Server transaction ID for the response.|
|results||string [ ]||List of most popular searches. Results change over time as content and popularity changes.|
|400||Incorrect or invalid request. The reason is shown in the Message object in ControlSet.|