# Actor Portfolio Analytics (`ryanclinton/actor-portfolio-analytics`) Actor Aggregate stats, trends, and forecasting across your entire Apify actor portfolio. Connect your API token for instant fleet-wide visibility into runs, users, revenue, and health. - **URL**: https://apify.com/ryanclinton/actor-portfolio-analytics.md - **Developed by:** [Ryan Clinton](https://apify.com/ryanclinton) (community) - **Categories:** Developer tools, AI - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $100.00 / 1,000 fleet analyzeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## ApifyForge Fleet Analytics -- Full Account Dashboard Get a complete, data-driven overview of your entire Apify actor portfolio in a single API call. ApifyForge Fleet Analytics scans every actor in your account, pulls run statistics from the Apify Store API, computes failure rates from recent run history, estimates monthly revenue from PPE pricing, and packages everything into a structured JSON report. Whether you manage 5 actors or 500, this tool gives you the numbers you need to make informed decisions about what to build, fix, or deprecate. ### Why use ApifyForge Fleet Analytics? - **One call, full picture.** Instead of clicking through dozens of actor dashboards, get aggregated stats for your entire fleet in a single structured output. - **Revenue estimation.** Automatically calculates estimated monthly revenue by multiplying each actor's 30-day run volume by its Pay-Per-Event price. - **Failure detection.** Identifies actors with failure rates above 10% by sampling the last 100 runs and filtering to the 30-day window. - **Stale actor identification.** Flags actors with zero runs in the last 30 days so you can decide whether to update or deprecate them. - **Category breakdown.** Shows how your actors are distributed across Apify Store categories so you can spot gaps or overconcentration. - **Top performers.** Ranks your actors by run volume and user count so you know which ones are carrying your portfolio. - **Dashboard-ready output.** Designed to feed directly into the [ApifyForge dashboard](https://apifyforge.com) for visualization and trend tracking. ### Key Features - Fetches all actors from your account via paginated API calls (handles accounts with 100+ actors) - Enriches data with Apify Store statistics (users, runs, builds) - Pulls actor detail endpoint for PPE pricing configuration - Samples last 100 runs per actor to compute actual success/failure rates over 30 days - Computes weighted fleet-wide success rate (weighted by run volume so high-traffic actors count more) - Identifies top 10 actors by runs and by users - Estimates monthly revenue from PPE pricing multiplied by 30-day run counts - Outputs a single comprehensive JSON object to the default dataset ### How to Use 1. Go to [ApifyForge Fleet Analytics](https://apify.com/ryanclinton/apifyforge-fleet-analytics) on the Apify Store. 2. Click **Try for free**. 3. Enter your **Apify API Token** (find it at [Settings > Integrations](https://console.apify.com/settings/integrations)). 4. Click **Start**. 5. Wait for the run to complete (typically 30-120 seconds depending on fleet size). 6. View the results in the **Dataset** tab, or download as JSON. ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `apifyToken` | string | Yes | -- | Your Apify API token. Used to authenticate all API calls. Find it at https://console.apify.com/settings/integrations | ### Input Examples **Standard analysis of your full fleet:** ```json { "apifyToken": "apify_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" } ```` **Using the actor via API with a saved token:** ```json { "apifyToken": "apify_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" } ``` ### Output Example ```json { "totalActors": 211, "publicActors": 198, "privateActors": 13, "totalRuns30d": 48523, "totalUsers30d": 1247, "totalUsers7d": 389, "successRate": 97.3, "topActorsByRuns": [ { "name": "google-maps-scraper", "id": "abc123", "runs30d": 8421 }, { "name": "linkedin-scraper", "id": "def456", "runs30d": 5102 }, { "name": "amazon-product-api", "id": "ghi789", "runs30d": 3890 }, { "name": "twitter-scraper", "id": "jkl012", "runs30d": 2744 }, { "name": "youtube-channel-scraper", "id": "mno345", "runs30d": 2301 } ], "topActorsByUsers": [ { "name": "google-maps-scraper", "id": "abc123", "users30d": 312 }, { "name": "linkedin-scraper", "id": "def456", "users30d": 198 }, { "name": "amazon-product-api", "id": "ghi789", "users30d": 145 }, { "name": "twitter-scraper", "id": "jkl012", "users30d": 89 }, { "name": "youtube-channel-scraper", "id": "mno345", "users30d": 76 } ], "categoryBreakdown": { "DEVELOPER_TOOLS": 85, "AI": 72, "SOCIAL_MEDIA": 28, "SEO_TOOLS": 15, "ECOMMERCE": 11 }, "actorsWithNoRuns30d": [ { "name": "legacy-email-validator", "id": "xyz001", "lastRunAt": "2025-11-15T10:30:00.000Z" }, { "name": "old-rss-parser", "id": "xyz002", "lastRunAt": "2025-12-01T08:00:00.000Z" } ], "actorsWithHighFailRate": [ { "name": "unstable-scraper", "id": "fail01", "failRate": 34.5, "runs30d": 29 }, { "name": "broken-api-wrapper", "id": "fail02", "failRate": 18.2, "runs30d": 11 } ], "estimatedMonthlyRevenue": 4821.50, "analyzedAt": "2026-03-16T14:30:00.000Z" } ``` ### Output Fields | Field | Type | Description | |-------|------|-------------| | `totalActors` | number | Total number of actors in your account | | `publicActors` | number | Number of actors published publicly on the Apify Store | | `privateActors` | number | Number of private (unlisted) actors | | `totalRuns30d` | number | Aggregate run count across all actors in the last 30 days | | `totalUsers30d` | number | Aggregate unique user count across all actors in the last 30 days | | `totalUsers7d` | number | Aggregate unique user count across all actors in the last 7 days | | `successRate` | number | Fleet-wide weighted success rate (percentage, weighted by run volume) | | `topActorsByRuns` | array | Top 10 actors ranked by 30-day run count. Each entry has `name`, `id`, `runs30d`. | | `topActorsByUsers` | array | Top 10 actors ranked by 30-day unique user count. Each entry has `name`, `id`, `users30d`. | | `categoryBreakdown` | object | Map of Apify Store category names to the number of your actors in each category | | `actorsWithNoRuns30d` | array | Actors with zero runs in the last 30 days. Each entry has `name`, `id`, and optional `lastRunAt` timestamp. | | `actorsWithHighFailRate` | array | Actors with >10% failure rate and at least 5 recent runs. Each entry has `name`, `id`, `failRate` (percentage), and `runs30d`. | | `estimatedMonthlyRevenue` | number | Estimated total monthly revenue in USD, calculated as SUM(runs30d \* ppePrice) for all actors with PPE pricing | | `analyzedAt` | string | ISO 8601 timestamp of when the analysis was performed | ### Programmatic Access #### Python ```python from apify_client import ApifyClient client = ApifyClient("apify_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxx") run = client.actor("ryanclinton/apifyforge-fleet-analytics").call( run_input={"apifyToken": "apify_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"} ) dataset_items = client.dataset(run["defaultDatasetId"]).list_items().items analytics = dataset_items[0] print(f"Total actors: {analytics['totalActors']}") print(f"30-day runs: {analytics['totalRuns30d']}") print(f"Success rate: {analytics['successRate']}%") print(f"Estimated revenue: ${analytics['estimatedMonthlyRevenue']}") for actor in analytics["topActorsByRuns"][:5]: print(f" {actor['name']}: {actor['runs30d']} runs") ``` #### JavaScript ```javascript import { ApifyClient } from "apify-client"; const client = new ApifyClient({ token: "apify_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxx", }); const run = await client.actor("ryanclinton/apifyforge-fleet-analytics").call({ apifyToken: "apify_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxx", }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); const analytics = items[0]; console.log(`Total actors: ${analytics.totalActors}`); console.log(`30-day runs: ${analytics.totalRuns30d}`); console.log(`Success rate: ${analytics.successRate}%`); console.log(`Estimated revenue: $${analytics.estimatedMonthlyRevenue}`); ``` #### cURL ```bash ## Start the actor run curl -X POST "https://api.apify.com/v2/acts/ryanclinton~apifyforge-fleet-analytics/runs?token=YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"apifyToken": "apify_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"}' ## Fetch results from the default dataset (use the defaultDatasetId from the run response) curl "https://api.apify.com/v2/datasets/DATASET_ID/items?token=YOUR_API_TOKEN" ``` ### How It Works ApifyForge Fleet Analytics executes a multi-stage pipeline to build your fleet overview: 1. **Actor enumeration.** Calls `GET /v2/acts?my=true` with pagination (100 per page) to retrieve every actor in your account. This returns basic metadata including name, ID, public/private status, and summary stats. 2. **Username resolution.** Extracts your username from the first actor record, or falls back to the `GET /v2/users/me` endpoint if needed. The username is required to query the Store API. 3. **Store enrichment.** Calls `GET /v2/store?username=YOUR_USERNAME` with pagination to pull Apify Store statistics. Store stats include more granular user counts (7-day, 30-day) and run counts that may differ from the actor list endpoint. 4. **Detail fetching.** For each actor, calls `GET /v2/acts/{actorId}` to retrieve full details including PPE pricing configuration, categories, and tagged builds. This is the only endpoint that exposes `pricingInfos`. 5. **Run sampling.** For each actor, fetches the last 100 runs via `GET /v2/acts/{actorId}/runs?limit=100&desc=true`. Filters to runs started within the last 30 days and computes success/failure rates. Actors with >10% failure rate and at least 5 runs are flagged. 6. **Aggregation.** Computes fleet-wide totals (runs, users, categories), weighted success rate, estimated revenue, and identifies stale actors (zero runs in 30 days). Ranks actors by runs and users to surface the top 10. 7. **Output.** Pushes the complete analytics object to the default dataset and charges one PPE event. ### How Much Does It Cost? ApifyForge Fleet Analytics uses Pay-Per-Event pricing at **$0.10 per analysis**. | Scenario | Events | Cost | |----------|--------|------| | One-time fleet overview | 1 | $0.10 | | Weekly monitoring (4x/month) | 4 | $0.40 | | Daily monitoring (30x/month) | 30 | $3.00 | In addition to the PPE charge, standard Apify platform compute costs apply based on memory usage and runtime. A typical analysis of 200+ actors completes in under 2 minutes using 256 MB of memory. ### Tips - **Schedule regular runs.** Set up a daily or weekly schedule to track trends over time. Each run creates a new dataset entry, giving you historical data for your ApifyForge dashboard. - **Investigate high-fail actors first.** The `actorsWithHighFailRate` array is sorted by failure rate. Fix these to improve your fleet-wide success rate and prevent user churn. - **Revenue gaps.** Compare `actorsWithNoRuns30d` against the rest. Actors with zero runs but historical traffic may need updated descriptions or bug fixes to regain users. - **Category strategy.** Use `categoryBreakdown` to see where you are concentrated. Diversifying across categories reduces dependency on a single market segment. - **Cross-reference with Quality Monitor.** Pair fleet analytics with the ApifyForge Quality Monitor to correlate quality scores with run volume and revenue. ### Limitations - **Run sampling limit.** Only the last 100 runs per actor are sampled. For actors with very high run volumes, the 30-day failure rate may not reflect all runs. - **Revenue is estimated.** Revenue calculations use `runs30d * ppePrice` as a proxy. Actual revenue depends on event-level billing, which may differ from 1:1 run-to-event ratios for some actors. - **Store stats lag.** Apify Store statistics may be cached and lag behind real-time data by up to 24 hours. - **Single account only.** This actor analyzes one Apify account per run. Multi-account analysis requires separate runs with different tokens. - **API rate limits.** For very large fleets (500+ actors), the actor makes hundreds of API calls and may take several minutes. The 5-minute timeout is usually sufficient for up to 300 actors. ### Frequently Asked Questions **How long does a fleet analysis take?** Typically 30-120 seconds for 50-200 actors. Each actor requires 2-3 API calls (detail + runs + optional store), so a fleet of 200 actors makes roughly 400-600 API calls. The 5-minute timeout is generous for most accounts. **Is my API token stored anywhere?** No. Your API token is used only during the run to make authenticated API calls. It is not logged, stored, or transmitted to any third party. The token is marked as `isSecret` in the input schema, meaning Apify redacts it from logs. **Can I use this with a free Apify account?** Yes. The actor works with any Apify account that has a valid API token. However, free accounts may have fewer actors and lower API rate limits. **How does the weighted success rate work?** The fleet-wide success rate is weighted by run volume. An actor with 10,000 runs and 99% success rate contributes more to the fleet score than an actor with 5 runs and 50% success rate. This prevents low-traffic actors from disproportionately skewing the fleet health metric. ### Integration with ApifyForge Dashboard This actor is one of five data sources that power the [ApifyForge dashboard](https://apifyforge.com). When connected to your ApifyForge account, fleet analytics data is automatically visualized with trend charts, actor rankings, revenue projections, and health indicators. Schedule this actor to run daily and the dashboard will show historical trends, letting you track growth and spot issues before they become problems. # Actor input Schema ## `apifyToken` (type: `string`): Your Apify API token. Find it at https://console.apify.com/settings/integrations ## Actor input object example ```json {} ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("ryanclinton/actor-portfolio-analytics").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("ryanclinton/actor-portfolio-analytics").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call ryanclinton/actor-portfolio-analytics --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=ryanclinton/actor-portfolio-analytics", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Actor Portfolio Analytics", "description": "Aggregate stats, trends, and forecasting across your entire Apify actor portfolio. Connect your API token for instant fleet-wide visibility into runs, users, revenue, and health.", "version": "1.0", "x-build-id": "4xhV6RehgZok6Arae" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ryanclinton~actor-portfolio-analytics/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ryanclinton-actor-portfolio-analytics", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/ryanclinton~actor-portfolio-analytics/runs": { "post": { "operationId": "runs-sync-ryanclinton-actor-portfolio-analytics", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/ryanclinton~actor-portfolio-analytics/run-sync": { "post": { "operationId": "run-sync-ryanclinton-actor-portfolio-analytics", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "apifyToken" ], "properties": { "apifyToken": { "title": "Apify API Token", "type": "string", "description": "Your Apify API token. Find it at https://console.apify.com/settings/integrations" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```