SEARCH (3.0.0)

Download OpenAPI specification:Download

Provide the ability to find content by using semantics as precious guides in your discovery experience.

Authentication

APIKeyQueryParam

Security Scheme Type	API Key
Query parameter name:	apikey

FREE SEARCH

Discover titles by using a search tool adapting to the words written down.

SEARCH TEXT

Perform autocompleted text based search. Four types of results can be returned; 1) content titles (like Movie/TV Show titles) 2) stars (cast, directors, celebrities) 3) keywords (theme/mood) 4) related keywords (keywords hyperonyms)

Authorizations:

APIKeyQueryParam

path Parameters

universes

required

Array of strings

Items Enum: "vod" "now" "today" "tonight" "later_tonight" "week"

This parameter defines the content universe in which we want to target content recommendations. If you want to call several universes, you have to separate each of them by a comma (,). "Available universes are:" "vod" "catchup" "For tv recommendations one of the following values should be chosen:" "'now', 'today', 'tonight', 'later_tonight' or 'week'"

text

required

string

Allows free text search. Results can contain movie title, tv show title, star name or Spideo semantic keywords.

query Parameters

types

Array of strings

Items Enum: "content" "keyword" "star"

Can be used if you want to have recommendations only on a specific type of content. Available types are; *content *keyword *star If you want to call several types of content, separate each of them by a comma (,)

Responses

Response samples

200

Content type

application/json


{"search": "gang",
"contents": 
[
{"id": "M148210000",
"title": "The Gang's All Here",
"matchWord": "gang",
"type": "VOD"
},
{"id": "M1754600000",
"title": "Gridiron Gang",
"matchWord": "gang",
"type": "VOD"
},
{"id": "M3901530000",
"title": "A Gang Story",
"matchWord": "gang",
"type": "VOD"
},
{"id": "M190210000",
"title": "The Apple Dumpling Gang",
"matchWord": "gang",
"type": "VOD"
},
{"id": "M5500000",
"title": "The Apple Dumpling Gang Rides Again",
"matchWord": "gang",
"type": "VOD"
},
{"id": "M58990000",
"title": "I Am a Fugitive From a Chain Gang",
"matchWord": "gang",
"type": "VOD"
},
{"id": "M8350970000",
"title": "Bang Gang (A Modern Love Story)",
"matchWord": "gang",
"type": "VOD"
},
{"id": "M5121290000",
"title": "Zip & Zap and the Marble Gang",
"matchWord": "gang",
"type": "VOD"
},
{"id": "M1957140000",
"title": "American Gangster",
"matchWord": "gangster",
"type": "VOD"
},
{"id": "M3929940000",
"title": "Gangster Squad",
"matchWord": "gangster",
"type": "VOD"
}
],
"stars": 
{"results": 
[
{"id": "adrienne_gang",
"name": "Adrienne Gang",
"matchWord": "gang"
},
{"id": "gang_he",
"name": "Gang He",
"matchWord": "gang"
},
{"id": "gang_wu",
"name": "Gang Wu",
"matchWord": "gang"
},
{"id": "gang_hye_jeong",
"name": "Gang Hye Jeong",
"matchWord": "gang"
},
{"id": "gang_eun_gyu",
"name": "Gang Eun-gyu",
"matchWord": "gang"
},
{"id": "ben_ganger",
"name": "Ben Ganger",
"matchWord": "ganger"
},
{"id": "roopali_ganguly",
"name": "Roopali Ganguly",
"matchWord": "ganguly"
}
]
},
"keywords": 
{"results": 
[
{"id": 227,
"keyword": "Gangsters",
"type": "theme",
"matchWord": "gangsters"
}
]
}
}

ADVANCED SEARCH

Combine keywords to find content that matches your points of interest.

Find out more on spideo.tv

SEMANTIC SEARCH

Perform advanced search of content by using Spideo's semantic keywords. Combine themes and wishes to return the most relevant content according to every user's mood. Bear in mind that themes IDs are language dependent. If you need to handle several languages, our team can provide tables of translations during the integration project.

Authorizations:

APIKeyQueryParam

path Parameters

universes

required

Array of strings

Items Enum: "vod" "now" "today" "tonight" "later_tonight" "week"

This parameter defines the content universe in which we want to target content recommendations. If you want to call several universes, you have to separate each of them by a comma (,). "Available universes are:" "vod" "catchup" "For tv recommendations one of the following values should be chosen:" "'now', 'today', 'tonight', 'later_tonight' or 'week'"

query Parameters

themes	string List of themes by id, separated by a comma (,)
wishes	string List of wishes by id, separated by a comma (,)
genres	string Filter the results according to one or several genres.
sections	string If you want to restrict the recommendations to a specific section, you can pass the section code as a value to this parameter.
formattv	string List of TV formats, separated by a comma (,). Available formats are;
language	string Enum: "br" "de" "en" "fr" "id" "ms" "ph" "pt" "es" "th" Language in which the metadata is displayed: en - english (default) fr - french de - german br - brazilian portuguese es - spanish id - indonesian ms - malay ph - filipino *th - thai
details	boolean You can choose to display your meta-data in order to save precious response time. By default this parameter is marked "false", details are not automatically shown. To show details, you have to ask for "true".
skip	integer For similar content content recommendations, you can use this parameter to skip the first results that would be displayed. For example; skip=5 means not showing the first 5 results. Default value=0
limit	integer Number of results requested (max.100). The default value=10
displaysize	boolean You can choose to display the total number of results by using "true". The default value= false

Responses

Response samples

