Justgiving.com API & Dynamic graphic widgets

I decided to write these quickly as the I found the justgiving.com image widgets didn't contain relevant event information, and didn't fancy using their flash widget... anyhow here goes.

Justgiving.com widgets (unofficial)

You can view you automatically generated widget like this:

<img src="http://api.jo.je/justgiving/view/paras10">

And replace paras10 with your justgiving.com page name

For events without targets, they will look like this:

<a href="http://justgiving.com/richardstobasecamp"><img border=0 src="http://api.jo.je/justgiving/view/richardstobasecamp"></a>

or for a forum.... [url=http://justgiving.com/richardstobasecamp][img]http://api.jo.je/justgiving/view/richardstobasecamp[/img][/url]

Justgiving.com API (unofficial)

For any developers out there who want a quick way to get data about an event, more than provided by the RSS data, here's a JSON feed you can use (replace 'richardstobasecamp' as needed):


Which provides the following, in JSON format:

{"charity":"The Samaritans Of Guildford","title":"Richards Family to Everest Base Camp","id":"1524562","page_creator":"Tony Richards","donations_target":"\u00a30.00","donations_total":"\u00a31,348.00","donations_online":"\u00a31,238.00","donations_offline":"\u00a3110.00","has_target":false,"percentage_complete":0}

This can be decided in PHP5+ using json_decode()

site here: http://api.jo.je/justgiving/

If you plan or using this for anything, please feel free, and drop me a message or comment!

9 Comments to “Justgiving.com API & Dynamic graphic widgets”

  1. Joel,

    Great work on this it’s just what I’m looking for on my teams site. I have one question and please be aware I’m not a code expert, but is there anyway I could change the colour of the widget to more reflect my sites colours, or is the template stored on your site at: http://api.jo.je/justgiving/ ?



    PS: Looks like your having a great time up there!!

  2. Eli-T says:

    Hey Joel,

    I’ve just dropped your JSON feed onto a charity website I’m working on and it works great! Many thanks.

    It would be nice to encapsulate this in a Drupal Module if you’d like to share how you get the information out of JustGiving?



  3. Paul Braham says:

    Hey mate! Great code.

    Although has it gone down. My widget i buult has crashed?


  4. Dan says:

    I’m currently writing a simple app to track donations for the Rage Against The Machine charity group on JustGiving, and have come across this (I can;t believe JustGiving has not official API!).

    Is it OK to use this service as the backend for my app (all open-source of course), and if not, could I get a copy of the source so I can host it myself?


  5. Hi Dan,
    Sure feel free to use this for whatever you want, also if you want to paste a link here to the app that’d be great too :)

  6. Gus says:

    thank you, thank you, thank you. This is perfect for my own page, i have been looking for this kind of simple JG widget for a while. thanks again.

  7. Going Here says:

    Truly when someone doesn’t know then its up to other users
    that they will help, so here it happens.

  8. mark says:

    Does this still work? I’m getting a blank image.

  9. mark says:

    I’m getting an error invalid event using this

    Is there something else I need to do?

Leave a Reply