# Credential Breach Checker (`clearcheck.io/credential-breach-checker`) Actor

Check emails, phones, passwords, names, and social IDs against breach and leak intelligence sources. Useful for security reviews, fraud prevention, KYC support, and investigative workflows. Results are decision-support signals.

- **URL**: https://apify.com/clearcheck.io/credential-breach-checker.md
- **Developed by:** [Clearcheck Labs](https://apify.com/clearcheck.io) (community)
- **Categories:** Developer tools, Automation, Integrations
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $400.00 / 1,000 successful breachscan results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Credential Breach Checker

Check emails, phone numbers, passwords, names, and social IDs against breach and leak intelligence sources.

Designed for security reviews, fraud prevention, KYC support, account-risk analysis, and investigative workflows.

---

### What it does

This Actor submits identifiers to a breach and leak intelligence backend, waits for results asynchronously, and returns structured findings — including matched sources and exposed records when available.

The Actor processes one lookup type per run and supports up to 25 values per run.

---

### Supported lookup types

| `lookupType` value | What to submit |
|---|---|
| `email` | Email address |
| `phone` | Phone number (E.164) |
| `password` | Password string |
| `fullname` | Full name |
| `facebookid` | Facebook user ID |
| `telegramid` | Telegram user ID |
| `linkedinid` | LinkedIn user ID |
| `vkid` | VK user ID |
| `twitterid` | Twitter/X user ID |
| `instagramid` | Instagram user ID |

---

### Input

The Actor accepts two required fields.

#### `lookupType` (required)

Type of identifier to scan. Select one from the dropdown.

Default: `email`

#### `values` (required)

List of one or more identifiers to scan. All values in a single run must be of the same lookup type.

Maximum: 25 values per run.

#### Example input (JSON)

```json
{
  "lookupType": "email",
  "values": [
    "user@example.com",
    "another@example.com"
  ]
}
````

```json
{
  "lookupType": "phone",
  "values": [
    "+14155552671"
  ]
}
```

```json
{
  "lookupType": "fullname",
  "values": [
    "John Smith"
  ]
}
```

***

### Output

Each submitted value produces one output record in the dataset.

#### Successful result

```json
{
  "input": "user@example.com",
  "lookupType": "email",
  "status": "success",
  "irbisResponseId": "1492",
  "pollAttempts": 3,
  "result": {
    "criteria": "user@example.com",
    "type": "deepweb",
    "status": "finished",
    "sources": [
      { "name": "source_name" }
    ],
    "data": [
      {
        "source_name": [
          {
            "emailAddress": "user@example.com",
            "firstName": "...",
            "lastName": "...",
            "phoneNumber": "..."
          }
        ]
      }
    ]
  }
}
```

#### No data found

The result field will contain `status: "finished"` (or equivalent) with an empty `data` array or no `data` field. A `status: "success"` at the outer level means the lookup completed — not that matches were found.

#### Timeout

If the backend does not return a final result within the configured polling window (default: ~3 minutes), the record is returned with `status: "timeout"` and the last intermediate response.

```json
{
  "input": "user@example.com",
  "lookupType": "email",
  "status": "timeout",
  "irbisResponseId": "1492",
  "pollAttempts": 18,
  "message": "IRBIS result was not ready before timeout.",
  "lastResult": { ... }
}
```

#### Error

```json
{
  "input": "user@example.com",
  "lookupType": "email",
  "status": "error",
  "error": "description of error"
}
```

#### Output field reference

| Field | Description |
|---|---|
| `input` | The value that was submitted |
| `lookupType` | Lookup type used |
| `status` | `success`, `timeout`, `error`, or `http_error` |
| `irbisResponseId` | Internal response ID returned by the backend |
| `pollAttempts` | Number of polling attempts before a final result was received |
| `result` | Final result object from the backend (present on `success`) |
| `result.criteria` | The submitted search value as echoed by the backend |
| `result.type` | Lookup type as confirmed by the backend |
| `result.status` | Backend-level status (e.g., `finished`) |
| `result.sources` | List of sources that were searched |
| `result.data` | Array of matched records per source |

Result fields may vary by lookup type and available intelligence. Not all records will contain all fields.

***

### How the Actor works (technical flow)

1. Validates input (`lookupType` and `values`).
2. For each value, submits a POST request to the breach intelligence endpoint.
3. The backend returns an initial response with a `status: "progress"` and a response ID.
4. The Actor polls the result endpoint every 10 seconds (by default) until the result is final or the timeout is reached.
5. Final results are pushed to the Apify dataset.
6. A paid event (`breach_scan`) is charged per successfully completed result.

***

### Pricing

This Actor uses **pay-per-event** pricing.

**$0.40 per successful BreachScan result.**

You are charged only when a lookup completes successfully. Timeouts and errors are not charged. If your configured maximum cost per run is reached mid-run, the Actor stops before charging the next result.

To control costs, set a **Maximum cost per run** limit in Run options before starting.

***

### Rate limiting and run size

- Maximum 25 values per run (configurable by the Actor operator).
- The backend enforces a ~30-second processing window per lookup. The Actor polls for results and waits accordingly.
- If results are not returned within the polling window (~3 minutes by default), the Actor records a timeout for that value.

For large batches, split values across multiple runs.

***

### Usage note

Results are decision-support signals only. This Actor is designed for responsible business use in security, fraud prevention, KYC support, and investigative workflows.

Users are responsible for ensuring they have a lawful basis to process and analyze the submitted data in their jurisdiction. Results should not be used as the sole basis for adverse action against any individual.

This Actor does not produce FCRA-compliant consumer reports and is not suitable for employment screening, tenant screening, or credit decisions.

***

### Publisher

**Clearcheck Labs** — digital intelligence tools for breach intelligence, identity enrichment, fraud prevention, and investigative workflows.

<https://apify.com/clearcheck.io>

# Actor input Schema

## `lookupType` (type: `string`):

Type of value to scan in breach/leak data.

## `values` (type: `array`):

Emails, phones, passwords, names, or social IDs to scan.

## Actor input object example

```json
{
  "lookupType": "email"
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("clearcheck.io/credential-breach-checker").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("clearcheck.io/credential-breach-checker").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call clearcheck.io/credential-breach-checker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=clearcheck.io/credential-breach-checker",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Credential Breach Checker",
        "description": "Check emails, phones, passwords, names, and social IDs against breach and leak intelligence sources. Useful for security reviews, fraud prevention, KYC support, and investigative workflows. Results are decision-support signals.",
        "version": "0.0",
        "x-build-id": "jgDoa00DxM5wE2u8N"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/clearcheck.io~credential-breach-checker/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-clearcheck.io-credential-breach-checker",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/clearcheck.io~credential-breach-checker/runs": {
            "post": {
                "operationId": "runs-sync-clearcheck.io-credential-breach-checker",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/clearcheck.io~credential-breach-checker/run-sync": {
            "post": {
                "operationId": "run-sync-clearcheck.io-credential-breach-checker",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "lookupType",
                    "values"
                ],
                "properties": {
                    "lookupType": {
                        "title": "Lookup type",
                        "enum": [
                            "password",
                            "fullname",
                            "facebookid",
                            "telegramid",
                            "linkedinid",
                            "vkid",
                            "twitterid",
                            "instagramid",
                            "email",
                            "phone"
                        ],
                        "type": "string",
                        "description": "Type of value to scan in breach/leak data.",
                        "default": "email"
                    },
                    "values": {
                        "title": "Values to scan",
                        "type": "array",
                        "description": "Emails, phones, passwords, names, or social IDs to scan.",
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```