200

Content type

application/json


{"contents": 
[
{"id": "M9276570000",
"title": "Contract to Kill",
"externalIds": 
{"IMDb": "tt5470222",
"TMDB": "423627"
},
"type": "VOD"
},
{"id": "M1265020000",
"title": "Wisegirls",
"externalIds": 
{"IMDb": "tt0284655",
"TMDB": "41209"
},
"type": "VOD"
},
{"id": "M521070000",
"title": "Gattaca",
"externalIds": 
{"IMDb": "tt0119177",
"TMDB": "782"
},
"type": "VOD"
},
{"id": "M3715520000",
"title": "Death on a Factory Farm",
"externalIds": 
{"IMDb": "tt1398992",
"TMDB": "178864"
},
"type": "VOD"
},
{"id": "S22356970000",
"title": "Incorporated",
"externalIds": 
{"IMDb": "tt4118466",
"TMDB": "67684"
},
"type": "VOD"
},
{"id": "M345430000",
"title": "Reservoir Dogs",
"externalIds": 
{"IMDb": "tt0105236",
"TMDB": "500"
},
"type": "VOD"
},
{"id": "M1516140000",
"title": "Infernal Affairs",
"externalIds": 
{"IMDb": "tt0338564",
"TMDB": "10775"
},
"type": "VOD"
},
{"id": "M498470000",
"title": "Donnie Brasco",
"externalIds": 
{"IMDb": "tt0119008",
"TMDB": "9366"
},
"type": "VOD"
},
{"id": "M5460850000",
"title": "The Raid 2",
"externalIds": 
{"IMDb": "tt2265171",
"TMDB": "180299"
},
"type": "VOD"
},
{"id": "M1830510000",
"title": "Shock Corridor",
"externalIds": 
{"IMDb": "tt0057495",
"TMDB": "25504"
},
"type": "VOD"
}
],
"language": "en",
"themes": 
[
{"code": "510",
"display": "undercover"
}
],
"sections": [ ],
"operation": "all"
}

CELEBRITY SEARCH

Perform search requests on a director's name, actress or actor's name and combine this name to help people discover content by celebrities' filmography.

Authorizations:

APIKeyQueryParam

path Parameters

universes

required

Array of strings

Items Enum: "vod" "now" "today" "tonight" "later_tonight" "week"

This parameter defines the content universe in which we want to target content recommendations. If you want to call several universes, you have to separate each of them by a comma (,). "Available universes are:" "vod" "catchup" "For tv recommendations one of the following values should be chosen:" "'now', 'today', 'tonight', 'later_tonight' or 'week'"

query Parameters

themes	string List of themes by id, separated by a comma (,)
wishes	string List of wishes by id, separated by a comma (,)
genres	string Filter the results according to one or several genres.
sections	string If you want to restrict the recommendations to a specific section, you can pass the section code as a value to this parameter.
formattv	string List of TV formats, separated by a comma (,). Available formats are;
stars	string List of cast members by id, separated by a comma (,)
language	string Enum: "br" "de" "en" "fr" "id" "ms" "ph" "pt" "es" "th" Language in which the metadata is displayed: en - english (default) fr - french de - german br - brazilian portuguese es - spanish id - indonesian ms - malay ph - filipino *th - thai
details	boolean You can choose to display your meta-data in order to save precious response time. By default this parameter is marked "false", details are not automatically shown. To show details, you have to ask for "true".
skip	integer For similar content content recommendations, you can use this parameter to skip the first results that would be displayed. For example; skip=5 means not showing the first 5 results. Default value=0
limit	integer Number of results requested (max.100). The default value=10
displaysize	boolean You can choose to display the total number of results by using "true". The default value= false

Responses

Response samples

200

Content type

application/json


{"contents": 
[
{"id": "M435430000",
"title": "Seven",
"externalIds": 
{"IMDb": "tt0114369",
"TMDB": "807"
},
"type": "VOD"
},
{"id": "M745520000",
"title": "Fight Club",
"externalIds": 
{"IMDb": "tt0137523",
"TMDB": "550"
},
"type": "VOD"
},
{"id": "M980750000",
"title": "Snatch",
"externalIds": 
{"IMDb": "tt0208092",
"TMDB": "107"
},
"type": "VOD"
},
{"id": "M373380000",
"title": "True Romance",
"externalIds": 
{"IMDb": "tt0108399",
"TMDB": "319"
},
"type": "VOD"
},
{"id": "M444100000",
"title": "12 Monkeys",
"externalIds": 
{"IMDb": "tt0114746",
"TMDB": "63"
},
"type": "VOD"
},
{"id": "M408080000",
"title": "Interview With the Vampire",
"externalIds": 
{"IMDb": "tt0110148",
"TMDB": "628"
},
"type": "VOD"
},
{"id": "M477090000",
"title": "Sleepers",
"externalIds": 
{"IMDb": "tt0117665",
"TMDB": "819"
},
"type": "VOD"
},
{"id": "M1152850000",
"title": "Ocean's Eleven",
"externalIds": 
{"IMDb": "tt0240772",
"TMDB": "161"
},
"type": "VOD"
},
{"id": "M411500000",
"title": "Legends of the Fall",
"externalIds": 
{"IMDb": "tt0110322",
"TMDB": "4476"
},
"type": "VOD"
},
{"id": "M5696210000",
"title": "Fury",
"externalIds": 
{"IMDb": "tt2713180",
"TMDB": "228150"
},
"type": "VOD"
}
],
"language": "en",
"sections": [ ],
"operation": "all"
}