AppBrain Web API

The AppBrain Web API allows users and website owners to easily integrate their site with AppBrain. Currently we offer AppBrain widgets, badges and RSS feeds. Please see below for the documentation how to integrate with your website. Also please contact us via email if you have any questions or feature requests: [email protected]

App Widget

The AppBrain app widget shows information about an Android app. It shows title, icon, downloads, rating, average rating, developer and the price. The information is always the latest from the Android Market and keeps updating also after embedding it into your webpage.

The code for this widget:

<div class='appbrain-app'>
<a href='http://www.appbrain.com/app/com.appspot.swisscodemonkeys.jokes' 
    style='font-size: 11px; color: #555; font-family: Arial, sans-serif;'>
    Funny Jokes for Android on AppBrain
</a></div> <br>
<script type='text/javascript' language='javascript' src='http://www.appbrain.com/api/api.nocache.js'></script>

Notes:

  • You can find the code for the widget also on each app webpage, when clicking on "QR / more" above the screenshots. Example app page
  • The <script> tag in the last line of the snippet should be included only once per page, even if you include multiple widgets.
  • For fastest loading time move the <script> tag at the bottom of your page, right before </body>.

App List Widget

The app list widgets shows the icons and titles of apps just like on the Android phone. The list is always up-to-date based on the apps you keep installed (after syncing with AppBrain App Market).

<div class='appbrain-applist'><a href='http://www.appbrain.com/user/uwe/apps-on-the-nexus-one' 
    style='font-size: 11px; color: #555; font-family: Arial, sans-serif;'>uwe's Android apps on AppBrain</a></div>
<script type='text/javascript' language='javascript' src='http://www.appbrain.com/api/api.nocache.js'></script>

Notes:

  • You can find the code for the widget also on each app list page and on the My Apps page.
  • The <script> tag in the last line of the snippet should be included only once per page, even if you include multiple widgets.
  • For fastest loading time move the <script> tag at the bottom of your page, right before </body>.

It is also possible to just show the apps without the phone image around it. To do so please add the bg="none" to the <div>.

<div bg='none' class='appbrain-applist'>
    <a href='http://www.appbrain.com/user/uwe/apps-on-the-nexus-one' 
        style='font-size: 11px; color: #555; font-family: Arial, sans-serif;'>
        uwe's Android apps on AppBrain</a></div>
<script type='text/javascript' language='javascript' src='http://www.appbrain.com/api/api.nocache.js'></script>

AppBrain Badge

To link to AppBrain just include the AppBrain badge in your site:

Discover great Android apps on AppBrain.com
<a href="http://www.appbrain.com/" target="_blank">
<img src="http://www.appbrain.com/images/button.png" alt="Discover great Android apps on AppBrain.com" width="56" height="80" border="0">
</a>

Notes:

  • Feel free to modify the link to point to other AppBrain pages.
  • You can copy the image and host it on your server if you prefer.

RSS Feeds

All the category pages and also the app list pages of the users support RSS feeds.

To get the RSS feed you can put a "/rss" before the URL path. For example the latest apps can be found on this page: http://www.appbrain.com/browse/apps?apps=latest The corresponding feed is here: http://www.appbrain.com/rss/browse/apps?apps=latest

For user app lists there are additional parameters. (Example http://www.appbrain.com/rss/user/uwe/apps-on-the-phone)

  • Parameter o - offset in the results, default 0
  • Parameter limit - maximum number of results, default 10
  • Parameter order - ordering of the results (value "date" or "name"), default "date"

For example to get the apps ordered by name, starting with the 10th result:

http://www.appbrain.com/rss/user/uwe/apps-on-the-phone?o=10&limit=1000&order=name

SDK Widget

For all the libraries and SDKs listed in our Android Library Statistics section we provide widgets that show some relevant data for the corresponding library.

The widget comes in two basic formats:

  • A compact, horizontally shaped widget containing the library's title and logo, as well as the 4 most popular apps using the library.
  • A larger widget containing the library's title, logo (optional), the 8 most popular apps using the library, and the number of apps using library (optional).

The small SDK Widget

Code for this widget:

<div class='appbrain_sdkwidget' data-format="small">
    <a href='http://www.appbrain.com/stats/libraries/details/applift/applift' target="_blank"
    style='font-size: 11px; color: #555; font-family: Arial, sans-serif;'>
        Top apps using AppBrain AppLift
    </a>
</div>
<script type='text/javascript' language='javascript' src='http://www.appbrain.com/api/api.nocache.js'></script>

The large SDK Widget

Code for this widget:

<div class='appbrain_sdkwidget' data-format="large" data-counts="true">
    <a href='http://www.appbrain.com/stats/libraries/details/applift/applift' target="_blank" 
    style='font-size: 11px; color: #555; font-family: Arial, sans-serif;'>
        Top apps using AppBrain AppLift
    </a>
</div>
<script type='text/javascript' language='javascript' src='http://www.appbrain.com/api/api.nocache.js'></script>

SDK Widget configuration

The SDK widgets can be configured using the following attributes (to be placed in the div with class appbrain_sdkwidget):

  • data-format: Use this to choose between the small (data-format="small") or large (data-format="large") widget format.
  • data-title: Use this to set a custom library title (e.g. data-title="AppLift")
  • data-logo (for the large widget only): Use this to hide the logo (data-logo="false").
  • data-counts (for the large widget only): If data-counts="true" the widget shows the (rough) number of apps that use this library. Default is false.

Additionally, the target-attribute of the link element (<a...) can be set to control the behavior of all the links within the widget. The link acts as a placeholder that is shown if the widget cannot be displayed, such as when javascript is disabled in the viewer's browser.

Finally, you can style the widget by adding the following css-classes to your stylesheet:

  • sdkwidget-wrapper: The style of the widget's main div. Use this to change the widget's font, background-color, border, etc.
  • sdkwidget-title: Can be used to style the title.
  • sdkwidget-more: The style of the 'more-information' link can be controlled using this class.
  • sdkwidget-footer: The style of the footer area.

Notes:

  • You can find the code for the widget also on each library's detail page (click the preview widget link on the corresponding page).
  • The <script> tag in the last line of the snippet should be included only once per page, even if you include multiple widgets.
  • For fastest loading time move the <script> tag at the bottom of your page, right before </body>.