When we discuss APIs and LoopBack, often we’re talking about external consumers, but you can use LoopBack APIs on your own site as well. For example, one cool way to use a LoopBack REST-based API is to power client-side charting for your web site. In this post I’ll demonstrate a simple LoopBack API and how I built charts with it using Google’s Chart service.

First, let’s look at the data model that will power our API. A little-known but still legally relevant clause in the LoopBack usage agreement is that all APIs must begin with something related to cats.  With that in mind, I began with a Cat model that has the following properties:

  • name (string)
  • color (string)
  • gender (string)
  • age (number)
  • breed (string)

From that model LoopBack generated a complete REST API for all my Enterprise Cat API needs.


Next I updated my datasource to persist data to the file system. The default LoopBack datasource is in-memory, but I tweaked it to persist data to the file system. While not suitable for production, this is a great way to save test data when you restart your application. Just edit the datasources.json file and add a “file” key to the “db” block:

  "db": {
    "name": "db",
    "connector": "memory",

The JSON above specifies that LoopBack persists data to the data.db file. Again, you wouldn’t do this in production. Instead you would use a database system like MongoDB or MySQL.

Next I wanted to generate a lot of random cats.  To do this, I added a /makecats route to the server.js file. It randomizes the name, color, age, and other properties of my cat and creates model instances with the data. Here is the method:

app.get('/makecats', function(req, res) {

   var getRandomInt = function(min, max) {
     return Math.floor(Math.random() * (max - min + 1)) + min;

   function randomName() {
     var initialParts = ["Fluffy","Scruffy","King","Queen","Emperor","Lord","Hairy","Smelly","Most Exalted Knight","Crazy","Silly","Dumb","Brave","Sir","Fatty"];
     var lastParts = ["Sam","Smoe","Elvira","Jacob","Lynn","Fufflepants the III","Squarehead","Redshirt","Titan","Kitten Zombie","Dumpster Fire","Butterfly Wings","Unicorn Rider"];
     return initialParts[getRandomInt(0, initialParts.length-1)] + ' ' + lastParts[getRandomInt(0, lastParts.length-1)]

   function randomColor() {
     var colors = ["Red","Blue","Green","Yellow","Rainbow","White","Black","Invisible"];
     return colors[getRandomInt(0, colors.length-1)];

   function randomGender() {
     var genders = ["Male","Female"];
     return genders[getRandomInt(0, genders.length-1)];

   function randomAge() {
     return getRandomInt(1, 15);

   function randomBreed() {
     var breeds = ["American Shorthair","Abyssinian","American Curl","American Wirehair","Bengal","Chartreux","Devon Rex","Maine Coon","Manx","Persian","Siamese"];
     return breeds[getRandomInt(0, breeds.length-1)];

   //make 25 cats
   for(var i=0;i<25;i++) {
     var cat = {

   } // for
   res.send('Making cats - stand back!');

I ran this a few times to generate a bit over 100 cats, and then hit my API to ensure it worked correctly:


Note the limit filter I placed in the URL above to keep the result set a bit smaller. LoopBack supports filtering, limiting, sorting, and other useful data manipulations.

Now I’ve got an API and a large set of delicious furry sample data. Let’s talk charting. There are quite a few JavaScript-based charting solutions, some easier than others. For this post I’ll focus on Google’s Chart API. It has lots of options and is easy to use with an API. But my choice here is somewhat arbitrary. You could use any other popular charting library if you prefer.

For the first test, I’ll build a pie chart that represents the breakdown of gender for the cat data. This is easy, since LoopBack provides a way to both filter data in the URL and get a count. For example, to get a count of male cats:


Now let’s build the app. The HTML part is going to be simple:  just a <div> to render the chart and <script> tags to include  the various JavaScript libraries I’m using. (Note – this code, and the other snippets, are not complete applications. You can download the attachment to get complete samples.)

<!DOCTYPE html>
  <meta charset="utf-8">
  <title>Cats Chart</title>
  <meta name="description" content="">
  <meta name="viewport" content="width=device-width">
  div#chart_div {
  <div id="chart_div"></div>

  <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
  <script type="text/javascript" src="https://code.jquery.com/jquery-3.1.0.min.js"></script>
  <script type="text/javascript" src="js/app.js"></script>

Now look at the client-side JavaScript code in app.js :

var male = 0;
var female = 0;

$(document).ready(function() {
  google.charts.load('current', {'packages':['corechart']});

function loadData() {
  //get male vs female
  $.get('http://localhost:3000/api/cats/count?where[gender]=Male').then(function(result) {
    male = result.count;
      $.get('http://localhost:3000/api/cats/count?where[gender]=Female').then(function(result) {
        female = result.count;

function drawChart() {
  // Create the data table.
  var data = new google.visualization.DataTable();
  data.addColumn('string', 'Gender');
  data.addColumn('number', 'Count');
    ['Male', male],
    ['Female', female]

  // Set chart options
  var options = {
    'title':'Cats by Gender',

  // Instantiate and draw chart, passing in some options.
  var chart = new google.visualization.PieChart(document.getElementById('chart_div'));
  chart.draw(data, options);

There’s a bit more going on here, so let’s take it bit by bit. First, I load the Google Charts library and tell it what function to run when done. The loadData function handles fetching the male/female data. Remember these calls are asynchronous, so I have to chain one inside another, and that’s “kinda” bad (Google for “Callback Hell”), but for now it’s acceptable.

The real magic happens in drawChart where I set up the chart, tell it what data to use, and then render it. The result is a pretty little pie chart:


Remember, I’m using most of the defaults from Google but if I wanted to, I could customize this a lot more. Now let’s kick it up a notch. How about building a chart for cat breeds?

This brings up an interesting issue: While I’ve built this API just for myself and a cute little page of charts, how would I enable the public to search for cats by breed? Specifically, how do I share which breeds the site supports? While there are a couple of ways to solve this, I simply added a new remote method, /breeds, that returns the list of supported cat breeds.

Recall the code above where I generated a lot of cats using a hard-coded list. I’m going to do that again, but you could imagine a real system where this is driven by a query.

module.exports = function(Cat) {

  Cat.breeds = function(cb) {
    //This would probably not be hard coded.
    var breeds = ["American Shorthair","Abyssinian","American Curl","American Wirehair","Bengal","Chartreux","Devon Rex","Maine Coon","Manx","Persian","Siamese"];

  Cat.remoteMethod('breeds', {
    http: {verb: 'get', path: '/breeds'},
    returns: {root: true, type: 'array'}


Once added, I can then request it just like any other REST API:


Now I have a way to fetch breeds and I know how to filter and count, so I can just make one HTTP request for each breed. While I was okay with the “small” Callback Hell for gender, this would be way too deep to be manageable, so instead I’ll handle it using Deferred and Promises with jQuery. Here’s how I fetch the data and handle knowing when all the calls are done:

$.get('http://localhost:3000/api/cats/breeds').then(function(result) {
  breeds = result;
  var defs = [];
  breeds.forEach(function(b) {

  $.when.apply($, defs).then(function() {
    for(var i=0;i<breeds.length;i++) {
      var count = arguments[i][0].count;
      breedCount[breeds[i]] = count;


Essentially I created an array of jQuery Deferred objects and use $.when to recognize when every one of the async calls has finished. Once they have, I copy the result into the  breedCount object that contains all the chart data.   The definition of drawBreedChart is:

function drawBreedChart() {


  // Create the data table.
  var data = new google.visualization.DataTable();
  data.addColumn('string', 'Breed');
  data.addColumn('number', 'Count');

  //convert our nice ob into an array
  var bData = [];
  breeds.forEach(function(b) {
    bData.push([b, breedCount[b]]);

  // Set chart options
  var options = {
    'title':'Cats by Breed',

  var chart = new google.visualization.PieChart(document.getElementById('breed_div'));
  chart.draw(data, options);


And the result:


And that’s it. You can, of course, go much deeper, and of course build different types of charts. You can even use WebSockets and update your charts in real-time. Let me know in the LoopBack forum if you’ve used charting with LoopBack.

Download the Client-Side Code