Wohooo! Today we are releasing an early beta of the AlternativeTo API. It is in its early stages but we want to get it out to you guys so that we can get your opinions which will help us develop it the way you want it. The API lets you get basic information about applications and users on AlternativeTo.
The API returns data formatted in JavaScript Object Notation (JSON). The plan is to support more data formats in the future. You can read more about how to use jQuery to request and consume JSON data on this website:
http://docs.jquery.com/Ajax/jQuery.getJSON
We really want your feedback on the API so if you have requests for more methods, what kind of data you want to get or any other questions or suggestions then please feel free to comment or send us an e-mail at hello@alternativeto.net
Common parameters
app
The app parameter is the name of the application in the same formatting as it has in our urls. Example: If you want to get information about Adobe Photoshop you set “adobe-photoshop” as the app paramater.
user
The same principal as the app parameter. When you want information about a user you send in the username as it is in our urls. In my case that would be “ola”.
count
This determines the number of results you want. Max is 100.
category
Selects a specific category to get the results from. Right now we have two categories: desktop & mobile. If you do provide a category it will default to desktop.
Get an application and it’s alternatives
Example: http://api.alternativeto.net/api/apps/alternatives/?app=firefox&count=5&category=desktop
Returns information about the specified application and the specified number of alternatives. In the example above it would return Firefox and its top 5 alternatives.
Get recently added applications
Example: http://api.alternativeto.net/api/apps/recent/?count=5&category=mobile
Returns recently added applications. This will get the 5 most recent applications from the mobile category.
Get a list of applications a user likes
Example: http://api.alternativeto.net/api/user/likes/?user=ola&count=5&category=desktop
This method returns a specified number of applications that the user likes. In this case we get 5 applications that the user Ola likes. They are sorted by “most recently liked”.
Get a list of application a user has added
Example: http://api.alternativeto.net/api/user/added/?user=ola&count=5&category=desktop
Returns the applications that the specified user has added to AlternativeTo. In the example above it would return 5 applications that the user Ola has added on the desktop version.
Get a list of recent user activities on the site
Example: http://api.alternativeto.net/api/user/activities/?user=ola&count=5
Returns a list of activities that a specified user has performed on AlternativeTo.