Linking RubyGems.org as a source

Let AI connect your sources for you

Skip the manual setup — run this in your project and the wizard auto-detects your databases and APIs and connects them to PostHog.

Learn more

The RubyGems.org connector syncs gem metadata and version history into PostHog. Use it to track download statistics, monitor releases, and join gem data with your product analytics.

Alpha feature

The RubyGems.org source is currently in alpha. We'd love to hear your feedback.

Requirements

RubyGems.org's read APIs are public, so no credentials or API keys are required. You only need the names of the gems you want to track.

Setup

Go to the Data pipeline page and select the Sources tab.
Click + New source and select RubyGems.org.

In the Gems field, enter the gem names you want to track – one per line or comma-separated. For example:

rails
rspec
devise

You can add up to 500 gems per source.

Click Next, select the tables you want to sync, choose the sync frequency, and click Import.

The data warehouse then starts syncing your RubyGems.org data. You can see details and progress in the data pipeline sources tab.

Configuration

Option	Type	Required
`Gems`	textarea	Yes

Supported tables

Table	Description	Sync method	Incremental field	Primary key
`gems`	Current metadata and cumulative download count for each configured gem, from GET /api/v1/gems/{name}.json.	Full refresh	—	—
`versions`	Every published version of each configured gem, including per-version download counts, from GET /api/v1/versions/{name}.json.	Full refresh	created_at	—

Sync method

All tables sync as full refresh. RubyGems.org's API has no server-side timestamp filter, so incremental sync is not supported. Each sync fetches the current metadata and full version history for every configured gem.

Table	Sync method
`gems`	Full refresh
`versions`	Full refresh

Available tables

gems

Current metadata and cumulative download count for each configured gem, from GET /api/v1/gems/{name}.json.

Primary key: name

Column	Description
`name`	Gem name as registered on RubyGems.org
`downloads`	Total cumulative downloads across all versions and platforms
`version`	Latest published version number
`version_created_at`	Timestamp the latest version was published
`version_downloads`	Cumulative downloads of the latest version
`platform`	Platform of the latest version (e.g. `ruby`, `java`)
`authors`	Comma-separated list of gem authors
`info`	Gem description/summary text
`licenses`	List of licenses declared by the gem
`metadata`	Free-form metadata map from the gemspec (changelog, source URIs, etc.)
`project_uri`	Canonical RubyGems.org page for the gem
`gem_uri`	Direct download URL for the latest version's `.gem` file
`homepage_uri`	Project homepage URL, if declared
`source_code_uri`	Source code repository URL, if declared
`changelog_uri`	Changelog URL, if declared
`dependencies`	Runtime and development dependencies of the latest version

versions

Every published version of each configured gem, including per-version download counts, from GET /api/v1/versions/{name}.json.

Primary key: gem_name, number, platform (composite)

Column	Description
`gem_name`	Gem the version belongs to (injected by the connector)
`number`	Version number (e.g. `1.2.3`)
`platform`	Build platform this version was published for (e.g. `ruby`, `java`)
`created_at`	Timestamp the version was published
`downloads_count`	Cumulative downloads of this specific version
`authors`	Comma-separated list of authors at this version
`licenses`	List of licenses declared at this version
`summary`	Short one-line summary of the gem at this version
`prerelease`	Whether this version is a prerelease
`sha`	SHA-256 checksum of this version's `.gem` file

Inbound IP addresses

We use a set of IP addresses to access your instance. To ensure this connector works, add these IPs to your inbound security rules:

US	EU
44.205.89.55	3.75.65.221
52.4.194.122	18.197.246.42
44.208.188.173	3.120.223.253