You can access the Actor Test Runner — Validate Inputs, Outputs & Error Handling programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

$echo '{
<  "targetActorId": "ryanclinton/website-contact-scraper",
<  "testCases": [
<    {
<      "name": "Contact scraper smoke test",
<      "input": {
<        "urls": [
<          "https://example.com"
<        ]
<      },
<      "assertions": {
<        "minResults": 1,
<        "requiredFields": [
<          "email",
<          "domain"
<        ],
<        "fieldPatterns": {
<          "email": "^[^@\\\\s]+@[^@\\\\s]+\\\\.[^@\\\\s]+$"
<        },
<        "maxDuration": 120
<      }
<    }
<  ]
<}' |
<apify call ryanclinton/actor-test-runner --silent --output-dataset

Actor Test Runner API through CLI

The Apify CLI is the official tool that allows you to use Actor Test Runner — Validate Inputs, Outputs & Error Handling locally, providing convenience functions and automatic retries on errors.

Install Apify CLI

Using installation script (macOS/Linux):

$curl -fsSL https://apify.com/install-cli.sh | bash

Using installation script (Windows):

$irm https://apify.com/install-cli.ps1 | iex

Using Homebrew:

$brew install apify-cli

Using npm:

$npm install -g apify-cli

Other API clients include:

Actor Test Runner — Validate Inputs, Outputs & Error Handling API in Python

Actor Test Runner — Validate Inputs, Outputs & Error Handling API in JavaScript

Actor Test Runner — Validate Inputs, Outputs & Error Handling OpenAPI definition

Actor Test Runner — Validate Inputs, Outputs & Error Handling API

Pricing Test Actor

conversational_kermis/pricing-test-actor

the anh nguyen

Actor Staging Test — Validate Builds Before Production Deploy

ryanclinton/cloud-staging-test

Cloud Staging Test. Available on the Apify Store with pay-per-event pricing.

ryan clinton

test actor

elxin/test-actor

InvoUp

Test Actor

zdenekkuncar/test-actor

Zdenek

Test Actor

godofpotato/test-actor

This is a test actor do not use it!

Emir Yılmaz

Monitoring Runner

apify/monitoring-runner

The monitoring runner is a part of the Apify Monitoring Suite (apify/monitoring). See its readme for more information and how to use this.

Apify

139

4.5

Test100

aciku/test100

Aciku

test-actor-for-creator111412432

harukita/test-actor-for-creator111412432

Simple test actor for development.

harukita

Test

muhammetakkurtt/test

Muhammet Akkurt

Test

matej/test

Matej Hamaš

Actor Test Runner — Validate Inputs, Outputs & Error Handling

Actor Test Runner API through CLI

Install Apify CLI

You might also like

Pricing Test Actor

Actor Staging Test — Validate Builds Before Production Deploy

test actor

Test Actor

Test Actor

Monitoring Runner

Test100

test-actor-for-creator111412432

Test

Test

Actor Test Runner API through CLI

Install Apify CLI