About this API
RubyGems.org is the public registry for Ruby libraries. This API reads its list of popular gems and returns a record for each one: the gem name, a short summary, total downloads and the link to its page.
Total downloads is the count the registry shows. Summaries are cut short by the source, so use the gem link when you need the full text.
Typical uses
- Rank gems by total downloads.
- Find popular gems that match a search word.
- Track which gems stay popular over time.
What you get
| Field | Type | Sample value |
|---|---|---|
title |
string | bundler |
description |
string | Bundler manages an application's dependencies through its entire life, across m… |
total_downloads |
integer | 3906071902 |
url |
string | rubygems.org/gems/bundler |
Every field with its type, and the schemas, are in contract.json.
Sample records
2 saved records. This is a saved sample, not a live run.
title |
description |
total_downloads |
url |
|---|---|---|---|
| bundler | Bundler manages an application's dependencies through its entire life, across m… | 3906071902 | rubygems.org/gems/bundler |
| multi_json | A common interface to multiple JSON libraries, including fast_jsonparser, Oj, Y… | 1188317280 | rubygems.org/gems/multi_json |
Scroll sideways to see more columns.
Inputs
-
searchstringOptional. Text for the site's search box. Leave it out to read everything.
continuation and read_on resume a run that stopped early; see contract.json.
Request
POST https://broker.cleanedweb.com/v1/catalog/public/apis/generated_665926ddf5efd1f7dad7adb3/endpoints/generated_665926ddf5efd1f7dad7adb3_search/run
curl -X POST https://broker.cleanedweb.com/v1/catalog/public/apis/generated_665926ddf5efd1f7dad7adb3/endpoints/generated_665926ddf5efd1f7dad7adb3_search/run \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: UNIQUE_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{
"input": {},
"max_items": 25
}'Save the Idempotency-Key before you send, and reuse it only to retry the same request. The key needs the run scope. See Run a catalog API.
Coverage
- Category
- Public data
- Languages
- English
Limitations
- Summaries are shortened by the source. The latest version is not returned.
Reach. A run reads until the source ends or your max_items, timeout_seconds or budget stops it.
CleanedWeb is not affiliated with RubyGems.