# GitHub Marketplace Apps – Adoption, Plans & Permissions (`maydit/github-marketplace-app-monitor`) Actor

Monitor public GitHub Marketplace app installs, USD plans and requested permissions. Compare saved observations with exact source links; no login, private accounts or revenue estimates.

- **URL**: https://apify.com/maydit/github-marketplace-app-monitor.md
- **Developed by:** [Brandt May](https://apify.com/maydit) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 saved observations

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

![GitHub Marketplace Apps — illustrative workflow](https://mayd-it.com/assets/actor-banners/github-marketplace-app-monitor-b39961d472c2.png)

## GitHub Marketplace Apps – Adoption, Plans & Permissions

Which competing GitHub apps changed adoption, billing plans or requested access? Keep actual public adoption evidence separate from paid-seat assumptions, and identify plan or permission changes without manually revisiting every app.

### Start with a small useful result

Built for devtool vendors, procurement analysts and agencies following a shortlist of public GitHub apps. No API key or login is required. Press **Start** for at most three real public observations, or use one of the exact input recipes below. Each saved row includes `recordId`, `title`, `url`, `sourceUrl` and `observedAt`.

### What you get

Each row includes a stable listing ID, title, publisher verification, exact public installation count, normalized public plans, and permission groups. Plans preserve cents as well as USD amounts, free/per-unit/flat-rate distinctions and annual versus monthly terms. `installationChange` is a signed difference between your saved observations; a decreased counter is explicitly marked. A plan’s `directBilling` flag remains visible. No competitor customer lists, support emails, CSRF values, account state or private repository details are exported.

### Three practical recipes

#### Compare AI review and code coverage apps

Observe CodeRabbit and Codecov installs, plans and permissions without deriving revenue.

```json
{
  "appSlugs": [
    "coderabbitai",
    "codecov"
  ],
  "maxResults": 2
}
```

#### Inspect a security app through its public URL

Read Snyk’s published Marketplace app metadata and exact billing units.

```json
{
  "startUrls": [
    "https://github.com/marketplace/snyk"
  ],
  "maxResults": 1
}
```

#### Start a recurring code-review pricing watch

Establish a complete saved CodeRabbit baseline, then compare subsequent observations.

```json
{
  "appSlugs": [
    "coderabbitai"
  ],
  "maxResults": 1,
  "comparePrevious": true,
  "snapshotName": "code-review-plan-watch"
}
```

### Scheduled monitoring and reliable comparisons

Set `comparePrevious: true` and a stable `snapshotName`. The first complete run saves a baseline and marks rows `new`; later runs identify `changed` or `unchanged` observations with `changedFields` and `previous`. `onlyChanges: true` suppresses unchanged output and can legitimately produce zero rows. Scope fields are part of the history key; a different watchlist/filter creates a separate scope. We never infer an item was deleted from missing search results.

A failed source, incomplete window, output truncation, deadline or spending cap prevents the baseline from advancing. Previously saved history remains intact. The last accepted billable row is retained even if it reaches your spending cap; rejected rows are never represented as saved. Concurrent history changes are detected instead of overwritten.

### Coverage and limits

- Installations are public aggregate counters, not paid users, active users or revenue.
- GitHub plan prices are USD; annual prices cover the whole year. Missing plan prices remain null. `lowestPaidMonthlyUsd` is the smallest published plan amount, not total spend: inspect each plan’s billing model and unit before comparing per-seat and flat-rate offers.
- Permissions are the published request groups, not a security audit or permissions actually granted by any customer.
- Anonymous app detail pages only; robots are honored and HTTP 401/403/429 stop further requests.
- Up to 20 exact targets and 100 saved results per run; requests are paced by at least one second per source host. The time budget is capped at 120 seconds.
- HTTP 401, 403 or 429 stops remaining source requests. No proxies, login cookies or challenge bypass. Source errors are recorded in `SUMMARY`, never emitted as paid fake data rows.
- A valid filter with no matches can succeed with zero rows. An all-source failure fails honestly.

### Output and pricing

Download JSON or CSV from the dataset, read `SUMMARY` for completeness/source errors, and open the self-contained `RUN_REPORT` for a readable check. Store history is private to the account running the Actor.

The base rate is **$0.002 per confirmed saved observation**, plus **$0.00005 per Actor start**, with standard plan-tier discounts. One observation may contain several nested plans or node types; it remains one result. Source failures and unchanged rows suppressed by `onlyChanges` do not incur a result charge. Apify platform usage may apply according to your plan.

### Source and interpretation

Exact public GitHub Marketplace app pages only. Does not search private organizations, list customer identities, audit repositories/Actions or estimate paid seats or revenue.

[Primary source documentation](https://docs.github.com/en/apps/github-marketplace/selling-your-app-on-github-marketplace/pricing-plans-for-github-marketplace-apps). This is an independent tool, not an official product of the source provider. Ask questions or report a source change through this Actor’s Issues tab.

### Companion workflows

Each Actor runs separately with its own inputs, authorization and pricing. These instructions do not configure automatic execution.

#### [GitHub Repository Change Monitor - Stars, Forks & Activity](https://apify.com/maydit/github-repository-change-monitor)

Add release and repository context to a public Marketplace app shortlist.

1. Verify which public repository, if any, belongs to the app publisher, then supply that repository in the companion tool.
2. Keep app installs and Marketplace pricing separate from repository stars, releases and code activity.

An app can have no public source repository. Similar names do not establish ownership; installs and stars do not measure paying users.

#### [Software Lifecycle Watchlist Monitor](https://apify.com/maydit/software-lifecycle-watchlist-monitor)

Review support lifecycles for the verified software dependencies behind an app deployment.

1. Identify the actual supported runtime or dependency from the app vendor's documentation.
2. Configure those products separately in the lifecycle monitor and retain the documented version identifiers.

A Marketplace permission or category does not reveal a software dependency. This workflow requires manual verification and does not assess an app's security.

# Actor input Schema

## `appSlugs` (type: `array`):

Exact app slugs. Leave both lists empty for coderabbitai, codecov and snyk. Use this list OR startUrls.

## `startUrls` (type: `array`):

Alternative to appSlugs. Only direct public https://github.com/marketplace/app-slug URLs; no queries, Actions, account pages or redirects.

## `maxResults` (type: `integer`):

Cap real output rows. A smaller cap than the matching selected window marks coverage incomplete and preserves the previous baseline.

## `comparePrevious` (type: `boolean`):

First complete run establishes history. Later complete runs add exact changes; incomplete source/output/spending-limited runs do not advance it.

## `onlyChanges` (type: `boolean`):

Enables comparison. A valid unchanged run can return zero rows. No missing-item removal inference.

## `snapshotName` (type: `string`):

Use a stable name for the same scope. Letters, numbers, underscore or hyphen; 1–80 characters.

## `maxRunSeconds` (type: `integer`):

Requests and pacing honor the remaining time. Time-limited runs preserve prior history.

## Actor input object example

```json
{
  "appSlugs": [
    "coderabbitai",
    "codecov",
    "snyk"
  ],
  "startUrls": [],
  "maxResults": 3,
  "comparePrevious": false,
  "onlyChanges": false,
  "snapshotName": "default",
  "maxRunSeconds": 120
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

## `summary` (type: `string`):

No description

## `report` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "appSlugs": [
        "coderabbitai",
        "codecov",
        "snyk"
    ],
    "startUrls": [],
    "maxResults": 3,
    "comparePrevious": false,
    "onlyChanges": false,
    "snapshotName": "default",
    "maxRunSeconds": 120
};

// Run the Actor and wait for it to finish
const run = await client.actor("maydit/github-marketplace-app-monitor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "appSlugs": [
        "coderabbitai",
        "codecov",
        "snyk",
    ],
    "startUrls": [],
    "maxResults": 3,
    "comparePrevious": False,
    "onlyChanges": False,
    "snapshotName": "default",
    "maxRunSeconds": 120,
}

# Run the Actor and wait for it to finish
run = client.actor("maydit/github-marketplace-app-monitor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "appSlugs": [
    "coderabbitai",
    "codecov",
    "snyk"
  ],
  "startUrls": [],
  "maxResults": 3,
  "comparePrevious": false,
  "onlyChanges": false,
  "snapshotName": "default",
  "maxRunSeconds": 120
}' |
apify call maydit/github-marketplace-app-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,maydit/github-marketplace-app-monitor"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/TH9YtQvVdJx8NWldH/builds/wrYQ3Fh12RG7X17Em/openapi.json
