RubyGems website screenshot

RubyGems

RubyGems.org is the Ruby community's primary gem hosting service, providing the infrastructure for publishing, discovering, and installing Ruby gems. The RubyGems API enables programmatic access to gem metadata, version information, download statistics, search, owner management, webhooks, and the compact index used by Bundler for dependency resolution. RubyGems.org hosts over 160,000 gems with billions of total downloads.

RubyGems publishes 9 APIs on the APIs.io network, including Gems API, Downloads API, Search API, and 6 more. Tagged areas include Ruby, Package Manager, Open Source, and Developer Tools.

The RubyGems catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 3 Spectral governance rulesets.

RubyGems’ developer surface includes authentication, developer portal, documentation, GitHub presence, engineering blog, and 5 more developer resources.

45.6/100 developing ▬ flat Agent 50/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessSelf serve
9 APIs
RubyPackage ManagerOpen SourceDeveloper Tools

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 45.6/100 · developing
Contract Quality 18.0 / 25
Developer Ergonomics 6.1 / 20
Commercial Clarity 5.8 / 20
Operational Transparency 6.8 / 13
Governance 2.5 / 12
Discoverability 6.5 / 10
Agent readiness — 50/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/rubygems: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 9

Individual APIs this provider publishes, each with its own machine-readable definition.

RubyGems Gems API

The RubyGems Gems API (v1) provides endpoints for retrieving gem metadata, listing owned gems, submitting new gems, yanking gem versions, managing gem ownership, retrieving user...

RubyGems Downloads API

The RubyGems Downloads API provides download count statistics for gems and individual gem versions hosted on RubyGems.org.

RubyGems Search API

The RubyGems Search API allows developers to search for gems by matching a query string against gem names and descriptions. Returns paginated results of active gems.

RubyGems Activity API

The RubyGems Activity API provides activity feeds of the most recently added and most recently updated gems on RubyGems.org, useful for monitoring new releases and tracking ecos...

RubyGems Webhooks API

The RubyGems Webhooks API enables webhook subscriptions that fire when gems are pushed to RubyGems.org. Webhooks can be scoped to a specific gem or applied globally using a wild...

RubyGems Dependencies API

Endpoints for querying gem dependency information.

RubyGems Owners API

Endpoints for managing gem ownership, including listing owners, adding and removing owners, and listing gems by owner.

RubyGems Profiles API

Endpoints for retrieving user profile information from RubyGems.org.

RubyGems Versions API

Endpoints for querying detailed version information for specific gem versions, including metadata, dependencies, checksums, and platform-specific builds.

Scroll for all 9

Open Collections 6

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

RubyGems Activity API

OPEN COLLECTION

RubyGems API V2

OPEN COLLECTION

RubyGems Downloads API

OPEN COLLECTION

RubyGems Gems API

OPEN COLLECTION

RubyGems Search API

OPEN COLLECTION

RubyGems Webhooks API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Rubygems Rate Limits

6 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

RubyGems Webhook Events

The RubyGems webhook event system delivers HTTP POST notifications when gems are pushed to RubyGems.org. Webhook subscribers receive a JSON payload containing the full gem metad...

ASYNCAPI

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Rubygems Context

0 classes · 5 properties

JSON-LD

Spectral Rules 3

Spectral governance rulesets for linting and validating these APIs.

RubyGems API Rules

3 rules · 1 errors 2 warnings

SPECTRAL

RubyGems API Rules

6 rules · 5 warnings 1 info

SPECTRAL

RubyGems API Rules

16 rules · 2 errors 13 warnings 1 info

SPECTRAL

JSON Schema 1

Standalone JSON Schema definitions for this provider's data models.

RubyGems Gem

23 properties

JSON SCHEMA

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Rubygems Structure

0 properties

JSON STRUCTURE

Examples 2

Example request and response payloads for these APIs.

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Rubygems Authentication

apiKey/http · 2 schemes

SECURITY

Rubygems Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Rubygems Agentic Access

28 operations · 9 acting

28 operations · 9 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 3

Authentication, authorization, and security posture

Operate 1

Status, limits, changes, and where to get help

Company 1

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: rubygems
name: RubyGems
description: RubyGems.org is the Ruby community's primary gem hosting service, providing the infrastructure for publishing,
  discovering, and installing Ruby gems. The RubyGems API enables programmatic access to gem metadata, version information,
  download statistics, search, owner management, webhooks, and the compact index used by Bundler for dependency resolution.
  RubyGems.org hosts over 160,000 gems with billions of total downloads.
type: Index
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
position: Consumer
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/rubygems.png
tags:
- Ruby
- Package Manager
- Open Source
- Developer Tools
created: '2025-01-01'
modified: '2026-05-19'
url: https://raw.githubusercontent.com/api-evangelist/rubygems/refs/heads/main/apis.yml
specificationVersion: '0.19'
apis:
- aid: rubygems:gems-api
  name: RubyGems Gems API
  description: The RubyGems Gems API (v1) provides endpoints for retrieving gem metadata, listing owned gems, submitting new
    gems, yanking gem versions, managing gem ownership, retrieving user profiles, querying gem dependencies, and exchanging
    OIDC tokens for API keys for trusted publishing workflows.
  humanURL: https://guides.rubygems.org/rubygems-org-api/
  baseURL: https://rubygems.org/api/v1
  tags:
  - Ruby
  - Gems
  - Package Manager
  properties:
  - type: Documentation
    url: https://guides.rubygems.org/rubygems-org-api/
  - type: OpenAPI
    url: https://raw.githubusercontent.com/api-evangelist/rubygems/refs/heads/main/openapi/rubygems-gems-api-openapi.yml
