Technical Support Information
Support Center:
Streaming Video Search API Integration Guide
Scott Wojtowicz, Last modified by Scott Wojtowicz April 24 2017 10:07 AM

With the abundance of electronic resources available today, many schools prefer to access their educational assets in one place. Federated Search Engines and other Discovery Tools allow libraries to do just that - easily browse through multiple content sources in their catalog at the same time.

 

The Infobase Search API provides a much needed “Communication Bridge” between our content and any Discovery Tool that our mutual customers may be using. Api.infobase.com quickly indexes search results from our Streaming Video Platform in a universal XML format. These customizable XML search results can then be parsed with search results from other outside sources by an Infobase Discovery Tool partner.

 

In this Search API Integration Guide, you will find everything you need to know to get started as an Infobase Discovery Tool partner.

 

 

Available Products

 

The Infobase Streaming Video Search API is currently available for the following online products:

 

  • Films On Demand
  • Learn360
  • Classroom Video On Demand
  • Access Video On Demand

 

 

Search Query

 

In order to utilize the API, there are certain query parameters that must be added to the URL routing:

 

Api.infobase.com/msearch/accountID/vendorID/productID/searchterm/format

 

"msearch" represents media search which differs from our online database API.

 

Account ID

This is the customer’s Infobase Account ID. If you are using the API to harvest meta-data, there are specific Discovery Tool Partner Account IDs separated by Market/Region that can be provided.

 

Vendor ID

This is the Discovery Tool Partner ID that will be provided once a connection has been established with Infobase.

 

Product ID

This is the Product ID for what Infobase products you would like to query. Here are the currently available product IDs:

 

ACADEMIC

 

 

Master Academic Collection (Package of the following) - ID 105

FOD: Business & Economics Collection - ID 100

FOD: Health Video Collection - ID 97

FOD: Humanities & Social Sciences Collection - ID 98

FOD: Science & Mathematics Collection - ID 99

 

Career & Technical Education Collection (Package of the following) - ID 106

FOD: Careers & Job Search Collection - ID 101

FOD: Family & Consumer Sciences Collection - ID 102

FOD: Guidance & Counseling Collection - ID 103

FOD: Technical Education Collection - ID 104

 

Additional Collections

FMG Archival Films & Newsreels Collection - ID 125

FMG World Cinema Collection - ID 196

 

^Canadian Versions available.

 

Other & International

FOD: United Kingdom - ID 183

FOD: Asia - ID 184

FOD: International Markets - ID 185

FOD: Australia - ID 194

 

Individual Subject Collections (Sold Separately)

FOD: Anthropology - ID 150

FOD: Area Studies - ID 152

FOD: Art & Architecture - ID 153

FOD: Biology - ID 154

FOD: Business & Economics - ID 100

FOD: Careers & Job Search - ID 101

FOD: Communication - ID 157

FOD: Criminal Justice & Law - ID 158

FOD: Earth Science - ID 159

FOD: Education - ID 160

FOD: Engineering - ID 161

FOD: English & Language Arts - ID 162

FOD: Environmental Science - ID 163

FOD: Family & Consumer Sciences - ID 102

FOD: Geography - ID 165

FOD: Guidance & Counseling - ID 103

FOD: Health & Medicine - ID 167

FOD: History - ID 168

FOD: Mathematics - ID 169

FOD: Music & Dance - ID 170

FOD: Philosophy & Religion - ID 171

FOD: Nursing - ID 186

FOD: Physical Science - ID 172

FOD: Political Science - ID 173

FOD: Psychology - ID 174

FOD: Sociology - ID 175

FOD: Technical & Trade Education - ID 176

FOD: Technology & Society - ID 177

FOD: World Languages - ID 178

FOD: Veterinary Science & Technology - ID 214

FOD: Physical Therapy - ID 215

 

 

K-12

 

Classroom Video On Demand - ID 121

CVOD: Career & Technical Education Video Collection - ID 124

 

^Canadian Versions available.

 

Curriculum Video On Demand: Australia - ID 189

 

Additional Collections

FMG Archival Films & Newsreels Collection - ID 125

FMG World Cinema Collection - ID 196

 

Learn360 - ID 136

Learn360 Canada - ID 143

Learn360 International - ID 187

Learn360 Feature Film Collection (Criterion On Demand) - ID 145

 

 

Public Library

 

Access Video On Demand (Package) - ID 107

AVOD: Health & Wellness - ID 108

