aboutsummaryrefslogtreecommitdiff
path: root/subsonic-site/src/main/webapp/api-search3.jsp
diff options
context:
space:
mode:
Diffstat (limited to 'subsonic-site/src/main/webapp/api-search3.jsp')
-rw-r--r--subsonic-site/src/main/webapp/api-search3.jsp65
1 files changed, 65 insertions, 0 deletions
diff --git a/subsonic-site/src/main/webapp/api-search3.jsp b/subsonic-site/src/main/webapp/api-search3.jsp
new file mode 100644
index 00000000..623a65a5
--- /dev/null
+++ b/subsonic-site/src/main/webapp/api-search3.jsp
@@ -0,0 +1,65 @@
+<h2 class="div"><a name="search3"></a>search3</h2>
+
+<p>
+ <code>http://your-server/rest/search3.view</code>
+ <br>Since <a href="#versions">1.8.0</a>
+</p>
+
+<p>
+ Similar to <code>search2</code>, but organizes music according to ID3 tags.
+</p>
+<table width="100%" class="bottomspace">
+ <tr>
+ <th class="param-heading">Parameter</th>
+ <th class="param-heading">Required</th>
+ <th class="param-heading">Default</th>
+ <th class="param-heading">Comment</th>
+ </tr>
+ <tr class="table-altrow">
+ <td><code>query</code></td>
+ <td>Yes</td>
+ <td></td>
+ <td>Search query.</td>
+ </tr>
+ <tr>
+ <td><code>artistCount</code></td>
+ <td>No</td>
+ <td>20</td>
+ <td>Maximum number of artists to return.</td>
+ </tr>
+ <tr class="table-altrow">
+ <td><code>artistOffset</code></td>
+ <td>No</td>
+ <td>0</td>
+ <td>Search result offset for artists. Used for paging.</td>
+ </tr>
+ <tr>
+ <td><code>albumCount</code></td>
+ <td>No</td>
+ <td>20</td>
+ <td>Maximum number of albums to return.</td>
+ </tr>
+ <tr class="table-altrow">
+ <td><code>albumOffset</code></td>
+ <td>No</td>
+ <td>0</td>
+ <td>Search result offset for albums. Used for paging.</td>
+ </tr>
+ <tr>
+ <td><code>songCount</code></td>
+ <td>No</td>
+ <td>20</td>
+ <td>Maximum number of songs to return.</td>
+ </tr>
+ <tr class="table-altrow">
+ <td><code>songOffset</code></td>
+ <td>No</td>
+ <td>0</td>
+ <td>Search result offset for songs. Used for paging.</td>
+ </tr>
+</table>
+<p>
+ Returns a <code>&lt;subsonic-response&gt;</code> element with a nested <code>&lt;searchResult3&gt;</code>
+ element on success. <a href="http://subsonic.svn.sourceforge.net/viewvc/subsonic/trunk/subsonic-main/src/main/webapp/xsd/searchResult3_example_1.xml?view=markup">Example</a>.
+</p>
+