Featured Search Term API 1.1

This API returns the latest search terms that VideoSurf has chosen to feature on the homepage.

URL

• The URL where you can access this API looks like:
  http://apis.videosurf.com/featured_terms/v1.1/

Authentication

• Each use of any VideoSurf API is subject to the Terms Of Use and requires you to provide a valid client_id and client_key
• client_id - A human readable client identifier. Please pick something short and descriptive.
  • Required
  • Type: String
  • Example: client_id=your_domain
• client_key - This is an authorization token issued to you by VideoSurf. Obtain one here.
  • Required
  • Type: String
  • Example: client_key=900d77b8e40e60f0113dccc2973f2ed1

Inputs

• page - Which page of results to return.
  • Optional
  • Type: Number
  • Default: 1
  • Maximum: 5
  • Example: page=2
• num_per_page - How many entities to return per page.
  • Optional
  • Type: Number
  • Default: 20
  • Maximum: 20
  • Example: num_per_page=9
• callback - An optional callback function to wrap the response. This is useful for client side scripting with a technique called JSONP. This will only be utilized if the output_format is json.
  • Optional
  • Type: String
  • Example: callback=my_fn - This will result in a response that looks like this: my_fn({ json goes here });
• output_format - Format of the response, either as a JSON object or serialized PHP.
  • Optional
  • Type: String
  • Default: json
  • Possible Values:

    json	JSON object (more info on json)
    php	Serialized PHP (more info on serialized php)

  • Example: output_format=php

Output

• total_results - The total number of terms returned
• terms - An array of terms with some information about each
  • term - The term text
  • url - The address of the VideoSurf search page for this term