simonklee / libscore

JavaScript library usage stats.

Home Page:http://libscore.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Libscore.com

Learn

To learn about Libscore, read the full overview.

For Libscore's API documentation, see below.

--

Contribute

To help us locate the Github page for a JavaScript library, see this thread.

To help us whitelist a popular library that Libscore is failing to detect, see this thread.

Take a moment to thank Libscore's sponsors on Twitter: @Stripe and @DigitalOcean!

Help Wanted: Assign libraries to their official pages

You're reading this because Libscore needs your help associating the library you clicked on with its corresponding Github page (or company domain in the case of an external script).

We've decided to partner with cdnjs.com and merge the way we store meta data about libraries. By adding data directly to cdnjs package.json's we can keep track of which library matches which variable.

cdnjs package.json's now contain a property called namespace, which is simply the main variable used for that library.

e.g. jQuery is the main variable used by jQuery -> package.json

So to help us out

  1. Load up the list of libraries on cdnjs
  2. Find the appropiate library and open the package.json file on github.com
  3. Click on the edit button which will load Github's online editor
  4. Add a property called namespace and set the corresponding variable
  5. Commit and submit a pull request (you should be able to do this all via Github's interface)

We will then merge your pull request and it will eventually be parsed out of cdnjs and linked correctly to on Libscore.

--

Badges

Feel free to embed a Libscore badge which uses the shields.io API. Create an issue to give feedback on badges.

Simply replace {{library}} with a matching name from libscore.com

http://api.libscore.com/badge/{{library}}.svg

Embed just the badge and no link

![](http://api.libscore.com/badge/jQuery.svg)

Link to Libscore results

[![](http://api.libscore.com/badge/jQuery.svg)](https://libscore.com#jQuery)

Embed badge on HTML page

<a href="http://libscore.com#jQuery"><img src="http://api.libscore.com/badge/jQuery.svg" /></a>

API

The Libscore API is freely available to use within constraints due to the project being a non for profit. The API is relativly simple so we don't expect to release breaking changes often, when we do the API will be shifted to v2.

Endpoints

Endpoint Description Example
GET - /v1/libraries Get a full list of libraries Example
GET - /v1/libraries/:library Get an individual library Example
GET - /v1/sites Get a full list of sites Example
GET - /v1/sites/:site Get an individual site Example
GET - /v1/scripts Get a full list of scripts Example
GET - /v1/scripts/:script Get an individual site Example

Libraries

To get the full list of libraries

GET http://api.libscore.com/v1/libraries
Parameters:
  • limit - Specify the number of results to return e.g. ?limit=500
  • skip - Specify the number of results to skip, useful for pagination e.g. ?limit=0

Individual Library

To get the full details of a library

GET http://api.libscore.com/v1/libraries/:library
Parameters:
  • limit - Specify the number of top sites to return e.g. ?limit=500
Examples:
GET http://api.libscore.com/v1/libraries/jQuery
// Get full data about JQuery

GET http://api.libscore.com/v1/libraries/$.fn.velocity
// Get full data about Velocity.js


Sites

To get the full list of sites

GET http://api.libscore.com/v1/sites
Parameters:
  • limit - Specify the number of results to return e.g. ?limit=500
  • skip - Specify the number of results to skip, useful for pagination e.g. ?limit=0

Individual Site

To get the full list of sites

GET http://api.libscore.com/v1/sites/:site
Parameters:
  • limit - Specify the number of results to return e.g. ?limit=500
  • skip - Specify the number of results to skip, useful for pagination e.g. ?limit=0
Examples:
GET http://api.libscore.com/v1/sites/tumblr.com
// Get full data about the website tumblr.com

Scripts

To get the full list of scripts

GET http://api.libscore.com/v1/scripts
Parameters:
  • limit - Specify the number of results to return e.g. ?limit=500
  • skip - Specify the number of results to skip, useful for pagination e.g. ?limit=0

Individual Script

To get the full list of scripts

GET http://api.libscore.com/v1/scripts/:script
Parameters:
  • limit - Specify the number of results to return e.g. ?limit=500
  • skip - Specify the number of results to skip, useful for pagination e.g. ?limit=0
Examples:
GET http://api.libscore.com/v1/scripts/cdnjs.cloudflare.com
// Get full data about the website cdnjs.cloudflare.com

About

JavaScript library usage stats.

http://libscore.com