Foomark api

Everything you need to win the internet

Foomark API

Make awesome stuff with our data

Overview

We believe in supporting the open web. The Foomark API is availble for use for commercial and non-commercial uses and is released under Creative Commons Zero. All API access is over HTTP. All responses are returned as JSON. The API is (mostly) RESTful. Foomark API does not require an API Key but the service is monitored for potential abuse in accordance with the terms of use below.

Contact us with any comments or questions about the API.

Terms of use

  • API calls are limited to 60 per minute
  • Do not abuse the API or use it excessively
  • Foomark may terminate your license to the Foomark API at any time for any reason we deam fit.
  • Foomark reserves the right to update and change these terms at any time without prior notice.

Available API

User list - /users/list

This will return a set of users with basic information.

URL

http://api.foomark.com/users/list/

Authentication

None

Arguments
  • username (optional)

    Return results only for this username.

  • sort (optional)

    The order for this data set. Defaults to ascending alphabetic of username. Possible values are: recent, alpha.

  • page (optional)

    The page to return for this data set. Defaults to 1.

  • count (optional)

    Number of users to return. The maximum allowed value is 50.

  • format (optional)

    Return the data set in this format. Possible values are: xml, json, jsonp, html, csv. Defaults to xml.

Sample Request
    http://api.foomark.com/users/list/?sort=recent&count=10&format=xml
Sample Response
<xml>
    <item>
        <username>robertbanh</username>
        <title>Web Developer</title>
        <level>1</level>
        <website>http://robertbanh.com</website>
        <twitter>robertbanh</twitter>
        <dribbble/>
        <forrst>robertbanh</forrst>
        <linkedin>http://www.linkedin.com/in/robertbanh</linkedin>
        <coins>25</coins>
        <guild>Cospace_Austin</guild>
    </item>
    <item>
        <username>mccombs</username>
        <title>Design and Front-end Developer</title>
        <level>1</level>
        <website>http://www.mccombscreative.com</website>
        <twitter>adammccombs</twitter>
        <dribbble>mccombscreative</dribbble>
        <forrst>mccombscreative</forrst>
        <linkedin>http://www.linkedin.com/in/adammccombs</linkedin>
        <coins>108</coins>
        <guild>Team_Awesome</guild>
    </item>
</xml>

URL list - /urls/list

This will return a set of URLs with associated tags.

URL

http://api.foomark.com/urls/list/

Authentication

None

Arguments
  • username (optional)

    Return results only for this username.

  • tags (optional)

    Return results will contain at least one of these tags. Multiple tags must be separated by comma.

  • sort (optional)

    The order for this data set. Defaults to ascending alphabetic of username. Possible values are: recent, alpha.

  • page (optional)

    The page to return for this data set. Defaults to 1.

  • count (optional)

    Number of users to return. The maximum allowed value is 50.

  • format (optional)

    Return the data set in this format. Possible values are: xml, json, jsonp, html, csv. Defaults to xml.

Sample Request
    http://api.foomark.com/urls/list/?tag=design&count=10&format=xml
Sample Response
<xml>
    <item>
        <url_id>22</url_id>
        <total>26</total>
        <url>http://initializr.com/</url>
        <title>Initializr - Start your HTML5 project in 15 seconds! ...</title>
        <created_by>robertbanh</created_by>
        <created_at>2011-03-08 20:43:45</created_at>
        <tags>Boilerplate,css3,frontend,html5,initializr,jquery,template</tags>
    </item>
    <item>
        <url_id>88</url_id>
        <total>16</total>
        <url>http://www.fontsquirrel.com/</url>
        <title/>
        <created_by>robertbanh</created_by>
        <created_at>2011-03-08 20:44:32</created_at>
        <tags>@font-face,css,design,download,downloads,font,fontface,fonts</tags>
    </item>
</xml>