# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cloudfilt.com/integrations/api-json.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.