ApifyForge Help & FAQ

ApifyForge gives you fleet-level control over every actor you own through a CLI-first workflow. It pulls run history, revenue data, quality scores, and Store rankings into a single dashboard with 15 d...

ApifyForge has no platform fee, no subscription, and no premium tiers. Each actor is individually priced via Apify pay-per-event — see each actor's Apify Store listing for its current per-event price....

Yes, you need an Apify account with an API token to use ApifyForge. ApifyForge connects directly to the Apify API to pull your actor data, run history, and revenue figures. Without a connected account...

ApifyForge manages your entire actor portfolio as a fleet, while the Apify Console manages actors one at a time. ApifyForge adds fleet-level analytics, bulk operations, quality monitoring, and 15 deve...

Apify costs $0 on the free tier, $49 per month on the Personal plan, and $499 per month on the Team plan. Each paid plan includes platform credits equal to the subscription price, covering compute tim...

Yes, Apify offers a free tier that lets you develop actors, run scraping jobs, and explore the platform without paying anything. The free plan includes $5 of monthly platform credits, 10 GB of data tr...

The Apify Store is a public marketplace where developers publish actors (pre-built automation tools) and users discover, run, and pay for them. Think of it as an app store specifically for web scrapin...

To connect your Apify account, sign in with GitHub or Google at apifyforge.com/connect, then open Settings → Apify API Token and paste a scoped API token. The whole process takes about two minutes: OA...

## What ApifyForge can access With the five scoped permissions (Actors: Read, Run, List runs; Storages: Read, Write), ApifyForge can read: - Your **actor list and metadata** — names, descriptions, p...

Yes, when you use the browser-based token flow, ApifyForge encrypts and stores your scoped Apify API token in a PostgreSQL database using AES-256-GCM with a server-held encryption key. This is a delib...

## Step-by-step **Step 1:** Open [console.apify.com/settings/integrations](https://console.apify.com/settings/integrations) in a new tab and sign in to Apify. **Step 2:** Click **Create new token**....

Disconnecting from ApifyForge depends on which connection flow you used. If you connected via the browser token flow (paste a scoped token into Settings), there is a stored token to delete. If you use...

The Revenue dashboard shows PPE earnings across your entire actor portfolio with per-actor breakdown and trend lines. It is powered by the Revenue Tracker actor ($0.40 per sync) and the Cost Watchdog ...

The Health dashboard monitors actor failure rates, success trends, and deprecation signals across your fleet. It is powered by two actors: the Health Monitor ($0.25 per check) and the Deprecation Moni...

The Quality dashboard scores your actors on the factors that affect Apify Store visibility and rank. It is powered by the Quality Monitor actor ($0.15 per actor scanned). Quality Monitor evaluates ev...

The Failures dashboard tracks which actors gained new failures since your last check. It is powered by the Failure Tracker actor ($0.10 per report). Unlike the Health dashboard which shows 30-day agg...

Bulk Operations let you update metadata, pricing, categories, or trigger builds across multiple actors in a single action. This is the fleet-management feature that makes ApifyForge essential for deve...

Alerts notify you when important events happen across your actor fleet — failures, revenue milestones, new users, cost spikes, and maintenance flags — so you know what happened without checking the da...

**TL;DR:** ApifyForge Monitor sends instant email and Slack alerts when any Apify actor run fails, times out, or is aborted — including customer-triggered PPE runs. One line of code, zero Apify credit...

The Output Guard checks your actor's actual dataset output against the schema you declared in your dataset_schema.json file, catching mismatches before they trigger maintenance flags on the Apify Stor...

The Deploy Guard is a testing tool that runs your Apify actor with predefined test inputs and automatically validates the output against assertions you define, giving you confidence that your actor wo...

Cloud Staging runs your actor in Apify's actual production environment before you make it public on the Store, catching issues that local testing cannot detect. Think of it as a staging server specifi...

Regression tests are automated test suites that run before every publish to verify that new code changes have not broken existing functionality in your Apify actors. They are your safety net against d...

Use the ApifyForge Output Guard to compare your actor's actual dataset output against the schema declared in your dataset_schema.json file. The validator runs as a hosted actor on Apify ($0.35 per val...

The Compliance Scanner assesses legal and regulatory risk for any Apify actor before you scrape. It analyzes the actor's metadata — name, description, categories, and README — to detect PII collection...

The Cost Calculator estimates what any actor will cost at various volumes before you spend credits. Enter an actor ID and get a breakdown of PPE pricing, average compute cost per run, average events p...

The Input Guard validates your input JSON against an actor's declared input schema without running the actor. It checks required fields, type constraints (string vs number vs integer), enum values, an...

The LLM Output Optimizer analyzes actor output and recommends how to reduce token consumption when feeding data to large language models. It scores every field by information density — high-value fiel...

The Pipeline Preflight validates multi-actor data pipelines and generates TypeScript orchestration code. Define pipeline stages with actor IDs and field mappings, and the builder checks that output fi...

The A/B Tester runs two actors against the same input and emits a structured winner verdict with fairness checks. It is built for the call you have to make often: "these two actors look like they solv...

The ApifyForge Release Gate is a CI/CD pre-release validation tool that runs 9 automated checks on your Apify actors before every deploy, at a cost of $0.42 per actor. It replicates the 4 exact checks...

Every tool in ApifyForge runs as an Apify actor on your account and charges a small PPE fee per use. Results are cached in your dashboard, so viewing previous reports is always free. Here is the comp...

The Personal Data Exposure Report scans 20+ data broker and people-search sites to find where your personal information is listed online. It searches sites like Spokeo, WhitePages, TruePeopleSearch, R...

When an Apify actor fails, the run terminates with a FAILED status and the platform records the error details, exit code, and run log. Understanding why actors fail — and how to diagnose failures quic...

Start with the run log in the Apify Console — it contains the error message, stack trace, and timeline of what happened during the run. Navigate to your actor, click the failed run, and read the log f...

An Apify actor enters maintenance when the platform's automated quality system detects repeated failures over a multi-day window. According to [Apify's maintenance policy](https://docs.apify.com/platf...

Actor timeouts occur when your actor exceeds its configured time limit (set in actor.json, default is 3600 seconds / 1 hour). The fix depends on whether the timeout is caused by the actor doing too mu...

Yes, Apify has a full Python SDK available on PyPI (package name: apify) that supports complete actor development, API access, dataset management, and all the same capabilities as the JavaScript SDK. ...

Earnings from Apify actors vary widely depending on your niche, pricing strategy, actor quality, and portfolio size, but individual actors solving high-value problems can earn $100 to $1,000 or more p...

Actor discoverability on the Apify Store is driven by three main factors — quality score, search relevance, and usage volume — and optimizing all three is the key to growing your user base and PPE rev...

An empty dashboard usually means your API token is invalid, expired, or was not saved correctly. The first step is to go to the ApifyForge Settings page and verify that your token is entered and saved...

HTTP 403 (Forbidden) and 429 (Too Many Requests) errors mean the target website's anti-bot system has detected your scraper and is blocking its requests. This is one of the most common issues in web s...

This is a common and frustrating situation where your actor runs successfully when you test it manually, but Apify's automated quality system still flags it with a maintenance warning. The explanation...

Report bugs by opening an issue on our GitHub repository at github.com/apifyforge/apifyforge. We use GitHub Issues as our primary bug tracking system because it allows public visibility, threaded disc...