117
edits
Changes
→search
Server-side search API:
*is not paidServer-side search API provides 1000 search queries for free. If you need more, you may sign up for billing in the the admin-panel. Additional requests cost $1 per 10000 queries.
*has no limits
*allows to get search database snapshot
*is suitable for making server-to-server API calls
===<span style="color: #900;">Beta testing period</span>===
Server-side Search API is currently in beta testing and '''is free to use'''.
You can get personal API keys in the admin-panel at www.acestream.org after the end of the beta testing period of Ace Stream Search API.
==Engine Search API==
*'''category''' (string) - filter by category (list of categories [[Channel Category|here]])
*'''page''' (integer) - page number (starting from 0, default is 0)
*'''page_size''' (integer) - page size (default is 10, maximum value is 50200)
*'''group_by_channels''' (boolean, 0 or 1) - group output results by channel name (see examples)
*'''show_epg''' (boolean, 0 or 1) - include EPG in the response (this works only when group_by_channels=1)
*'''availability_updated_at''' (integer) - unix timestamp when channel availability was last updated at
*'''availability''' (float) - channel availability (number between 0-1)
*'''status''' (integer) - channel status based on its availability; 2 means "green" status - channel is available; 1 means "yellow" status - there is no guaranty that channel is working. Can be used in query as additional filter.
*'''in_playlist''' (boolean) - true if the channel is included in user's playlist (available only on engine endpoint)
===all===
This method retrieves search database snapshot.
Data is returned "as-is": there is no filtering, sorting or pagination.
'''IMPORTANT''': this method is available on server-side endpoint only.
Example:
<tt><nowiki>https://search.acestream.net/all?api_version=1.0&api_key=test_api_key</nowiki></tt>
==Examples==