AVOD: Science, Mathematics & Technology - ID 109

AVOD: Business & Economics - ID 110

AVOD: Arts & Humanities - ID 111

AVOD: Social Sciences - ID 112

AVOD: Careers & Trades - ID 113

AVOD: Home & Family - ID 114

AVOD: Travel & Recreation - ID 115

AVOD: Film & Television - ID 180

 

^Canadian Versions available. 

 

AVOD: Australia - ID 193

AVOD: International Markets - ID 195

 

Additional Collections

FMG Archival Films & Newsreels Collection - ID 125

FMG World Cinema Collection - ID 196

 

 

Search Term

This is the key word(s) you are attempting to search by. In order to get all results, please leave this blank. It is possible to do multiple word searches as well.

 

For example, "Dogs+AND+Cats" / "Dogs+OR+Cats".

 

Format

This is the desired output format you would like the results to be returned in. The available formats are:

 

  •          Xml
  •          Xml-file (this will return a file stream)
  •          Json

 

 

Search Results

 

After you have submitted a search query to the API, you results will then be returned with the available meta-data for your requested records. Here are the currently included meta-data fields for the Infobase API:

 

 

 

Field Name

Description

Database

The Infobase Platform that contains the record

AssetType

Asset type of the record

TitleID

The Infobase specific ID for the record

IsSegment

Whether or not the record is a Full Title or Segment Clip

SegmentNumber 

The Segment Sequence number if the record is not a full title

Title

Title name of the record

Description

Full text description of the record

Source

Source of Record

Record URL

Account specific access URL to the record (authentication required)

runTime

Length of video record

copyrightYear

The Copyright year of the record

language

The primary language of the video record

collections

Listing of any Infobase Streaming Video Collections this title belongs to

subjects

Listing of Subject Areas this record is categorized as

imageURL

a link to the thumbnail image of the video

 

Please note: The Account ID in the Record URL will match the Account ID provided in the original Search Query. Using a customer’s correct account ID is the only way for any authentication settings and usage statistics recording to work properly.

 

 Non-video asset types are now supported as well. Learn360 queries will include Images, Printables, Articles, Audio, and Interactives.

 

Sample Search

 

Here is an example of a Search Query for the term “frogs”:

 

http://api.infobase.com/msearch/0/0/0/frogs/xml

 

The Account ID and Vendor ID have been set to 0 for this example.

 

Once completed, the XML end result would look like this for the first record returned:

 

<Root xmlns:json="http://james.newtonking.com/projects/json" json:id="1">
<Record json:id="2">
<Database>Classroom Video on Demand,Learn360</Database>
<AssetType>Educational Video</AssetType>
<TitleID>80418</TitleID>
<isSegment>false</isSegment>
<Producer>Planet Bonehead Studios</Producer>
<SegmentNumber>0</SegmentNumber>
<Title>A Future For Frogs: Planet Bonehead</Title>
<Description>
Students learn the importance of frogs and toads to healthy ecosystems and to human health as well. The adaptations of these incredible amphibians to their environment is showcased through brilliant photography and video of endangered frog species.
</Description>
<Source>Infobase</Source>
<RecordURL>
http://cvod.infobase.com/PortalPlaylists.aspx?wID=0&xtid=80418
</RecordURL>
<runTime>26:24</runTime>
<copyrightYear>2010</copyrightYear>
<language>English</language>
<collections>CVOD Master, Learn360</collections>
<subjects>
Environmental Problems & Management,Biology,Animal Biology,Environmental Science,Ecosystems,Survey / Basic Concepts,Populations, Communities & Biodiversity,Economics, Conservation, & Public Policy,Survey: Environment,Zoology
</subjects>
</Record>

 

 

Record URL Authentication

 

It is Discovery Tools partner responsibility to ensure that the customer’s Infobase Account ID is used in the provided Record URLs. When harvesting for meta-data, the Account ID retuned in the results will be for the Discovery Tool Partners specific account. Using a customer’s correct account ID is the only way for any authentication settings and usage statistics recording to work properly. Please replace the account ID when being displayed for a mutual customer.

 

<RecordURL>

http://cvod.infobase.com/PortalPlaylists.aspx?wID=0&xtid=80418

</RecordURL>

 

 

 

Additional Help

 

If you have any questions / concerns, or are looking to establish a Discovery Tools partnership with Infobase, please contact our API Support Staff at support@infobaselearning.com.

(1 vote(s))
Helpful
Not helpful