GitHub Release & Changelog Monitor API

Monitor software dependencies and automate your version tracking by scraping GitHub releases, tags, and changelogs. This web scraper is designed to keep engineering, security, and ops teams informed about critical updates without requiring them to manually check a website or conduct a tedious search for release notes. It automatically crawls GitHub repository pages to extract detailed, structured data on version bumps, deprecations, and new features directly from the source. Users typically schedule this tool to run on a daily or weekly basis to catch new releases across dozens of open-source repositories. By providing a simple list of GitHub URLs, you can extract results that seamlessly fit into your existing alerting stack. The actor is perfect for generating a webhook release digest, allowing you to route scraped release summaries directly to Slack, PagerDuty, or Opsgenie so your on-call team maintains full visibility over upstream changes. The scraped data provides everything you need for internal audits, compliance checks, and ticketing automation. Output details include specific fields such as repoUrl, currentVersion, previousVersion, changelogSummary, and isDeprecated. Ensure your software stack remains secure by keeping a constant pulse on the open-source community and tracking repository drift using reliable, automated data extraction.

Store Quickstart

• Start with store-input.example.json for a reliable first run across two public repositories.
• If the output fits your workflow, switch to store-input.templates.json and choose one of:
  • Quickstart (2 repos, dataset) for first success
  • Recurring Team Watchlist for a recurring internal release watch lane
  • Webhook Release Digest when Slack, ticketing, or internal automation should receive only routed release summaries

Key Features

• 🛠️ Developer-focused — CLI-ready JSON output for piping into build/CI tooling
• ⚡ Fast parallel scanning — Concurrent fetches with backoff for high-throughput audits
• 📊 Changelog-aware — Detects version bumps, new releases, and deprecations between runs
• 🔔 Alert integrations — Webhook delivery to Slack/PagerDuty/Opsgenie for on-call visibility
• 🔒 Zero-credentials — Uses only public data — no package-registry API keys required

Use Cases

Who	Why
Developers	Automate recurring data fetches without building custom scrapers
Data teams	Pipe structured output into analytics warehouses
Ops teams	Monitor changes via webhook alerts
Product managers	Track competitor/market signals without engineering time

Input

Field	Type	Default	Description
repositories	array	prefilled	List of repositories to monitor. Each item supports id, name, repo, criticality, owner, tags, modes, releaseUrl, release
requestTimeoutSeconds	integer	30	HTTP request timeout per monitored source.
userAgent	string	—	Optional User-Agent header for upstream requests.
maxChars	integer	35000	Upper bound for extracted text per monitored source.
delivery	string	"dataset"	Where to send summary-first repository results.
datasetMode	string	"changes_only"	Choose every repository row, only changed rows, or only action-needed rows.
webhookUrl	string	—	Required when delivery is webhook.
notifyOnNoChange	boolean	false	When false, webhook delivery skips when there are no changed or action-needed repository summaries.

Input Example

{
  "repositories": [
    {
      "id": "axios",
      "name": "Axios",
      "repo": "axios/axios",
      "criticality": "high",
      "owner": "Platform",
      "tags": ["sdk", "http-client"],
      "modes": ["releases", "tags", "changelog"],
      "changelogUrl": "https://raw.githubusercontent.com/axios/axios/v1.x/CHANGELOG.md"
    },
    {
      "id": "apify-crawlee",
      "name": "Apify Crawlee",
      "repo": "apify/crawlee",
      "criticality": "standard",
      "owner": "Automation",
      "modes": ["releases", "tags"]
    }
  ],
  "delivery": "dataset",
  "datasetMode": "changes_only",
  "snapshotKey": "github-release-monitor-team-watchlist",
  "diffMode": "line_summary",
  "summaryMaxLines": 12,
  "concurrency": 2
}

Output

Field	Type	Description
meta	object
recurringDigest	object
actionNeeded	array
results	array
actionNeeded[].repositoryId	string
actionNeeded[].repositoryName	string
actionNeeded[].repo	string
actionNeeded[].owner	string
actionNeeded[].severity	string
actionNeeded[].status	string
actionNeeded[].reason	string
actionNeeded[].changedSurfaces	array
actionNeeded[].signals	array
actionNeeded[].recommendedActions	array
actionNeeded[].executiveSummary	string

Output Example

{
  "repositoryId": "axios",
  "repositoryName": "Axios",
  "repo": "axios/axios",
  "status": "changed",
  "severity": "high",
  "signals": ["action_required", "deprecation"],
  "recommendedActions": [
    "Review the latest GitHub release notes with Platform and decide whether upgrade, regression-test, or compatibility work is needed.",
    "Read the changelog diff and extract migration, configuration, or rollout work for Platform."
  ],
  "repositorySummary": {
    "changedSurfaces": ["releases", "changelog"],
    "actionNeeded": true
  }
}

API Usage

Run this actor programmatically using the Apify API. Replace YOUR_API_TOKEN with your token from Apify Console → Settings → Integrations.

cURL

