Betterific Public REST API

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.


Available Formats

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:

http://betterific.com/api/betterifs.xml?betterifs[ids]=224

but this URL is not valid:

http://betterific.com/api/betterifs?betterifs[ids]=224.xml

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.


Client Libraries

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.


Betterifs

http://betterific.com/api/betterifs

Fetch a list of betterifs by id.

Additional Parameters

Example
GET http://betterific.com/api/betterifs?betterifs[ids]=224

http://betterific.com/api/betterifs/most-recent

Fetch a list of the most recent betterifs.

Example
GET http://betterific.com/api/betterifs/most-recent

http://betterific.com/api/betterifs/most-popular

Fetch a list of the most popular betterifs.

Example
GET http://betterific.com/api/betterifs/most-popular


Comments

http://betterific.com/api/comments

Fetch a list of comments by id or by betterif_id.

Additional Parameters

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.

Example
GET http://betterific.com/api/comments?comments[ids]=121


Tags

http://betterific.com/api/tags

Fetch a list of tags by id.

Additional Parameters

Example
GET http://betterific.com/api/tags?tags[ids]=400937


Users

http://betterific.com/api/users

Fetch a list of users by id.

Additional Parameters

Example
GET http://betterific.com/api/users?users[ids]=2,3,4


Search

http://betterific.com/api/search/all

Search for

Example
GET http://betterific.com/api/search/all?q=golf