- aid: rubygems:downloads-api
  name: RubyGems Downloads API
  description: The RubyGems Downloads API provides download count statistics for gems and individual gem versions hosted on
    RubyGems.org.
  humanURL: https://guides.rubygems.org/rubygems-org-api/
  baseURL: https://rubygems.org/api/v1
  tags:
  - Ruby
  - Downloads
  - Statistics
  properties:
  - type: Documentation
    url: https://guides.rubygems.org/rubygems-org-api/
  - type: OpenAPI
    url: https://raw.githubusercontent.com/api-evangelist/rubygems/refs/heads/main/openapi/rubygems-downloads-api-openapi.yml
- aid: rubygems:search-api
  name: RubyGems Search API
  description: The RubyGems Search API allows developers to search for gems by matching a query string against gem names and
    descriptions. Returns paginated results of active gems.
  humanURL: https://guides.rubygems.org/rubygems-org-api/
  baseURL: https://rubygems.org/api/v1
  tags:
  - Ruby
  - Search
  - Discovery
  properties:
  - type: Documentation
    url: https://guides.rubygems.org/rubygems-org-api/
  - type: OpenAPI
    url: https://raw.githubusercontent.com/api-evangelist/rubygems/refs/heads/main/openapi/rubygems-search-api-openapi.yml
- aid: rubygems:activity-api
  name: RubyGems Activity API
  description: The RubyGems Activity API provides activity feeds of the most recently added and most recently updated gems
    on RubyGems.org, useful for monitoring new releases and tracking ecosystem changes.
  humanURL: https://guides.rubygems.org/rubygems-org-api/
  baseURL: https://rubygems.org/api/v1
  tags:
  - Ruby
  - Activity
  - Monitoring
  properties:
  - type: Documentation
    url: https://guides.rubygems.org/rubygems-org-api/
  - type: OpenAPI
    url: https://raw.githubusercontent.com/api-evangelist/rubygems/refs/heads/main/openapi/rubygems-activity-api-openapi.yml
- aid: rubygems:webhooks-api
  name: RubyGems Webhooks API
  description: The RubyGems Webhooks API enables webhook subscriptions that fire when gems are pushed to RubyGems.org. Webhooks
    can be scoped to a specific gem or applied globally using a wildcard. Includes test-fire functionality and HMAC signature
    verification.
  humanURL: https://guides.rubygems.org/rubygems-org-api/
  baseURL: https://rubygems.org/api/v1
  tags:
  - Ruby
  - Webhooks
  - Events
  properties:
  - type: Documentation
    url: https://guides.rubygems.org/rubygems-org-api/
  - type: OpenAPI
    url: https://raw.githubusercontent.com/api-evangelist/rubygems/refs/heads/main/openapi/rubygems-webhooks-api-openapi.yml
  - type: AsyncAPI
    url: https://raw.githubusercontent.com/api-evangelist/rubygems/refs/heads/main/asyncapi/rubygems-webhooks-asyncapi.yml
- aid: rubygems:rubygems-dependencies-api
  name: RubyGems Dependencies API
  description: Endpoints for querying gem dependency information.
  humanURL: https://guides.rubygems.org/rubygems-org-api/
  baseURL: https://rubygems.org/api/v1
  tags:
  - Dependencies
  properties:
  - type: OpenAPI
    url: openapi/rubygems-dependencies-api-openapi.yml
  - type: Documentation
    url: https://guides.rubygems.org/rubygems-org-api-v2/
- aid: rubygems:rubygems-owners-api
  name: RubyGems Owners API
  description: Endpoints for managing gem ownership, including listing owners, adding and removing owners, and listing gems
    by owner.
  humanURL: https://guides.rubygems.org/rubygems-org-api/
  baseURL: https://rubygems.org/api/v1
  tags:
  - Owners
  properties:
  - type: OpenAPI
    url: openapi/rubygems-owners-api-openapi.yml
  - type: Documentation
    url: https://guides.rubygems.org/rubygems-org-api-v2/
- aid: rubygems:rubygems-profiles-api
  name: RubyGems Profiles API
  description: Endpoints for retrieving user profile information from RubyGems.org.
  humanURL: https://guides.rubygems.org/rubygems-org-api/
  baseURL: https://rubygems.org/api/v1
  tags:
  - Profiles
  properties:
  - type: OpenAPI
    url: openapi/rubygems-profiles-api-openapi.yml
  - type: Documentation
    url: https://guides.rubygems.org/rubygems-org-api-v2/
- aid: rubygems:rubygems-versions-api
  name: RubyGems Versions API
  description: Endpoints for querying detailed version information for specific gem versions, including metadata, dependencies,
    checksums, and platform-specific builds.
  humanURL: https://guides.rubygems.org/rubygems-org-api/
  baseURL: https://rubygems.org/api/v1
  tags:
  - Versions
  properties:
  - type: OpenAPI
    url: openapi/rubygems-versions-api-openapi.yml
  - type: Documentation
    url: https://guides.rubygems.org/rubygems-org-api-v2/
common:
- type: AgenticAccess
  url: agentic-access/rubygems-agentic-access.yml
- type: DomainSecurity
  url: security/rubygems-domain-security.yml
- type: Authentication
  url: authentication/rubygems-authentication.yml
- type: Portal
  url: https://rubygems.org/
- type: Documentation
  url: https://guides.rubygems.org/
- type: Authentication
  url: https://guides.rubygems.org/api-key-scopes/
- type: GitHub
  url: https://github.com/rubygems/rubygems.org
- type: StatusPage
  url: https://status.rubygems.org/
- type: Blog
  url: https://blog.rubygems.org/
- type: LlmsText
  url: https://blog.rubygems.org/llms.txt
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com