> For the complete documentation index, see [llms.txt](https://docs.cloudfilt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudfilt.com/integrations/api-json.md).

# API JSON

## What is cloudFilt API ?

The **CloudFilt API (Application Programming Interface)** allows you to directly connect your **custom applications, systems, or infrastructure** with CloudFilt’s **advanced bot detection and threat prevention engine**.

It provides developers with a **flexible and secure way** to integrate CloudFilt protection into any environment, beyond traditional CMS or plugins.

## Why use cloudFilt API ?

Integrating the CloudFilt API helps developers and businesses :

* **Detect and block** bad bots, scrapers, DDoS threats, and fraudulent activity across any platform.
* **Query real-time user scores, risk levels, and IP behaviors** before serving content or granting access.
* **Automate** incident response, custom security rules, and traffic control workflows.
* **Maintain clean logs, reliable KPIs, and secure performance** even at enterprise scale.

## How to activate and use cloudFilt API

1. Login to your **CloudFilt account**.
2. Go to **Websites / WebApps > My Websites**.
3. Click **Settings > Integration & Plugins**.
4. Select the **“API” tab**.
5. A **private key** will be generated for your account.
6. Use the **private key** along with the **IP or data you want to check** in your API requests.

> Example: Send a request to the **CloudFilt API endpoint** with your **private key** and the **IP address** you want to validate.\
> The API will respond with the **risk score, behavior analysis, and action recommendation** in real time.
