“To Sherlock Holmes she is always the woman. I have seldom heard him mention her under any other name.”
- Dr. John Watson re: Irene Adler (from Sir Arthur Conan Doyle's A Scandal in Bohemia)
When it comes to building applications and services powered by our Rhymba APIs, Search is the entry point. Even if you are giving customers a prepopulated playlist, you'll need to search our massive library of digital content to find the IDs you're looking for. And, of course, if you're building a store or other service, you may expose that same search capability to your users directly.
So, Search is kind of a Big Deal. We've spent a lot of time on our search, making it as fast and relevant as possible, and we're always improving how it works — including its relevancy.
But, "Search" is kind of a misnomer. This section's titled "Search" because that's the Rhymba URL you'll be hitting... but you can also retrieve content by ID rather than searching for it. You can also snag content from Rhymba using custom filters against things like genres, the geo territories the content is available for, and more. So, mentally, you should think of "search" more like "getting information about content through a variety of means", but as that wouldn't work really well for a tab/button above let's just stick with "Search".
The "Search" API is used for searching content by text, but also for retrieving content metadata based on specific IDs (one or many), and other criteria you can query via OData $filter.
The Search API endpoint
You can access search via the base URL https://search.mcnemanager.com/current/content.odata/. Both HTTP and HTTPS are supported.
Getting The Most Out Of This Section
Our suggestion is that you start with the OData page. This page will give you detailed information about concepts common to all three OData collections exposed — Albums, Artists and Media. If you haven't already, you should definitely check out the Intro to OData in the Getting Started section, as that breaks down OData and interacting with our Search API even further.
Then, take a tour through the sections for each type of object — Albums, Artists, and Media. These provide detailed information on each of the fields/properties/metadata associated with each type of content. Armed with your knowledge of OData and how to interact with Rhymba, you'll be set for the overwhelming majority of implementations.
However, if you'd like to get really wacky and stretch Rhymba (and by extension, OData) to its limits, be sure to check out the Advanced Queries page. This will show you how to do certain queries that flex the power of the Rhymba APIs and OData. In the interest of full disclosure, it's also an opportunity for us to show off a bit.