Website Checker Runner Cheerio

Overview

This is a low-level Apify actor that checks a website by fetching its HTML and parsing it with Cheerio. It's designed to run a single check based on provided configuration. For most use cases, especially orchestrated monitoring, you should use the higher-level master actor: https://apify.com/lukaskrivka/website-checker.?fpr=python_automation

Key Features

• Cheerio-based Parsing: Uses Cheerio (a fast, jQuery-like library) to analyze and extract data from HTML.
• Single-Check Execution: Runs one defined check per actor execution.
• Configurable Checks: Define what to look for on the page (selectors, text, attributes) and set pass/fail conditions.
• Developer-Focused: Provides raw access for custom check logic and integration into larger workflows.

How to Use

Run the actor on the Apify platform, providing input configuration via the UI, API, or SDK. The actor will fetch the target URL, load the HTML into Cheerio, execute your defined check, and return the result.

Basic Input Example

{
  "url": "https://example.com",
  "check": {
    "name": "Title Check",
    "type": "text",
    "selector": "title",
    "condition": "contains",
    "value": "Example Domain"
  }
}

Input/Output

Input

The actor expects an input object with the following properties:

• url (String, Required): The target website URL to check.
• check (Object, Required): The check configuration.
  • name: A descriptive name for the check.
  • type: The type of check (e.g., text, attribute, element).
  • selector: The CSS selector to target elements on the page.
  • condition: The condition to evaluate (e.g., equals, contains, exists).
  • value: The expected value to compare against (not required for exists condition).
• proxyConfiguration (Object, Optional): Apify proxy configuration if needed.

Output

The actor's dataset contains a single record with the check result. The output includes:

• url: The checked URL.
• check: The name of the performed check.
• passed: Boolean indicating if the check succeeded.
• result: The actual value found during the check.
• timestamp: When the check was executed.
• error: Populated with an error message if the request or check failed.

Use this actor as a building block. For scheduled monitoring with multiple checks and alerts, use the master actor: https://apify.com/lukaskrivka/website-checker.?fpr=python_automation