# Password generator (`marek_honzal/password-generator`) Actor

Generates cryptographically secure random passwords with configurable length, quantity, and character sets.

- **URL**: https://apify.com/marek\_honzal/password-generator.md
- **Developed by:** [Marek Honzal](https://apify.com/marek_honzal) (community)
- **Categories:** Developer tools, Integrations, Open source
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

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

### What does Password Generator do?

**Password Generator** is an Apify Actor that produces cryptographically secure random passwords in bulk. You configure the quantity, length, and character sets — the Actor returns a clean dataset of passwords you can download or consume via API.

It uses Node.js's built-in `crypto` module (CSPRNG — Cryptographically Secure Pseudo-Random Number Generator), the same mechanism used by professional password managers. No third-party randomness libraries involved.

### Why use Password Generator?

- **Bulk generation** — generate up to 1,000 passwords in a single run
- **Secure by default** — cryptographically random, not `Math.random()`
- **API-first** — trigger via Apify API, schedule runs, or integrate into pipelines
- **Flexible output** — download results as JSON, CSV, or Excel

Common use cases:
- Seeding test environments with unique credentials
- Generating one-time tokens or temporary access codes
- Populating staging databases with realistic dummy data

### How to use Password Generator

1. Open the Actor in [Apify Console](https://console.apify.com)
2. Set your desired options in the **Input** tab (or leave defaults for a quick test)
3. Click **Start**
4. When the run finishes, open the **Output** tab to view and download your passwords

### Input

All fields are optional — defaults are applied if omitted.

| Field | Type | Default | Description |
|---|---|---|---|
| `count` | integer | `1` | Number of passwords to generate (1–1000) |
| `length` | integer | `12` | Length of each password (8–128) |
| `includeLowercase` | boolean | `true` | Include a–z (always active as fallback) |
| `includeUppercase` | boolean | `false` | Include A–Z |
| `includeNumbers` | boolean | `false` | Include 0–9 |
| `includeSymbols` | boolean | `false` | Include !@#$%^&* |

**Note:** If no character set is selected, lowercase letters are used automatically.

Example input:

```json
{
    "count": 10,
    "length": 16,
    "includeLowercase": true,
    "includeUppercase": true,
    "includeNumbers": true,
    "includeSymbols": true
}
````

### Output

Results are stored in the default dataset. Each item contains one password:

```json
[
    { "password": "aB3!xKm9#Lqz0wRt" },
    { "password": "Zp$2nYe8@Vf1cDhQ" }
]
```

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel from the **Output** tab or via the Apify API.

### Data table

| Field | Format | Description |
|---|---|---|
| `password` | string | The generated password |

### Cost estimation

Password Generator is a lightweight compute Actor — it does no networking or crawling. A run of 1,000 passwords typically completes in under a second and consumes a negligible amount of compute units.

Free tier Apify accounts receive a monthly compute unit allowance that covers thousands of runs of this Actor.

### Tips

- **Need stronger passwords?** Combine all four character sets and set length to 20+.
- **Integration tip:** Use the [Apify API](https://docs.apify.com/api/v2) to trigger runs and fetch results programmatically — useful for seeding test environments in CI/CD pipelines.
- **Scheduling:** Use Apify's built-in scheduler to generate fresh tokens on a recurring basis.

### FAQ and support

**Is this suitable for production secrets?**
The passwords are generated using a CSPRNG, which is cryptographically secure. However, treat all generated passwords as you would any sensitive credential — store them securely and never log them.

**Can I add custom symbol sets?**
Not yet — the current symbol set is `!@#$%^&*`. Open an issue if you need custom character sets.

For bugs or feature requests, use the [Issues tab](../../issues) on this Actor's page. Custom solutions and modifications are available on request.

# Actor input Schema

## `count` (type: `integer`):

How many passwords to generate.

## `length` (type: `integer`):

Number of characters in each password.

## `includeLowercase` (type: `boolean`):

Include lowercase letters (a-z). Always active — if no other set is selected, this one is used automatically.

## `includeUppercase` (type: `boolean`):

Include uppercase letters (A-Z).

## `includeNumbers` (type: `boolean`):

Include digits (0-9).

## `includeSymbols` (type: `boolean`):

Include special characters (!@#$%^&\*).

## Actor input object example

```json
{
  "count": 1,
  "length": 12,
  "includeLowercase": true,
  "includeUppercase": false,
  "includeNumbers": false,
  "includeSymbols": false
}
```

# Actor output Schema

## `passwords` (type: `string`):

No description

# 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("marek_honzal/password-generator").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("marek_honzal/password-generator").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 marek_honzal/password-generator --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=marek_honzal/password-generator",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Password generator",
        "description": "Generates cryptographically secure random passwords with configurable length, quantity, and character sets.",
        "version": "0.0",
        "x-build-id": "WaHV3Iklofnz4FN0m"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/marek_honzal~password-generator/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-marek_honzal-password-generator",
                "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/marek_honzal~password-generator/runs": {
            "post": {
                "operationId": "runs-sync-marek_honzal-password-generator",
                "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/marek_honzal~password-generator/run-sync": {
            "post": {
                "operationId": "run-sync-marek_honzal-password-generator",
                "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",
                "properties": {
                    "count": {
                        "title": "Number of passwords",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "How many passwords to generate.",
                        "default": 1
                    },
                    "length": {
                        "title": "Password length",
                        "minimum": 8,
                        "maximum": 128,
                        "type": "integer",
                        "description": "Number of characters in each password.",
                        "default": 12
                    },
                    "includeLowercase": {
                        "title": "Include a-z",
                        "type": "boolean",
                        "description": "Include lowercase letters (a-z). Always active — if no other set is selected, this one is used automatically.",
                        "default": true
                    },
                    "includeUppercase": {
                        "title": "Include A-Z",
                        "type": "boolean",
                        "description": "Include uppercase letters (A-Z).",
                        "default": false
                    },
                    "includeNumbers": {
                        "title": "Include 0-9",
                        "type": "boolean",
                        "description": "Include digits (0-9).",
                        "default": false
                    },
                    "includeSymbols": {
                        "title": "Include !@#$%^&*",
                        "type": "boolean",
                        "description": "Include special characters (!@#$%^&*).",
                        "default": false
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
