# Kadoa

Kadoa is an API-first platform that enables users to create, manage, and monitor data extraction workflows from unstructured data sources.

- **Category:** ai web scraping
- **Auth:** API_KEY
- **Tools:** 27
- **Triggers:** 0
- **Slug:** `KADOA`
- **Version:** 20260211_00

## Tools

### Create Notification Channel

**Slug:** `KADOA_CREATE_NOTIFICATION_CHANNEL`

Tool to create a notification channel for alerts delivery.

### Enable Data Validation

**Slug:** `KADOA_ENABLE_DATA_VALIDATION`

Tool to enable data validation on a specified workflow. Use after creating or updating a workflow to enforce its validation rules.

### Get Workflow by ID

**Slug:** `KADOA_FETCH_WORKFLOW_CONFIGURATION`

Retrieve detailed configuration of a workflow by its ID. Returns workflow metadata, extraction schema, scheduling settings, data validation config, and run status. Use this to inspect a workflow's setup or check its current state.

### Get all locations

**Slug:** `KADOA_GET_ALL_LOCATIONS`

Retrieves all available scraping proxy locations (countries) supported by Kadoa. Returns ISO country codes (e.g., US, GB, DE) that can be used when configuring workflows to scrape from specific geographic regions. Use this to see which locations are available before creating location-specific scraping workflows.

### Get Crawled Page Content

**Slug:** `KADOA_GET_CRAWLED_PAGE_CONTENT`

Tool to retrieve content of a crawled page. Use when you need the HTML or Markdown of a page from a specific crawling session.

### Get Crawled Pages

**Slug:** `KADOA_GET_CRAWLED_PAGES`

Tool to list pages crawled during a session. Use when you need to paginate through results after starting a crawl session.

### Get Crawl Status

**Slug:** `KADOA_GET_CRAWL_STATUS`

Tool to fetch current status of a crawling session. Use when you need to check progress of a crawl by its session ID.

### Get Notification Event Types

**Slug:** `KADOA_GET_EVENT_TYPES`

Tool to retrieve supported notification event types. Use when you need to enumerate available notification triggers.

### Get Latest Workflow Data

**Slug:** `KADOA_GET_LATEST_WORKFLOW_DATA`

Retrieves the extracted data from a Kadoa workflow's most recent run (or a specific run if runId is provided). Returns paginated records in JSON or CSV format. Use Get Workflows action first to obtain a valid workflowId.

### Get Notification Channel

**Slug:** `KADOA_GET_NOTIFICATION_CHANNEL`

Tool to retrieve details of a specific notification channel. Use when you have a channel's ID and need its configuration.

### Get Notification Setting

**Slug:** `KADOA_GET_NOTIFICATION_SETTING`

Retrieves a specific notification setting by its unique identifier. Use this tool to fetch details about how notifications are configured for specific events and which channels are linked. Returns the event type, enabled status, linked channels, and timestamps.

### Get Validation Configuration

**Slug:** `KADOA_GET_VALIDATION_CONFIG`

Tool to retrieve the data validation configuration for a specific workflow. Use this to check validation status, alerting thresholds, and rule counts before modifying validation settings.

### Get Workflow Run History

**Slug:** `KADOA_GET_WORKFLOW_RUN_HISTORY`

Tool to fetch workflow run history. Use when you need to retrieve past run records for a workflow after execution.

### Get Workflows

**Slug:** `KADOA_GET_WORKFLOWS`

Retrieve a paginated list of workflows with optional filtering. Use this tool to list all workflows in your Kadoa account. You can filter by: - search: Find workflows by name, URL, or ID - state: Filter by workflow state (ACTIVE, PAUSED, ERROR, etc.) - monitoring: Filter by whether monitoring is enabled Returns workflow details including name, state, URLs, schema, and run statistics.

### Get Workflow Validation Results

**Slug:** `KADOA_GET_WORKFLOW_VALIDATION_RESULTS`

Retrieves the latest validation results for a specific workflow job. Returns validation details including anomalies detected, rules executed, and schema issues. Returns has_results=false if no validation results exist for the specified job.

