The Betterific Public REST API allows users to fetch publicly-available betterifs, tags, and users. To submit betterifs, to comment, to vote, and to take other actions on Betterific, you will need the Betterific Authenticated REST API.
The Betterific Public REST API is available in the following formats:
The default format is JSON. To use one of the other available formats, add .format to the end of the API endpoint before the GET parameters. For example, the following URL is valid:
but this URL is not valid:
The best performance in terms of I/O and parsing will be from Protocol Buffers, while the worst performance will be from RSS and XML. JSON offers a reasonable trade-off between ease-of-use and performance.
All endpoints take the following parameters:
Additional parameters will be noted.
The official Ruby client for the public REST API can be found at https://github.com/bradcater/betterific. We would welcome client libraries written in other languages.
Fetch a list of betterifs by id.
Fetch a list of the most recent betterifs.
Fetch a list of the most popular betterifs.
Fetch a list of comments by id or by betterif_id.
must be given if comments[ids] is not given
must be given if betterifs[ids] is not given
If betterifs[ids] and comments[ids] are both given, comments[ids] will be respected, and betterifs[ids] will be ignored.
order must be one of least_recent or most_recent.
Fetch a list of tags by id.
Fetch a list of users by id.
Returns up to the 10 betterifs that best match the given query.
Returns up to the 10 tags that best match the given query.
Returns up to the 10 users that best match the given query.
Returns up to the 10 betterifs, tags, and users that best match the given query. Note that the limit applies to each set individually--that is, you may have up to 10 betterifs, up to 10 tags, and up to 10 users.