Projects API

Like it's HTML counterpart project comparisons the projects API allows to query the data for an arbitrary selection of projects.

This allows you to programatically retrieve data for gems and their GitHub source repositories in a single place, as well as additional metrics specific to the Ruby Toolbox like popularity scores and project health status.

The API has currently no rate-limiting policy, however please use it reasonably. If you need larger scale access to data for analysis please use our production database exports instead.

A simple ruby API client is available on rubygems as rubytoolbox-api.

GET /api/projects/compare/rubocop,rspec-expectations,oj

This endpoint is limited to 100 projects per request. If you request more than that you will receive an error. Please batch requests in groups to retrieve more projects.


{
  "projects": [
    {
      "permalink": "oj",
      "categories": [
        {
          "permalink": "JSON_Parsers",
          "category_group": {
            "permalink": "Web_Apps_Services_Interaction",
            "description": null,
            "name": "Web Apps, Services & Interaction"
          },
          "description": "JSON parsers convert data serialized in the popular JSON data exchange format to and from Ruby objects",
          "name": "JSON Parsers",
          "urls": {
            "toolbox_url": "https://www.ruby-toolbox.com/categories/JSON_Parsers"
          }
        }
      ],
      "description": "The fastest JSON parser and object serializer.",
      "github_repo": {
        "path": "ohler55/oj",
        "average_recent_committed_at": "2023-07-24 21:18:31 UTC",
        "description": "Optimized JSON",
        "is_archived": false,
        "is_fork": false,
        "is_mirror": false,
        "issues": {
          "url": "https://github.com/ohler55/oj/issues",
          "open_count": 10,
          "closed_count": 560,
          "total_count": 570,
          "closure_rate": "98.25"
        },
        "license": "mit",
        "primary_language": "C",
        "pull_requests": {
          "url": "https://github.com/ohler55/oj/pulls",
          "open_count": 3,
          "closed_count": 35,
          "merged_count": 300,
          "total_count": 338,
          "acceptance_rate": "88.76"
        },
        "repo_pushed_at": "2024-02-28 21:46:20 UTC",
        "stats": {
          "stargazers_count": 3092,
          "forks_count": 237,
          "watchers_count": 39
        },
        "url": "https://github.com/ohler55/oj",
        "wiki_url": null
      },
      "health": {
        "overall_level": "green",
        "statuses": [
          {
            "key": "rubygem_long_running",
            "icon": "diamond",
            "label": "A long-lived project that still receives updates",
            "level": "green"
          }
        ]
      },
      "name": "oj",
      "rubygem": {
        "name": "oj",
        "current_version": "3.16.3",
        "first_release_on": "2012-02-19",
        "latest_release_on": "2023-12-11",
        "licenses": [
          "MIT"
        ],
        "stats": {
          "downloads": 191980218,
          "reverse_dependencies_count": 818,
          "quarterly_release_counts": {
            "2012-1": 18,
            "2012-2": 10,
            "2012-3": 6,
            "2012-4": 12,
            "2013-1": 10,
            "2013-2": 8,
            "2013-3": 1,
            "2013-4": 12,
            "2014-1": 8,
            "2014-2": 13,
            "2014-3": 4,
            "2014-4": 4,
            "2015-1": 6,
            "2015-2": 8,
            "2015-3": 5,
            "2015-4": 6,
            "2016-1": 4,
            "2016-2": 3,
            "2016-3": 5,
            "2016-4": 2,
            "2017-1": 5,
            "2017-2": 17,
            "2017-3": 8,
            "2017-4": 4,
            "2018-1": 2,
            "2018-2": 4,
            "2018-3": 8,
            "2018-4": 9,
            "2019-1": 5,
            "2019-2": 1,
            "2019-3": 4,
            "2019-4": 2,
            "2020-1": 4,
            "2020-2": 1,
            "2020-3": 8,
            "2020-4": 4,
            "2021-1": 4,
            "2021-2": 4,
            "2021-3": 14,
            "2021-4": 2,
            "2022-1": 1,
            "2022-2": 3,
            "2022-3": 7,
            "2022-4": 2,
            "2023-1": 3,
            "2023-2": 2,
            "2023-3": 3,
            "2023-4": 2
          },
          "releases_count": 278
        },
        "url": "https://rubygems.org/gems/oj"
      },
      "score": "5.86",
      "urls": {
        "bug_tracker_url": "https://github.com/ohler55/oj/issues",
        "changelog_url": null,
        "documentation_url": "http://www.ohler.com/oj/doc/index.html",
        "homepage_url": "http://www.ohler.com/oj/",
        "mailing_list_url": null,
        "source_code_url": "https://github.com/ohler55/oj",
        "toolbox_url": "https://www.ruby-toolbox.com/projects/oj",
        "wiki_url": "https://github.com/ohler55/oj/wiki"
      }
    },
    {
      "permalink": "rspec-expectations",
      "categories": [],
      "description": "rspec-expectations provides a simple, readable API to express expected outcomes of a code example.",
      "github_repo": {
        "path": "rspec/rspec-expectations",
        "average_recent_committed_at": "2023-08-10 14:30:26 UTC",
        "description": "Provides a readable API to express expected outcomes of a code example",
        "is_archived": false,
        "is_fork": false,
        "is_mirror": false,
        "issues": {
          "url": "https://github.com/rspec/rspec-expectations/issues",
          "open_count": 46,
          "closed_count": 473,
          "total_count": 519,
          "closure_rate": "91.14"
        },
        "license": "mit",
        "primary_language": "Ruby",
        "pull_requests": {
          "url": "https://github.com/rspec/rspec-expectations/pulls",
          "open_count": 13,
          "closed_count": 212,
          "merged_count": 695,
          "total_count": 920,
          "acceptance_rate": "75.54"
        },
        "repo_pushed_at": "2024-03-18 23:22:22 UTC",
        "stats": {
          "stargazers_count": 1245,
          "forks_count": 388,
          "watchers_count": 43
        },
        "url": "https://github.com/rspec/rspec-expectations",
        "wiki_url": null
      },
      "health": {
        "overall_level": "green",
        "statuses": [
          {
            "key": "rubygem_long_running",
            "icon": "diamond",
            "label": "A long-lived project that still receives updates",
            "level": "green"
          }
        ]
      },
      "name": "rspec-expectations",
      "rubygem": {
        "name": "rspec-expectations",
        "current_version": "3.13.0",
        "first_release_on": "2009-09-16",
        "latest_release_on": "2024-02-04",
        "licenses": [
          "MIT"
        ],
        "stats": {
          "downloads": 876030658,
          "reverse_dependencies_count": 481,
          "quarterly_release_counts": {
            "2009-3": 1,
            "2010-1": 13,
            "2010-2": 11,
            "2010-3": 6,
            "2010-4": 6,
            "2011-1": 2,
            "2011-2": 4,
            "2011-4": 4,
            "2012-1": 3,
            "2012-2": 2,
            "2012-3": 4,
            "2012-4": 2,
            "2013-1": 1,
            "2013-2": 1,
            "2013-3": 4,
            "2013-4": 3,
            "2014-1": 3,
            "2014-2": 7,
            "2014-3": 6,
            "2015-1": 1,
            "2015-2": 2,
            "2015-3": 1,
            "2015-4": 1,
            "2016-1": 2,
            "2016-2": 2,
            "2016-3": 1,
            "2016-4": 2,
            "2017-2": 1,
            "2017-4": 1,
            "2018-3": 2,
            "2018-4": 1,
            "2019-2": 2,
            "2019-4": 3,
            "2020-1": 1,
            "2020-2": 1,
            "2020-4": 4,
            "2022-1": 2,
            "2022-3": 1,
            "2022-4": 2,
            "2023-1": 1,
            "2023-2": 1,
            "2024-1": 2
          },
          "releases_count": 120
        },
        "url": "https://rubygems.org/gems/rspec-expectations"
      },
      "score": "22.19",
      "urls": {
        "bug_tracker_url": "https://github.com/rspec/rspec-expectations/issues",
        "changelog_url": null,
        "documentation_url": "https://rspec.info/documentation/",
        "homepage_url": "https://github.com/rspec/rspec-expectations",
        "mailing_list_url": "https://groups.google.com/forum/#!forum/rspec",
        "source_code_url": "https://github.com/rspec/rspec-expectations",
        "toolbox_url": "https://www.ruby-toolbox.com/projects/rspec-expectations",
        "wiki_url": null
      }
    },
    {
      "permalink": "rubocop",
      "categories": [
        {
          "permalink": "code_metrics",
          "category_group": {
            "permalink": "Code_Quality",
            "description": null,
            "name": "Code Quality"
          },
          "description": "Utilities to improve code quality by reporting common code smells like complexity, unsafe defaults, unused variables or stylistic inconsistencies",
          "name": "Code Metrics",
          "urls": {
            "toolbox_url": "https://www.ruby-toolbox.com/categories/code_metrics"
          }
        }
      ],
      "description": "RuboCop is a Ruby code style checking and code formatting tool.\nIt aims to enforce the community-driven Ruby Style Guide.\n",
      "github_repo": {
        "path": "rubocop/rubocop",
        "average_recent_committed_at": "2024-03-10 23:08:23 UTC",
        "description": "A Ruby static code analyzer and formatter, based on the community Ruby style guide.",
        "is_archived": false,
        "is_fork": false,
        "is_mirror": false,
        "issues": {
          "url": "https://github.com/rubocop/rubocop/issues",
          "open_count": 336,
          "closed_count": 5182,
          "total_count": 5518,
          "closure_rate": "93.91"
        },
        "license": "mit",
        "primary_language": "Ruby",
        "pull_requests": {
          "url": "https://github.com/rubocop/rubocop/pulls",
          "open_count": 39,
          "closed_count": 642,
          "merged_count": 6426,
          "total_count": 7107,
          "acceptance_rate": "90.42"
        },
        "repo_pushed_at": "2024-04-15 20:40:46 UTC",
        "stats": {
          "stargazers_count": 12489,
          "forks_count": 2988,
          "watchers_count": 180
        },
        "url": "https://github.com/rubocop/rubocop",
        "wiki_url": null
      },
      "health": {
        "overall_level": "green",
        "statuses": [
          {
            "key": "rubygem_long_running",
            "icon": "diamond",
            "label": "A long-lived project that still receives updates",
            "level": "green"
          }
        ]
      },
      "name": "rubocop",
      "rubygem": {
        "name": "rubocop",
        "current_version": "1.63.1",
        "first_release_on": "2012-05-03",
        "latest_release_on": "2024-04-10",
        "licenses": [
          "MIT"
        ],
        "stats": {
          "downloads": 410403618,
          "reverse_dependencies_count": 10996,
          "quarterly_release_counts": {
            "2012-2": 1,
            "2012-4": 1,
            "2013-1": 4,
            "2013-2": 18,
            "2013-3": 8,
            "2013-4": 4,
            "2014-1": 5,
            "2014-2": 6,
            "2014-3": 4,
            "2014-4": 3,
            "2015-1": 2,
            "2015-2": 5,
            "2015-3": 4,
            "2015-4": 2,
            "2016-1": 6,
            "2016-2": 3,
            "2016-3": 3,
            "2016-4": 4,
            "2017-1": 3,
            "2017-2": 3,
            "2017-3": 1,
            "2017-4": 3,
            "2018-1": 2,
            "2018-2": 5,
            "2018-3": 6,
            "2018-4": 3,
            "2019-1": 6,
            "2019-2": 9,
            "2019-3": 3,
            "2019-4": 4,
            "2020-1": 3,
            "2020-2": 7,
            "2020-3": 9,
            "2020-4": 16,
            "2021-1": 7,
            "2021-2": 9,
            "2021-3": 8,
            "2021-4": 6,
            "2022-1": 4,
            "2022-2": 10,
            "2022-3": 8,
            "2022-4": 7,
            "2023-1": 10,
            "2023-2": 9,
            "2023-3": 10,
            "2023-4": 5,
            "2024-1": 6,
            "2024-2": 2
          },
          "releases_count": 267
        },
        "url": "https://rubygems.org/gems/rubocop"
      },
      "score": "17.63",
      "urls": {
        "bug_tracker_url": "https://github.com/rubocop/rubocop/issues",
        "changelog_url": null,
        "documentation_url": "https://docs.rubocop.org/rubocop/1.63/",
        "homepage_url": "https://rubocop.org/",
        "mailing_list_url": null,
        "source_code_url": "https://github.com/rubocop/rubocop/",
        "toolbox_url": "https://www.ruby-toolbox.com/projects/rubocop",
        "wiki_url": null
      }
    }
  ]
}