### List Validation Rules

**Slug:** `KADOA_LIST_VALIDATION_RULES`

Tool to list all data validation rules with optional pagination and filtering.

### Create Advanced Workflow

**Slug:** `KADOA_POST_ADVANCED_WORKFLOW`

Tool to create an advanced workflow. Use when you need a valid advanced workflow ID before updating steps.

### Start Crawl Session

**Slug:** `KADOA_POST_CRAWL`

Starts a new web crawling session to crawl and index pages from a website. Use this tool when you need to: - Crawl an entire website or specific sections - Gather page content for extraction or analysis - Index multiple pages from a domain Returns a session_id that can be used with get_crawl_status to monitor progress and get_crawled_pages to retrieve the crawled content.

### Create Notification Setting

**Slug:** `KADOA_POST_NOTIFICATION_SETTING`

Tool to create a notification setting linking channels to events. Use when subscribing workflows or workspace-level notifications to specific events.

### Send Test Notification

**Slug:** `KADOA_POST_NOTIFICATION_TEST`

Sends a test notification event to verify notification channel configurations are working correctly. Use this tool to test that your notification channels (email, Slack, Teams, webhooks, etc.) are properly configured before relying on them for production workflows. The test sends a simulated event of the specified type, which will be delivered to all configured notification channels for that event type.

### Subscribe to Webhook Events

**Slug:** `KADOA_POST_WEBHOOK_SUBSCRIPTION`

Tool to subscribe to specified webhook events. This will create a webhook channel and then create notification settings for the provided events linking that channel.

### Create Workflow

**Slug:** `KADOA_POST_WORKFLOW`

Create a new Kadoa web scraping workflow. This tool creates a workflow that can extract structured data from web pages. Provide URLs to scrape, specify a navigation mode, and define the data schema. For structured extraction: Use 'single-page' mode with entity + fields. For paginated content: Use 'paginated-page' mode. For AI-driven navigation: Use 'agentic-navigation' mode with userPrompt (Enterprise only). Note: Workflow creation may take 60+ seconds as Kadoa analyzes the target URLs.

### Configure Workflow Monitoring

**Slug:** `KADOA_POST_WORKFLOW_MONITORING`

Configure monitoring and scheduling for a Kadoa workflow to detect data changes. This tool allows you to: - Set up recurring workflow runs at specified intervals (daily, hourly, weekly, etc.) - Enable monitoring to detect when specific fields change (e.g., price changes, stock updates) - Configure conditions to filter which changes trigger notifications Use this after creating a workflow or to update an existing workflow's monitoring settings. The workflow must exist before you can configure its monitoring.

### Generate Workflow Validation Rule

**Slug:** `KADOA_POST_WORKFLOW_VALIDATION_RULE`

Generate an AI-powered data validation rule for a Kadoa workflow. This tool uses AI to convert a natural-language description into a SQL-based validation rule that can detect data quality issues in workflow outputs. Prerequisites: - The workflow must have completed at least one successful job run - The workflow must have data validation enabled The generated rule will be created in 'preview' status for testing before activation. Use the List Validation Rules action to view created rules, and the Bulk Approve Validation Rules action to activate them.

### Update Notification Channel

**Slug:** `KADOA_PUT_NOTIFICATION_CHANNEL`

Tool to update an existing notification channel. Use when you need to modify channel details.

### Run Ad-hoc Extraction

**Slug:** `KADOA_RUN_ADHOC_EXTRACTION`

Tool to synchronously extract data from a URL using a given template. Use after choosing the schemaId (custom or 'html', 'body', 'markdown').

### Unsubscribe from Webhook Events

**Slug:** `KADOA_UNSUBSCRIBE_FROM_WEBHOOK_EVENTS`

Unsubscribe from webhook event notifications by deleting a notification setting. Use this tool when you need to: - Remove an existing notification subscription by its settings ID - Stop receiving webhook notifications for specific events - Clean up notification configurations The settings ID can be obtained from the response of the Subscribe to Webhook Events action or from listing notification settings.
