Mashery API Explorer
Navigate, test, debug dozens of APIs
Discover new APIs from our open data commons of RESTful APIs or contributed from our open source I/O Docs GitHub Project
Klout v2 API
Explore:
Can't find your favorite API in the list? Contact us or head straight to I/O Docs GitHub Project to create your own. We are adding more APIs every week!
Mashery API Network:
Sign In using your Mashery ID & your API keys will populate automatically
Community Showcase:
Explore APIs contributed from our open source I/O Docs GitHub project
API Credentials
OPEN Forum API Methods
- GETMost Recent/summaries/most-recent
The Most Recent method will return summaries of the most recent pieces of content on OPEN Forum. - GETMost Viewed/summaries/most-viewed
The Most Viewed method will return summaries of the most viewed pieces of content on OPEN Forum. - GET/summaries/most-commented
The Most Commented method will return summaries of the most commented pieces of content on OPEN Forum. - GET/summaries/most-shared
The Most Shared method will return summaries of the most shared pieces of content on OPEN Forum. - GET/articles/detail
The Article Details method will return full details of a specific article on OPEN Forum. - GET/videos/detail
The Video Details method will return full details of a specific video on OPEN Forum.
Book Requests
- GETISBN Lookup/book/isbn/:isbn/format/:format
Look up a specific book by ISBN. Wildcard searches are not permitted. Either 13 or 10 digit ISBNs are accepted. Dashes are optional. - GETBook Id Lookup/book/id/:id/format/:format
Look up a specific book by Bookshare Id. - GETFull Text Search/book/searchFTS/:text/page/:page/limit/:limit/format/:format
Search for books based on the supplied text matching author, title or content in the book. Note that our search engine defaults to phonetic matching, so you may get results that differ in spelling from your search terms. To prevent the use of phonetic matching or word stemming (e.g. cars matches car), enclose your search term in URL encoded quotes (%22). - GETTitle Search/book/search/title/:text/page/:page/limit/:limit/format/:format
Search for books based on the supplied text matching the title. Note that our search engine defaults to phonetic matching, so you may get results that differ in spelling from your search terms. To prevent the use of phonetic matching or word stemming (e.g. cars matches car), enclose your search term in URL encoded quotes (%22). - GETAuthor Search/book/search/author/:text/page/:page/limit/:limit/format/:format
Search for books based on the supplied text matching the author. Note that our search engine defaults to phonetic matching, so you may get results that differ in spelling from your search terms. To prevent the use of phonetic matching or word stemming (e.g. cars matches car), enclose your search term in URL encoded quotes (%22). - GETTitle/Author Search/book/search/:text/page/:page/limit/:limit/format/:format
Search for books based on the supplied text matching the title or author. Note that our search engine defaults to phonetic matching, so you may get results that differ in spelling from your search terms. To prevent the use of phonetic matching or word stemming (e.g. cars matches car), enclose your search term in URL encoded quotes (%22). - GETDate Published Search/book/search/since/:date/page/:page/limit/:limit/format/:format
Search for books that have been published live on Bookshare on or since the given date. - GETBrowse Latest/book/latest/page/:page/limit/:limit/format/:format
List books that have been published live on Bookshare within the last week. This is essentially a convenience method for the Date Published Search listed above that defaults to the latest week. - GETBrowse Popular/book/popular/page/:page/limit/:limit/format/:format
Search for books that have been downloaded the most times on Bookshare. - GETCategory List/reference/category/list
Get a list of available book categories - GETCategory Search/book/search/category/:category/page/:page/limit/:limit/format/:format
Search for books based on the category (see Category List to get valid category values) - GETGrade List/reference/grade/list/page/:page/limit/:limit/format/:format
Get a list of available grade categories - GETGrade Search/book/search/grade/:grade/page/:page/limit/:limit/format/:format
Search for books based on target grade level (see Grade List to get valid grade values) - GETCombining Multiple Search Criteria/book/search/grade/:grade/category/:category/page/:page/limit/:limit/format/:format
You can combine multiple search criteria, such as category, grade, title, author and full text search The results set is the intersection of the criteria (i.e. AND operator). Note title and author cannot be combined together.
Newspaper / Magazine Requests
- GETPeriodical List Search/periodical/list/page/:page/limit/:limit/format/:format
Get the list of periodicals available - GETPeriodical Edition Search/periodical/id/:id/page/:page/limit/:limit/format/:format
Look up the available editions, including revision numbers, of a given periodical that are in the Bookshare repository - GETPeriodical Edition Lookup/periodical/id/:id/edition/:date/revision/:revision
Look up metadata about a given revision of a given edition of a specific periodical in the Bookshare repository. Revision is optional; if not specified, the default (latest) revision will be provided.
Media: Vehicle Photo
- GET/vehiclephoto/service/findphotosbystyleid
Get vehicle photos by Edmunds vehicle style ID
Pricing: Edmunds True Cost to Own
- GET/tco/newtruecosttoownbystyleidandzip/:styleid/:zip
Get the total 5-year True Cost to Own for a new vehicle - GET/tco/usedtruecosttoownbystyleidandzip/:styleid/:zip
Get the total 5-year True Cost to Own for a used vehicle - GET/tco/newtotalcashpricebystyleidandzip/:styleid/:zip
The Total Cash Price displayed is the vehicle's True Market Value® price plus the Typically Equipped options, destination charge, base tax and fees assessed by your state, and, if applicable, gas guzzler tax; less any widely available manufacturer-to-customer cash rebates. (However, we do not account for other types of cash rebates or incentives because of the variability of those offers and their eligibility requirements.) - GET/tco/usedtotalcashpricebystyleidandzip/:styleid/:zip
The Total Cash Price displayed is the vehicle's True Market Value® price plus the Typically Equipped options, destination charge, base tax and fees assessed by your state, and, if applicable, gas guzzler tax; less any widely available manufacturer-to-customer cash rebates. (However, we do not account for other types of cash rebates or incentives because of the variability of those offers and their eligibility requirements.) - GET/tco/getmakeswithtcodata
Get a list of vehicle makes with available True Cost to Own data - GET/tco/getmodelswithtcodata
Get a list of vehicle models with available True Cost to Own data - GET/tco/getstyleswithtcodatabysubmodel
Get a list of vehicle styles with available True Cost to Own data - GET/tco/resalevaluesbystyleidandzip/:styleid/:zip
Get the resale value of a vehicle over the next 5 years - GET/tco/usedtotalcashpricebystyleidandzip/:styleid/:zip
Get the depreciation value in dollars over the next 5 years for a used vehicle - GET/tco/newtotalcashpricebystyleidandzip/:styleid/:zip
Get the depreciation value in dollars over the next 5 years for a new vehicle
Pricing: Edmunds True Market Value
- GET/tmv/tmvservice/calculatenewtmv
- GET/tmv/tmvservice/calculateusedtmv
- GET/tmv/tmvservice/calculatetypicallyequippedusedtmv
- GET/tmv/tmvservice/findcertifiedpriceforstyle
Pricing: Incentives and Rebates
- GET/incentive/incentiverepository/findbyid
Get incentives and rebates by ID - GET/incentive/incentiverepository/findincentivesbymakeid
Get incentives and rebates by vehicle make ID - GET/incentive/incentiverepository/findincentivesbystyleid
Get incentives and rebates by vehicle style ID - GET/incentive/incentiverepository/findincentivesbycategoryandzipcode
Get incentives and rebates by vehicle category and zipcode - GET/incentive/incentiverepository/findincentivesbymakeidandzipcode
Get incentives and rebates by vehicle make ID and zipcode - GET/incentive/incentiverepository/findincentivesbymodelyearidandzipcode
Get incentives and rebates by vehicle model year ID and zipcode - GET/incentive/incentiverepository/findincentivesbystyleidandzipcode
Get incentives and rebates by vehicle style ID and zipcode
Reviews: UGC Vehicle Ratings and Reviews
- GET/crrrepository/getcrrformakemodelyear
Get vehicle ratings and reviews by providing vehicle make/model/year info
Service: Vehicle Maintenance
- GET/maintenance/action/:id
Get a specific maintenance schedule by ID - GET/maintenance/actionrepository/findbymodelyearid
Get a specific maintenance schedule for a certain vehicle model year ID - GET/maintenance/actionrepository/findmodelyearidswithmaintenanceschedule
Get a list of all vehicle model years with a maintenace schedule
Service: Vehicle Recalls
- GET/maintenance/recall/:id
Get a specific vehicle recall by ID - GET/maintenance/recallrepository/findbymodelyearid
Get a specific vehicle recall for a certain vehicle model year ID
Service: Vehicle Service Bulletin
- GET/maintenance/servicebulletin/:id
Get a specific vehicle service bulletin by ID - GET/maintenance/servicebulletinrepository/findbymodelyearid
Get a specific vehicle service bulletin for a certain vehicle model year ID
Service: Vehicle Notes
- GET/maintenance/stylesnotes/:styleid
Get maintenance notes for a specific vehicle
Service: Local Labor Rate
- GET/maintenance/ziplaborrate/:zipcode
Get service labor rates in dollars per hour for a zipcode
Specs: Vehicle Make
- GET/vehicle/makerepository/findall
Get a list of all new, used and future vehicle makes and links to their models. - GET/vehicle/makerepository/findbyid
Get a vehicle make by its Edmunds Vehicle Make ID - GET/vehicle/makerepository/findfuturemakes
Get a list of all future vehicle makes - GET/vehicle/makerepository/findmakebyname
Get vehicle make details by its name - GET/vehicle/makerepository/findmakesbymodelyear
Get the vehicle make by providing the Model Year ID of the vehicle - GET/vehicle/makerepository/findmakesbypublicationstate
Get vehicle makes that live in a specific publication state - GET/vehicle/makerepository/findnewandused
Get vehicle makes that have the publication state of 'new' and/or 'used' - GET/vehicle/makerepository/findnewandusedmakesbymodelyear
Get vehicle make that has the publication state of 'new' and/or 'used' by the Model Year ID of that vehicle - GET/vehicle/makerepository/findnewmakes
Get vehicle makes that are listed as 'new' on Edmunds.com - GET/vehicle/makerepository/findusedmakes
Get vehicle makes that are listed as 'used' on Edmunds.com
Specs: Vehicle Model
- GET/vehicle/modelrepository/findbyid
Get a vehicle model by its Edmunds Vehicle Model ID - GET/vehicle/modelrepository/findbymakeid
Get a list of vehicle models by vehicle make ID - GET/vehicle/modelrepository/findfuturemodelsbymakeid
Get vehicle make details by its name - GET/vehicle/modelrepository/findmodelbymakemodelname
Get vehicle model details by providing vehicle make and model names - GET/vehicle/modelrepository/findmodelsbymake
Get vehicle model details by vehicle make name - GET/vehicle/modelrepository/findmodelsbymakeandpublicationstate
Get vehicle models by vehicle make name and publication state - GET/vehicle/modelrepository/findmodelsbymakeandyear
Get vehicle model details by providing vehicle make and year - GET/vehicle/modelrepository/findnewandusedmodelsbymakeid
Get a list of new/used vehicle models by vehicle make ID - GET/vehicle/modelrepository/findnewmodelsbymakeid
Get a list of new vehicle models by vehicle make ID - GET/vehicle/modelrepository/findusedmodelsbymakeid
Get a list of used vehicle models by vehicle make ID
Specs: Vehicle Model/Year
- GET/vehicle/modelyearrepository/findbyid
Get a model year vehicle's details by providing its ID - GET/vehicle/modelyearrepository/foryearmakemodel
Get a list of all Make Models by Vehicle Make/Model/Year - GET/vehicle/modelyearrepository/findmodelyearsbymakeandyear
Get a list of all Model Years by Vehicle Make name and Vehicle Year - GET/vehicle/modelyearrepository/findmodelyearsbymakemodel
Get a list of all Model Years by Vehicle Make and Model names - GET/vehicle/modelyearrepository/findnewandusedmodelyearsbymakeidandyear
Get a list of all new/used Model Years by vehicle make ID and vehicle year - GET/vehicle/modelyearrepository/formodelid
Get list of Model Years from vehicle model ID - GET/vehicle/modelyearrepository/findnewmodelyearsbymodelid
Get a list of all new Model Years that fall under the givien vehicle model ID - GET/vehicle/modelyearrepository/findusedmodelyearsbymodelid
Get a list of all used Model Years that fall under the givien vehicle model ID - GET/vehicle/modelyearrepository/findfuturemodelyearsbymodelid
Get a list of all future Model Years that fall under the givien vehicle model ID - GET/vehicle/modelyearrepository/findyearsbycategoryandpublicationstate
Get list of all Model Years that belong to the specified vehicle category and publication state - GET/vehicle/modelyearrepository/finddistinctyearwithnew
Get a list of years under which vehicles are listed as 'NEW' - GET/vehicle/modelyearrepository/finddistinctyearwithneworused
Get a list of years under which vehicles are listed as 'NEW' or 'USED' - GET/vehicle/modelyearrepository/finddistinctyearwithused
Get a list of years under which vehicles are listed as 'USED'
Specs: Vehicle Style & Trim
- GET/vehicle/stylerepository/findbyid
Get vehicle style details by Edmunds vehicle style ID - GET/vehicle/stylerepository/findstylesbymakemodelyear
Get vehicle style details by vehicle make and model names and year - GET/vehicle/stylerepository/findstylesbymodelyearid
Get vehicle style details by Edmunds vehicle model year ID - GET/vehicle/stylerepository/findstylesbystyleids
Get vehicle trims by Edmunds vehicle style IDs - GET/vehicle/stylerepository/findtrimsbystyleids
Get vehicle trims by Edmunds vehicle style IDs
Specs: Vehicle Configuration
- GET/vehicle/styleconfig/:styleId
Get available new vehicle options by vehicle style ID (enclosed under FeaturesMap object) - GET/vehicle/style/:styleId
Get available new vehicle options by vehicle style ID (enclosed under usedEquipment object) - GET/vehicle-directory-ajax/vehicle-options/options
Get available vehicle options by vehicle style ID - GET/vehicle-directory-ajax/vehicle-options/colors
Get available vehicle colors by vehicle style ID - GET/vehicle/equipmentrepository/findbytypeandmodelyearid
Get available new vehicle options by vehicle style ID (enclosed under usedEquipment object) - GET/vehicle/equipment/:equipmentId
Get vehicle equipment by equipment ID
Specs: VIN Decoder
- GET/toolsrepository/vindecoder
Get vehicle style details by VIN
Leagues
- GETleagues/basic/api/leagues
This collection method returns a list of league ids and names. No parameters are required (other than auth key) - GETleagues/:id/basic/api/leagues/:id
Returns detailed information about a single league member, specified by the id parameter below.
Conferences
- GETconferences/basic/api/:parent_resource/:resource_id/conferences
This collection method returns a list of league ids and names.. - GETconferences/:id/basic/api/:parent_resource/:resource_id/conferences/:id
Returns detailed information about a single conference member, specified by the parameters below.
Divisions
- GETdivisions/basic/api/:parent_resource/:resource_id/divisions
This collection method returns a list of division ids and names, specified by the parent_resource and resource_id parameters belows. - GETdivisions/:id/basic/api/:parent_resource/:resource_id/divisions/:id
Returns detailed information about a single division member, specified by the parameters below..
Teams
- GETteams/basic/api/:parent_resource/:resource_id/teams
This collection method returns a list of team ids and names, specified by the parent_resource and resource_id parameters below. - GETteams/:id/basic/api/:parent_resource/:resource_id/teams/:id
Returns detailed information about a single team member, specified by the parameters below. - GETteams/:id/roster/basic/api/:parent_resource/:resource_id/teams/:id/roster
Returns a player roster for a single team member, specified by the parameters below. - GETteams/:id/standings/basic/api/:parent_resource/:resource_id/teams/:id/standings
Returns standings for a single team member, specified by the parameters below.
Persons
- GETpersons/basic/api/:parent_resource/:resource_id/persons
This collection method returns a list of person ids and names, specified by the parent_resource and resource_id parameters belows. - GETpersons/:id/basic/api/:parent_resource/:resource_id/persons/:id
Returns detailed information about a single team member, specified by the parameters below.
Geo
- GETgeo/basic/api/geo
This collection method returns a list of locations and ids, specified by a lat and long or query. - GETgeo/:id/basic/api/geo/:id
Returns detailed information about a single location member, specified by the parameters below. - GETgeo/:id/teams/basic/api/geo/:id/teams
This collection action returns a list of teams and ids for a given location. - GETgeo/:id/content/basic/api/geo/:id/teams
This collection action returns a list of content items and ids for a given location.
Events
- GETevents/basic/api/:parent_resource/:resource_id/events
This collection method returns a list of event ids and names, specified by the parent_resource and resource_id parameters below. - GETevents/:id/basic/api/:parent_resource/:resource_id/events/:id
Returns detailed information about a single event member including scores, specified by the parameters below. - GETevents/:id/boxscore/basic/api/:parent_resource/:resource_id/events/:id/boxscore
Returns a complete boxscore for a single event member, specified by the parameters below. - GETevents/:id/recap/basic/api/:parent_resource/:resource_id/events/:id/recap
Returns a complete recap for a single event member, specified by the parameters below. - GETevents/today/basic/api/:parent_resource/:resource_id/events/today
This collection action returns a list of event ids and names for events currently in progress, about to start, or just ended, specified by the parent_resource and resource_id parameters below. - GETevents/next/basic/api/:parent_resource/:resource_id/events/next
This collection action returns a list of event ids and names for the next two weeks of scheduled events, specified by the parent_resource and resource_id parameters below. - GETevents/last/basic/api/:parent_resource/:resource_id/events/last
This collection action returns a list of event ids and names for the last two weeks of scheduled events, specified by the parent_resource and resource_id parameters below. - GETevents/:season_type/basic/api/:parent_resource/:resource_id/events/:season_type
This collection action returns a list of event ids and names for an entire season, preseason, or postseason, specified by the parent_resource and resource_id parameters below.
Content
- GETcontent/basic/api/:parent_resource/:resource_id/content
This collection method returns a list of all content ids and titles, specified by the parent_resource and resource_id parameters belows. - GETcontent/:id/basic/api/:parent_resource/:resource_id/content/:id
Returns detailed information about a single content item, specified by the parameters below. - GETcontent/:filter/basic/api/:parent_resource/:resource_id/content/:filter
This collection action returns a subset of all content ids and titles, specified by the filter parameter below. - GETcontent/:id/related/basic/api/:parent_resource/:resource_id/content/:id/related
This action returns a set of related information for a single content member, specified by the parameters below.
Sources
- GETsources/basic/api/:parent_resource/:resource_id/sources
This collection method returns a list of content source ids and names for all sources in the system, or a subset specified by a parent_resource. - GETsources/:id/basic/api/:parent_resource/:resource_id/sources/:id
Returns detailed information about a single content source member, specified by the id parameter below.
Trending
- GETteams/basic/api/:parent_resource/:resource_id/teams
This collection method returns a list of the 5 most trending team ids and names in the system, or for a specific parent_resource. - GETpersons/basic/api/:parent_resource/:resource_id/persons
This collection method returns a list of the 5 most trending person ids and names in the system, or for a specific parent_resource.
Hotel APIs
- GETHotel Deals/deal/hotel
The Hotel Deals API delivers data describing hotel 'Deals' discovered on Hotwire.com in the past 24 hours. - GETHotel Shopping/search/hotel
The Hotel Shopping API delivers data describing hotel shopping results similar to those that can be obtained when shopping for hotel rates on Hotwire.com.
Rental Car APIs
- GETRental Car Shopping/search/car
This method allows you to retrieve user objects
Trip Starter APIs
- GETTripStarter Historical Hotel Rates/tripstarter/hotel
This method allows you to retrieve user objects - GETTripStarter Historical Air Fares/tripstarter/air
This method allows you to retrieve user objects
Travel Ticker API
- GETTravel Ticker/deal/travel-ticker
The Travel Ticker Deals API delivers data describing hands-selected travel deals available from the Hotwire Group's Travel Ticker service
Identity Methods
- GET/identity.json/tw/:twitter_id
This method allows you to retrieve a KloutID for numeric twitter_id - GET/identity.json/twitter
This method allows you to retrieve a KloutID for a twitter screen_name - GET/identity.json/klout/:klout_id/tw
This method allows you to retrieve a TwitterId for a numeric KloutId
User Methods
- GET/user.json/:kloutId
This method allows you to retrieve a user. - GET/user.json/:kloutId/score
This method allows you to retrieve a user's Klout Score and deltas. - GET/user.json/:kloutId/topics
This method allows you to retrieve a user's topics. - GET/user.json/:kloutId/influence
This method allows you to retrieve a user's influencers and influencees.
Find Stories by Location
- GETState/states/:state/stories
Retrieve stories for any U.S. state. - GETCity/states/:state/cities/:city/stories
Retrieve stories for a city within a U.S. state. - GETNeighborhood/states/:state/cities/:city/nabes/:neighborhood/stories
Retrieve stories for a neighborhood within a city.
IP Info (Hosted Service)
- GETipinfo/ipinfo/:ipAddress
Returns Quova IP network information and location data
Movie Lists
- GETBox Office/api/public/v1.0/lists/movies/box_office.json
Retrieves Box-Office Movies - GETIn Theaters/api/public/v1.0/lists/movies/in_theaters.json
Retrieves movies currently in theaters - GETOpening Movies/api/public/v1.0/lists/movies/opening.json
Retrieves current opening movies - GETUpcoming Movies/api/public/v1.0/lists/movies/upcoming.json
Retrieves upcoming movies. Results are paginated if they go past the specified page limit
DVD Lists
- GETTop Rentals/api/public/v1.0/lists/dvds/top_rentals.json
Retrieves the current top dvd rentals - GETCurrent Release DVDs/api/public/v1.0/lists/dvds/current_releases.json
Retrieves current release dvds. Results are paginated if they go past the specified page limit - GETNew Release DVDs/api/public/v1.0/lists/dvds/new_releases.json
Retrieves new release dvds. Results are paginated if they go past the specified page limit - GETUpcoming DVDs/api/public/v1.0/lists/dvds/upcoming.json
Retrieves new release dvds. Results are paginated if they go past the specified page limit
Detailed Info
- GETMovies Info/api/public/v1.0/movies/:id.json
Detailed information on a specific movie specified by Id. You can use the movies search endpoint or peruse the lists of movies/dvds to get the urls to movies. - GETCast Info/api/public/v1.0/movies/:id/cast.json
Pulls the complete movie cast for a movie - GETMovie Clips/api/public/v1.0/movies/:id/clips.json
Related movie clips and trailers for a movie - GETMovies Reviews/api/public/v1.0/movies/:id/reviews.json
Retrieves the reviews for a movie. Results are paginated if they go past the specified page limit - GETMovies Similar/api/public/v1.0/movies/:id/similar.json
Shows similar movies for a movie. - GETMovies Alias/api/public/v1.0/movie_alias.json
Provides a movie lookup by an id from a different vendor. Only supports imdb lookup at this time
Search
- GETMovies Search/api/public/v1.0/movies.json
The movies search endpoint for plain text queries. Let's you search for movies!
Top Level Lists
- GETLists Directory/api/public/v1.0/lists.json
Displays the top level lists available in the API. We currently have movie lists and dvd lists available - GETMovie Lists Directory/api/public/v1.0/lists/movies.json
Shows the movie lists we have available - GETDVD Lists Directory/api/public/v1.0/lists/dvds.json
Shows the movie lists we have available
What/Where API
- GETFindBusiness/FindBusiness/
This request returns local Canadian businesses that are most relevant to the search criteria. - GETGetBusinessDetails/GetBusinessDetails/
Gets Business Details. - GETFindDealer/FindDealer/
When applicable, this request returns a list of all dealers/franchises/branches for that business. A business with several locations may have a "parent" listing (primary) and one or more "children" listings. - GETGetTypeAhead/GetTypeAhead/
The type ahead call returns search suggestions based on the characters a user has entered. The user can select the suggested term, saving them from having to enter all the characters for their search term. The suggestions for the "what" and the "where" terms are similar but distinct.
Breaking News API
- GETGet Breaking News Categories/categories.svc/
Returns a list of available categories, including category IDs. - GETGet Breaking News Content by Category/categories.svc/:CategoryID
Returns the latest content for a specific category.
Search News API
- GETSearch/search.svc/:role/
The Search News API allows you to perform basic free-text searches of content from the last three days.
Movie
- GETdata/v1/movie/info
Returns basic information about a movie or TV series. Please set a value for movie, or cosmoid, or movieid. - GETdata/v1/movie/cast
Returns information about cast members with links to images. Please set a value for movie, or cosmoid, or movieid. - GETdata/v1/movie/crew
Returns information about crew members with links to images. Please set a value for movie, or cosmoid, or movieid. - GETdata/v1/movie/images
Returns URLs to images of a movie along with associated image information. Note: Access to images is governed by your subscription level and geographical location. Please set a value for movie, or cosmoid, or movieid. - GETdata/v1/movie/keywords
Returns keywords that apply to a movie and weightings that reflect the relative importance of each keyword. Please set a value for movie, or cosmoid, or movieid. - GETdata/v1/movie/moods
Returns keywords that apply to a movie and weightings that reflect the relative importance of each keyword. Please set a value for movie, or cosmoid, or movieid. - GETdata/v1/movie/related
Returns titles of movies that are related to a movie specified in the request. Please set a value for movie, or cosmoid, or movieid. - GETdata/v1/movie/releases
Returns information about DVDs, Blu-rays, and other movie releases. Please set a value for movie, or cosmoid, or movieid. - GETdata/v1/movie/review
Returns a review of a movie. Please set a value for movie, or cosmoid, or movieid. - GETdata/v1/movie/synopsis
Returns a synopsis of the plot and the name of the author. Please set a value for movie, or cosmoid, or movieid. - GETdata/v1/movie/themes
Returns a list of topics and circumstances that motivate or fit with a movie, along with weightings that reflect the relative importance of each. Please set a value for movie, or cosmoid, or movieid. - GETdata/v1/movie/tones
Returns a list of feelings that motivate or fit with the movie or TV series, along with weightings that reflect the relative importance of each. Please set a value for movie, or cosmoid, or movieid. - GETdata/v1/movie/types
Returns movie subgenres that apply to the movie, along with weightings that reflect the relative importance of each. Please set a value for movie, or cosmoid, or movieid. - GETdata/v1/movie/videos
Returns data for constructing links to movie trailers. Please set a value for movie, or cosmoid, or movieid.
Movie Release
- GETdata/v1/movierelease/info
Returns basic information about a movie release. Please set a value for upcid or moviereleaseid. - GETdata/v1/movierelease/description
Returns the description of a movie release. Please set a value for upcid or moviereleaseid. - GETdata/v1/movierelease/features
Returns the description of a movie release. Please set a value for upcid or moviereleaseid. - GETdata/v1/movierelease/images
Returns URLs to images of a movie release along with associated image information. Note: Access to images is governed by your subscription level and geographical location. Please set a value for upcid or moviereleaseid. - GETdata/v1/movierelease/videos
Returns data for constructing links to trailers of a movie release. Please set a value for upcid or moviereleaseid.
Album
- GETdata/v1/album/info
Returns basic information about an album. Please set a value for album, albumid, amgpopid, or amgclassicalid. - GETdata/v1/album/classicalreview
Returns an editorial review of a classical music album. Please set a value for album, albumid, amgpopid, or amgclassicalid. - GETdata/v1/album/credits
Returns the production credits for an album, a list of the names and roles of the people and groups that produced the album. Please set a value for album, albumid, amgpopid, or amgclassicalid. - GETdata/v1/album/images
Returns URLs to pictures of an album along with associated image information. Note: Access to images is governed by your subscription level and geographical location. Photography credits must be displayed with images. Please set a value for album, albumid, amgpopid, or amgclassicalid. - GETdata/v1/album/moods
Returns a list of terms that describe expressive characteristics of the music, along with weightings that reflect the relative strength of each term. Please set a value for album, albumid, amgpopid, or amgclassicalid. - GETdata/v1/album/primaryreview
Returns the most recent major review of an album. Please set a value for album, albumid, amgpopid, or amgclassicalid. - GETdata/v1/album/releases
Returns information about the releases of an album, including media type and whether it can be purchased. Please set a value for album, albumid, amgpopid, or amgclassicalid. - GETdata/v1/album/styles
Returns a list of musical styles that apply to the music on an album along with weightings that reflect the importance of each style in the music. Please set a value for album, albumid, amgpopid, or amgclassicalid. - GETdata/v1/album/themes
Returns a list of topics, feelings, and circumstances that motivate or fit with the music on an album. Please set a value for album, albumid, amgpopid, or amgclassicalid. - GETdata/v1/album/tracks
Returns information about the songs on a popular music album and the performances on a classical music album. Popular music songs are identified by track IDs; classical music performances are identified by performance IDs. Please set a value for album, albumid, amgpopid, or amgclassicalid.
Composition
- GETdata/v1/composition/info
Returns basic information about a classical music composition. Please set a value for compositionid or amgclassicalid. - GETdata/v1/composition/description
Returns a description of a classical music composition. Please set a value for compositionid or amgclassicalid. - GETdata/v1/composition/parts
Returns the names of the parts or movements of a classical music composition, each of which is recorded as a single track. Please set a value for compositionid or amgclassicalid. - GETdata/v1/composition/releases
Returns a list of album releases that feature a performance of a composition. Please set a value for compositionid or amgclassicalid.
Performance
- GETdata/v1/performance/info
Returns basic information about a classical music performance. Please set a value for performanceid or amgclassicalid. - GETdata/v1/performance/composition
Returns information about a composition played in a classical music performance. Please set a value for performanceid or amgclassicalid. - GETdata/v1/performance/credits
Returns the names and roles of the people, groups, and organizations that contributed to a classical music performance and the album release. Please set a value for performanceid or amgclassicalid. - GETdata/v1/performance/images
Returns URLs to images of an album that contains the recording a classical music performance, along with associated image information. Note: Access to images is governed by your subscription level and geographical location. Photography credits must be displayed with images. Please set a value for performanceid or amgclassicalid. - GETdata/v1/performance/release
Returns information about an album release that contains the recording of a classical music performance. Please set a value for performanceid or amgclassicalid.
Release
- GETdata/v1/release/info
Returns basic information about an LP, CD, DVD, cassette, download, or other release of an album. Please set a value for eanid, upcid, releaseid, amgpopid, or amgclassicalid. - GETdata/v1/release/classicalreview
Returns an editorial review of a classical music album. Please set a value for eanid, upcid, releaseid, amgpopid, or amgclassicalid. - GETdata/v1/release/credits
Returns the names and roles of the people, groups, and organizations that contributed to a release. Please set a value for eanid, upcid, releaseid, amgpopid, or amgclassicalid. - GETdata/v1/release/images
Returns URLs to pictures of the album release along with associated image information. Note: Access to images is governed by your subscription level and geographical location. Photography credits must be displayed with images. Please set a value for eanid, upcid, releaseid, amgpopid, or amgclassicalid. - GETdata/v1/release/moods
Returns a list of terms that describe expressive characteristics of the music, along with weightings that reflect the relative strength of each term. Please set a value for eanid, upcid, releaseid, amgpopid, or amgclassicalid. - GETdata/v1/release/performances
Returns information about the performances on a release of a classical music album. Please set a value for eanid, upcid, releaseid, amgpopid, or amgclassicalid. - GETdata/v1/release/primaryreview
Returns the most recent major review of a release of an album. Please set a value for eanid, upcid, releaseid, amgpopid, or amgclassicalid. - GETdata/v1/release/styles
Returns a list of musical styles relevant to the music on an album release along with weightings that reflect the importance of each style in the music. Please set a value for eanid, upcid, releaseid, amgpopid, or amgclassicalid. - GETdata/v1/release/themes
Returns a list of topics, feelings, and circumstances that motivate or fit with the music on an album release, along with weightings that reflect the relative importance of each. Please set a value for eanid, upcid, releaseid, amgpopid, or amgclassicalid. - GETdata/v1/release/tracks
Returns information about the tracks on a release of an album. Please set a value for eanid, upcid, releaseid, amgpopid, or amgclassicalid.
Song
- GETdata/v1/song/info
Returns basic information about a song. Please set a value for track, trackid, isrcid, muzeid, amgpoptrackid, or amgclassicaltrackid. - GETdata/v1/song/appearances
Returns a list of albums and videos a song track appears on. Please set a value for track, trackid, isrcid, muzeid, amgpoptrackid, or amgclassicaltrackid. - GETdata/v1/song/review
Returns the most recent major review of a song. Please set a value for track, trackid, isrcid, muzeid, amgpoptrackid, or amgclassicaltrackid.
Descriptor
- GETdata/v1/descriptor/moviegenres
Returns the movie genres and subgenres recognized by Rovi DVDs. - GETdata/v1/descriptor/musicgenres
Returns the music genres, subgenres, and styles recognized by Rovi Music. - GETdata/v1/descriptor/styles
Returns descriptions of music styles recognized by Rovi Cloud Services. - GETdata/v1/descriptor/genres
Returns descriptions of genres used in Rovi Cloud Services, plus optional lists of subgenres and musical styles. - GETdata/v1/descriptor/subgenres
Returns descriptions of the subgenres recognized by Rovi Music and Rovi DVDs, plus lists of music styles of music subgenres. - GETdata/v1/descriptor/significantmovies
Returns the top movies and TV shows in a movie genre or subgenre. - GETdata/v1/descriptor/significantsongs
Returns the top songs in a musical genre or subgenre. - GETdata/v1/descriptor/significantartists
Returns the top artists in a musical genre or subgenre. - GETdata/v1/descriptor/significantalbums
Returns the top albums in a musical genre or subgenre - GETdata/v1/descriptor/significantcomposers
Returns the top composers in a classical music subgenre - GETdata/v1/descriptor/significantcompositions
Returns the top compositions in the classical music genre and subgenres
Name
- GETdata/v1/name/info
Returns basic information about a person, group, or organization. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/aliases
Returns other names a person or group has been known by. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/associatedwith
Returns names of people and groups who participated in the work of a person or group. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/classicalbio
Returns names of people and groups who participated in the work of a person or group. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/collaboratorwith
Returns names of people and groups who collaborated with a person or group. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/compositions
Returns a list of classical compositions by a person or group. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/contemporaries
Returns names of people doing comparable work and living during the same time as a person or group. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/discography
Returns a list of albums that a person, group, or organization contributed to. The response can by filtered by type of album. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/filmography
Returns information about the films a person or group contributed to. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/followers
Returns a list of people who followed a person or group and were influenced by them. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/groupmembers
Returns the names of members of a group. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/images
Returns URLs to images of a person or group. Note: Access to images is governed by your subscription level and geographical location. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/influencers
Returns a list of those who influenced a person or group. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/memberof
Returns names of groups that a person has been a member of. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/moods
Returns a list of terms that describe expressive characteristics of the work of a person or group, along with weightings that reflect the relative strength of each term. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/moviebio
Returns a biography of a person or group involved in movies. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/moviestyles
Returns a list of styles relevant to the work of a person or group in movies, along with weightings that reflect the importance of each style. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/musicbio
Returns a biography of a person or group involved in music. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/musiccredits
Returns a list of the music production credits of a person or group. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/musicstyles
Returns a list of the musical styles of a person or group, along with weightings that reflect the importance of each style. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/similars
Returns names of similar people or groups. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/songs
Returns information about the songs a person or group contributed to. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/themes
Returns a list of topics, feelings, and circumstances that motivate or fit with a person, group, or organization, along with weightings that reflect the relative importance of each. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/videos
Returns data for constructing links to music videos and movie trailers that are associated with a person or group. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid. - GETdata/v1/name/web
Returns internet information resources about a person or group. Please specify name, nameid, cosmoid, amgpopid, amgmovieid, or amgclassicalid.
Search
- GETsearch/v2/:endpoint/search
Searches titles or names in Rovi Cloud Services and returns results in order of popularity and similarity to the search query. - GETsearch/v2/:endpoint/filterbrowse
Locates content in Rovi Cloud Services based on field-level criteria and returns results listed in order of relevance.
Recommendations
- GETrecs/v2/:endpoint/similar
Returns similar items in order of similarity and popularity. Please specify a value for albumid, amgvideoid, cosmoprogramid, or nameid.
Articles Methods
- GET/articles/topnews/:section
Use this to request Top News by section. Default is home - GET/articles/:community
Community feeds return content from any one of USA TODAY's blogs in reverse chronological order.
Census Resources
- GET/census/locations
Returns all available ethnicity, housing, population and race information for specified area. - GET/census/ethnicity
Returns an area's ethnic data. Information includes how much of the population identifies as Hispanic or non-Hispanic white, and the USA TODAY Diversity Index. - GET/census/housing
Returns an area's housing data. Information includes the number of housing units, and the percentage of those that are vacant. - GET/census/population
Returns an area's population data. Information includes the total population of an area, average population per square mile, and the percent by which that population has changed since the last census. - GET/census/race
Returns an area's racial data. Information includes the percentage of an area's population that identifies as White, Black, American Indian, Asian, native Hawaiian/Pacific Islander, or mixed race.
Sports Salaries Methods
- GET/salaries/:league
Returns salary data for the MLB, NFL, NBA and NHL leagues.
Content Search
- GETArticles/rest/feed/getFeed?url=
Search for articles across the Univision network. The parameters below are combined into a single URL encoded parameter named 'url'.
User
- POSTImportToken/user/importToken
Import a facebook uid and oauth_token combination to allow Whit.li to populate profile, post and interest information automatically at a predetermined schedule. - GETPopulate/user/populate
Request Whit.li to refresh data associated with a given uid and oauth_token pair. - PUTImportGeneric/user/importGeneric
Import a generic profile from a JSON object.
Key
- GETGet/key/get
Get a Whit.li key. A Whit.li key contains information that describes the various traits of a person. Each Whit.li key contains multiple vectors that have detailed information about an individual based on the individuals psycho-social profile. - GETCompare/key/compare
Compare two users based on a given context associated with key vectors and components.
OpenBookAPI
- GETapi/v2/hcapim
Information about changes - GETapi/v2/hcapim
Harper product catalog (eBook, audio book or print) by ISBN, product-ID or partial title or author and the on sale date - GETapi/v2/hcapim
Obtain the first 1000 words of text for a given ISBN - GETapi/v2/hcapim
Obtain product (eBook, audio book or print) detail by ISBN, product-ID or partial title - GETapi/v2/hcapim
Get the author tour information. - GETapi/v2/hcapim
Find related products. - GETapi/v2/hcapim
Get the authors website and RSS url's if available. - GETapi/v2/hcapim
Author Information. Param1 or Param2 are required. Param3 is optional. - GETapi/v2/hcapim
Get the authors global id and locale from full or partial name. - GETapi/v2/hcapim
Get the authors for a given imprint. - GETapi/v2/hcapim
Get the author name and locale from global id. - GETapi/v2/hcapim
Get the author name and locale from local id.
Book Reviews Methods
- GET/reviews/books/recent
Returns the most 25 most recent reviews. The number of reviews returned may be altered using the count parameter. - GET/reviews/books/book/:search
Returns a list of all available book reviews for a given book. - GET/reviews/books/author/:search
Returns detailed review information for all the albums written by a specific artist.
User APIs
- POST/v1/auth
Login the user - POST/v1/user
Create new user - GET/v2/user
Get user info - GET/v1/policy
Get policy info for the user
Send, Receive, Track APIs
- POST/v1/item/send
Get upload URLs of the new items - POST/v1/item/commit/:itemID
Finish upload - GET/v1/item/status
Get upload status (progress) - GET/v1/item/list
Get upload status (progress) - GET/v1/item/count
Get number of sent or received items - GET/v1/item/:itemID
Get item info - POST/v1/item/expiration/:itemID
Change item expiration - DELETE/v1/item/:itemID
Delete item
Storage APIs
- POST/v1/folder
Create a new folder - GET/v1/folder/:folderId
Get folder info - GET/v1/folder/file/:fileId
Get file info for a file in a folder - POST/v1/folder/file/initUpload
Initialize file upload to a folder - POST/v1/folder/file/commitUpload
Commit file upload to a folder
Share APIs
- POST/v1/folder/:folderId/share
Share a folder - GET/v1/folder/:folderId/share
Get folder share info - PUT/v1/folder/:folderId/unshare
Unshare the folder with a user - POST/v1/folder/file/:fileId/send
Send a file from the folder to a user
Headlines API
- GET/sports/:sportName/:leagueName/news/:method/:headlineId
Sports news stories
Athletes API
- GET/sports/:sportName/:leagueName/athletes/:athleteId
The ESPN Athlete API allows you to get athlete data for various sports/leagues, as well as biographical and statistical data for individual athletes.
Teams API
- GET/sports/:sportName/:leagueName/teams/:teamId
The ESPN Teams API enables you to get information, including roster, stats, and more, for individual teams. You can also fetch teams by conference or division.
Autocomplete API
- GET:endpoint/autocomplete
Predicts search words or phrases for select areas of Rovi Cloud Services and returns results in order of popularity.
TV Listings API
- GETservices/postalcode/:postalCode/info
Returns a list of the television service offerings for an area. - GETservicedetails/serviceid/:serviceId/info
Returns the channel lineup offered by a television service, plus information about the source of programming on a channel. - GETlinearschedule/:serviceId/info
TV listings with detailed program information. - GETgridschedule/:serviceId/info
TV listings designed for the space limitations of a grid. - GETprogramdetails/:serviceId/:programId/info
Information about a series, episode, or program, plus a schedule of upcoming broadcasts. - GETcelebritydetails/info
Returns information about a celebrity and can optionally include a schedule of upcoming broadcasts the celebrity appears in.
GetPriceResearch
- GET/research
GetPriceResearch returns basic pricing statistics for a set of keywords over a variable date range.
GetResearchResults
- GET/research
GetResearchResults is used to retrieve basic pre-calculated statistics for a specific set of keywords, along with other filters.
Good Rx
- GET/drugprices/compare
Compare drug prices by ndc or drug name. If ndc is passed, it overrides name value passed in same call. - GET/drugprices/low
Search for lowest drug price by ndc or drug name. If ndc is passed, it overrides name value passed in same call.
MLB Trial API
- GETmlb-t2/schedule/:year.xml
Obtain Schedule for the MLB for a given year. - GETmlb-t2/venues/venues.xml
Obtain current venue data. - GETmlb-t2/event/:event_id.xml
Obtain Calendar for the MLB for a given year. - GETmlb-t2/statistics/:event_id.xml
Obtain stats for a MLB event - GETmlb-t2/pbp/:event_id.xml
Obtain stats for a MLB event. - GETmlb-t2/boxscore/:event_id.xml
Obtain a boxscore for a MLB event. - GETmlb-t2/rosters/:year.xml
Obtain MLB rosters for a given year. - GETmlb-t2/teams/:year.xml
Obtain list of MLB teams for a given year. - GETmlb-t2/glossary/glossary.xml
Pitch and player status glossary
User Management
- GET/v1/users/user_id/following
Returns the following list for a specific user, newest to oldest. - GET/v1/users/me/following
Returns the current user following list, newest to oldest. - GET/v1/users/user_id/followers
Returns the list of followers for a specific user, newest to oldest. - GET/v1/users/me/followers
Returns the current user following list, newest to oldest. - GET/v1/users/user_id
Returns the profile information for a particular user. - GET/v1/users/me
Returns the profile information for the current user. - GET/v1/users/user_id/media
Returns the list of videos for a specific user, newest to oldest. - GET/v1/users/me/media
Returns the list of videos for the current user.
Search
- GET/v1/users/search
Returns all users matching search query. - GET/v1/media/tags/search
Returns all videos tagged with the query keyword. - GET/v1/media/search
Returns all media for a particular search query. Also supports geo based search based on Lat/Long pair
Media
- GET/v1/media/:type
Returns the media list, newest to oldest.