Overview
The Airtop Captcha Monitor node waits for a captcha event related to a specific Airtop session and window. It monitors the status of captchas—whether they are solved, failed, or either—and outputs the final event along with optional intermediate progress events. This node is useful in automation workflows where you need to pause execution until a captcha challenge is resolved or fails, such as automating web scraping, form submissions, or bot interactions that require human captcha solving.
Practical examples:
- Waiting for a recaptcha to be solved before continuing a data extraction workflow.
- Monitoring hcaptcha challenges during automated login processes.
- Halting a process until a manual captcha resolution is detected, then proceeding based on success or failure.
Properties
| Name | Meaning |
|---|---|
| Session ID | The Airtop session ID to monitor for captcha events. |
| Window ID | The specific window within the session to monitor for captcha events. |
| Resolve When | Condition to resolve the node: "Completed (Solved)", "Failed", or "Either (Completed or Failed)". |
| Timeout (Seconds) | Maximum time (in seconds) the node will wait for a terminal captcha event before timing out. |
| Lookback Seconds | If greater than 0, the node requests backlog events and accepts captcha events whose eventTime is within this window (seconds). |
| Request Timeout (ms) | Optional network timeout in milliseconds for API requests; 0 means use default timeout. |
| Return Progress Events | Whether to include intermediate captcha events (progress updates) in the output. |
| Fail Node on "failed" | Whether the node should fail if the captcha status is "failed". |
| Optional Filters | Additional filters to narrow down captcha events: - Job ID: filter by job identifier. - Captcha Type: filter by captcha type (e.g., recaptcha_v2, hcaptcha). |
Output
The node outputs JSON objects containing information about the monitored captcha event(s):
sessionId: The monitored Airtop session ID.windowId: The monitored window ID within the session.finalStatus: The final status of the captcha event (completed,failed, etc.).finalEvent: The full final captcha event object including fields like:event(always"captcha-event"),id(event ID),duration,eventTime,retryCount,status,type(captcha type),url,windowId.
lookbackSeconds: The lookback window used for accepting past events.requestTimeoutMs: The request timeout used (if any).progress: An array of intermediate captcha events received if "Return Progress Events" is enabled.progressCount: Number of intermediate progress events included.
This output allows downstream nodes to react to the captcha resolution status and details.
Dependencies
- Requires an API key credential for Airtop's API service.
- Uses Airtop's official SDK or API client to fetch session events.
- Network access to Airtop API endpoint (default:
https://api.airtop.ai). - Optional configuration of request timeout via node property.
Troubleshooting
- Timeout Errors: If the node times out waiting for a captcha event, increase the "Timeout (Seconds)" property or verify that the session/window IDs are correct and active.
- No Events Received: Ensure the session and window IDs correspond to active captcha challenges. Check optional filters to avoid filtering out relevant events unintentionally.
- Node Fails on Captcha Failure: If "Fail Node on 'failed'" is enabled, the node will throw an error when a captcha fails. Disable this option if you want to handle failures gracefully downstream.
- Network Issues: If API requests fail due to network problems or invalid credentials, verify the API key and network connectivity.
- Invalid Event Time: If lookback is enabled but event times are missing or malformed, the node defaults to accepting those events.
Links and References
If you need further assistance configuring this node or interpreting its output, consult the Airtop API documentation or reach out to Airtop support.