curl -X POST "https://api.apify.com/v2/acts/taroyamada~github-release-monitor/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "repositories": [ { "id": "axios", "name": "Axios", "repo": "axios/axios", "criticality": "high", "owner": "Platform", "tags": ["sdk", "http-client"], "modes": ["releases", "tags", "changelog"], "changelogUrl": "https://raw.githubusercontent.com/axios/axios/v1.x/CHANGELOG.md" }, { "id": "apify-crawlee", "name": "Apify Crawlee", "repo": "apify/crawlee", "criticality": "standard", "owner": "Automation", "modes": ["releases", "tags"] } ], "delivery": "dataset", "datasetMode": "changes_only", "snapshotKey": "github-release-monitor-team-watchlist", "diffMode": "line_summary", "summaryMaxLines": 12, "concurrency": 2 }'

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("taroyamada/github-release-monitor").call(run_input={
  "repositories": [
    {
      "id": "axios",
      "name": "Axios",
      "repo": "axios/axios",
      "criticality": "high",
      "owner": "Platform",
      "tags": ["sdk", "http-client"],
      "modes": ["releases", "tags", "changelog"],
      "changelogUrl": "https://raw.githubusercontent.com/axios/axios/v1.x/CHANGELOG.md"
    },
    {
      "id": "apify-crawlee",
      "name": "Apify Crawlee",
      "repo": "apify/crawlee",
      "criticality": "standard",
      "owner": "Automation",
      "modes": ["releases", "tags"]
    }
  ],
  "delivery": "dataset",
  "datasetMode": "changes_only",
  "snapshotKey": "github-release-monitor-team-watchlist",
  "diffMode": "line_summary",
  "summaryMaxLines": 12,
  "concurrency": 2
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

JavaScript / Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });
const run = await client.actor('taroyamada/github-release-monitor').call({
  "repositories": [
    {
      "id": "axios",
      "name": "Axios",
      "repo": "axios/axios",
      "criticality": "high",
      "owner": "Platform",
      "tags": ["sdk", "http-client"],
      "modes": ["releases", "tags", "changelog"],
      "changelogUrl": "https://raw.githubusercontent.com/axios/axios/v1.x/CHANGELOG.md"
    },
    {
      "id": "apify-crawlee",
      "name": "Apify Crawlee",
      "repo": "apify/crawlee",
      "criticality": "standard",
      "owner": "Automation",
      "modes": ["releases", "tags"]
    }
  ],
  "delivery": "dataset",
  "datasetMode": "changes_only",
  "snapshotKey": "github-release-monitor-team-watchlist",
  "diffMode": "line_summary",
  "summaryMaxLines": 12,
  "concurrency": 2
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Tips & Limitations

• Run nightly as part of your supply-chain monitoring to catch new vulnerabilities early.
• Pair with oss-vulnerability-monitor for CVE coverage layered on top of version tracking.
• For monorepos, run per-package rather than recursing — easier to triage alerts by team owner.
• Use snapshotKey to persist between runs and only alert on diffs.
• Webhook delivery supports JSON payloads — pipe into your existing on-call routing.

FAQ

Is my build slowed down?

This actor runs on Apify infrastructure, not your CI runners. No impact on build times.

What's the freshness of data?

Depends on the source registry — typically 5–60 minutes behind upstream.

Can I filter by package ecosystem?

Yes — most DevOps actors accept an ecosystem or package-manager filter in their input schema.

Does this work with private registries?

No — this actor targets public registries (npm, PyPI, crates.io, etc.). Private registries require credential handling that's out of scope.

Can I integrate with GitHub Actions?

Yes — call this actor via Apify API inside a workflow job, parse the JSON output, and fail the build on threshold violations.

Related Actors

DevOps & Tech Intel cluster — explore related Apify tools:

• 🌐 DNS Propagation Checker — Check DNS propagation across 8 global resolvers (Google, Cloudflare, Quad9, OpenDNS).
• 🔍 Subdomain Finder — Discover subdomains for any domain using Certificate Transparency logs (crt.
• 🧹 CSV Data Cleaner — Clean CSV data: trim whitespace, remove empty rows, deduplicate by columns, sort.
• 📦 NPM Package Analyzer — Analyze npm packages: download stats, dependencies, licenses, deprecation status.
• 💬 Reddit Scraper — Scrape Reddit posts and comments from any subreddit via official JSON API.
• Docs & Changelog Drift Monitor API — Monitor release notes, changelog pages, migration guides, and key docs pages with one summary-first target row per monitored repo, SDK, or product.
• Tech Events Calendar API | Conferences + CFP — Aggregate tech conferences and CFPs across multiple sources into a deduplicated event calendar for DevRel and recruiting workflows.
• 🔒 OSS Vulnerability Monitor — Monitor open-source packages for known security vulnerabilities using OSV and GitHub Security Advisories.

Cost

Pay Per Event:

• actor-start: $0.01 (flat fee per run)
• dataset-item: $0.003 per output item

Example: 1,000 items = $0.01 + (1,000 × $0.003) = $3.01

No subscription required — you only pay for what you use.

⭐ Was this helpful?

If this actor saved you time, please leave a ★ rating on Apify Store. It takes 10 seconds, helps other developers discover it, and keeps updates free.

Bug report or feature request? Open an issue on the Issues tab of this actor.