# Slug Generator (`nrithm/slug-generator`) Actor Professional-grade slug generation with international support and greedy word truncation. Create clean slugs each each time. It can process a high volume of (up to 10M) input titles seamlessly. Check README.md for all the details 🀘🏻 - **URL**: https://apify.com/nrithm/slug-generator.md - **Developed by:** [Noopur A](https://apify.com/nrithm) (community) - **Categories:** SEO tools, E-commerce, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 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 πŸ‘€ INDEX for quick reference: ⭐ Slug Generator - Complete README ⭐ πŸ“‘ Table of Contents 1. What is a Slug? 2. What It Does? 3. Quick Start 4. Examples 5. What It Does (Features)? 6. What It Doesn't Do? 7. Greedy Truncation (Word-Aware) - 8. Input Formats 9. Valid Input Examples - 10. Configuration Options 11. How Much Input Can It Process? 12. Performance & Limits 13. Output 14. Error Messages & Fixes 15. Use Cases 16. Why Do You Need It? 17. How Does This Save You Time? 18. Does It Always Work? 19. API Integration ------------------------------------------------------------------------------------------ What is a Slug? πŸ€” Good question! A slug is a URL-friendly version of a title. Here are some examples: summer-cool-shirts-to-rock https://www.example.com/this-is-a-slug this_slug_has_underscore_for_word_separator you.can.also.use.period.as.a.separator These are what you find in the URL bar or when you inspect the code of a website. With this Slug Generator Actor, you can batch-create them instantly! ------------------------ What It Does? 🧐 Generate clean, URL-friendly slugs from titles in bulk. Handles international characters (German, French, Italian, Slavic, Nordic), preserves word boundaries, and ensures every slug is unique. ------------------------ ❕Quick Start > Paste titles (one per line) > Choose format (plain text, CSV, JSON, TSV) > Set output character limit (default: 60) > Run ------------------------------------------------------------------------------------------ Examples - > Basic Transformation - Input: My Awesome Blog Post! Output: my-awesome-blog-post > International Characters - Input: MΓΌnchen Coffee Shop Output: munchen-coffee-shop (accents removed) > Symbol & Special Character Removal - Input: Mod#eRn tech$niQues to faRmin*g Output: modern-techniques-to-farming > Numbers & Extra Spaces - Input: Mod#3eRn tech$ni9Ques to faRmin1*g Output: mod-3-ern-techni-9-ques-to-farmin-1-g ⚠️ Note: Typos are not fixed. Numbers and typos in your input stay as-is. ------------------------------------------------------------------------------------------ > What It Does (Features)? Accepts only valid input in the form of a "string" Accepts multiple formats: Plain text, JSON, CSV, TSV Accepts URL Share the URL to your input data stored on your cloud storage Make sure the input data shared via URL is accessible Check URL sharing permissions in your cloud storage settings Removes symbols and special characters Handles international characters (German ΓΌβ†’ue, French Γ©β†’e, etc.) Preserves word boundaries (doesn't merge words) Ensures uniqueness (no duplicate slugs) - example - sample slug (multiple duplicate input ) gets a suffix at the end of the slug - sample-slug-1, sample-slug-2, sample-slug-3 . . . Greedy truncation (completes words, doesn't cut them off) Real-time progress tracking (see processing status) Self-testing (verifies everything is working before processing) ------------------------------------------------------------------------------------------ ⚠️ What It Doesn't Do? Does not fix typos (typos in input stay as typos in output) Does not generate SEO-optimized titles (generates slugs, not titles) Does not automatically fix bad/toxic input (invalid input is rejected) ------------------------------------------------------------------------------------------ Greedy Truncation (Word-Aware) - Input: `Latest and greatest sneakers and shoes collection` **Example 1 - Limit: 20 characters** - ❌ Bad (cuts word): `latest-and-greatest-s` - βœ… Good (completes word): `latest-and-greatest-sneakers` The slug generator doesn't cut words in half. If the limit is 20 characters but completing the next word extends to 28, it includes the full word for readability. **Example 2 - Default limit: 60 characters** - Output: `latest-and-greatest-sneakers-and-shoes-collection` No broken words, clean output, always readable. ------------------------ Why This Works Better? Limit: 5 Output: latest Length: 6 Status: βœ… Completes word Limit: 20 Output: latest-and-greatest-sneakers Length: 28 Status: βœ… Completes word Limit: Default 60 Output: latest-and-greatest-sneakers-and-shoes-collection Length: 50 Status: βœ… Completes word ------------------------------------------------------------------------------------------ ⚠️ Input Formats - Plain Text: One title per line CSV: Comma-separated values TSV: Tab-separated values JSON: Array of strings ------------------------------------------------------------------------------------------ Valid Input Examples - Plain text in Apify UI: My First Blog Post Latest Product Name Summer Collection 2026 Product Four Product Five ------------------------ JSON (newline-separated): json { "titles": "My First Blog Post\nLatest Product Name\nSummer Collection 2026" } ------------------------ JSON (array): json { "titles": ["Product 1", "Product 2", "Product 3"], "format": "json", "separator": "_", "limit": 80 } ------------------------ CSV: json { "titles": "product1,product2,product3", "format": "csv", "separator": "-", "limit": 60 } ------------------------------------------------------------------------------------------ Configuration Options - > Separator: Choose -, _, or . (default: -) - β†’ hyphen/dash (most common for SEO) _ β†’ underscore . β†’ period/dot Truncation Limit: 1 - 1000 characters (default: 60) The slug generator will complete the active word and not cut it abruptly Format: Specify input format (text, CSV, JSON, TSV) ------------------------------------------------------------------------------------------ How Much Input Can It Process? It's up to you. Whether you have 10 titles, 100, 1,000, 10K, or 100K+ lines β€” all of it gets processed fast and smooth. ------------------------------------------------------------------------------------------ πŸ’  Performance & Limits - > Processing Speed 100 titles: ~20ms 1,000 titles: ~200ms 10,000 titles: ~2 seconds 100,000 titles: ~20 seconds > Maximum Input Max 1,000 characters per individual title Theoretical max: 10M+ titles (takes ~30 minutes to process) > Memory Usage Optimized for low RAM consumption Batch clean up prevents memory spikes Processes efficiently even with large datasets > Scalability This actor is built to scale. Whether you have 10 titles or 10 million, it processes deterministically and reliably. ------------------------------------------------------------------------------------------ Output - Dataset with two columns: original: Your input title slug: Generated slug ------------------------------------------------------------------------------------------ ⚠️ Error Messages & Fixes - Invalid Inputs (Rejected -> Actor Stops) Input: null Status: ❌ Rejected Error: INPUT_FAILURE Input: {} Status: ❌ Rejected Error: Missing 'titles' field Input: {titles: 123} Status: ❌ Rejected Error: Must be String or Array Input: {titles: ""} Status: ❌ Rejected Error: Empty string Input: {titles: []} Status: ❌ Rejected Error: Empty array Input: {titles: " "} Status: ❌ Rejected Error: Whitespace only ------------------------------------------------------------------------------------------ ⚠️ Invalid Per-Row Inputs (Accepted but Skipped) Input: {titles: "!!!"} Status: βœ… Accepted (skipped) Reason: Empty after transformation Input: {titles: "###"} Status: βœ… Accepted (skipped) Reason: Empty after transformation Input: {titles: " "} Status: βœ… Accepted (skipped) Reason: Empty after trimming Input: {titles: "\n\n\n"} Status: βœ… Accepted (skipped) Reason: Empty after processing Input: {titles: "My Blog"} Status: βœ… Accepted Reason: Processes normally Input: {titles: ["Title1", "Title2"]} Status: βœ… Accepted Reason: Processes normally ------------------------------------------------------------------------------------------ ⚠️ To Fix Invalid Input? Make sure your input doesn't fall under any of these types: ❌ null or undefined ❌ Number: 123 ❌ Boolean: true ❌ Object without titles field: {} ❌ titles is a number: {titles: 123} ❌ titles is an object: {titles: {}} ❌ Empty string: {titles: ""} ❌ Empty array: {titles: []} ❌ Whitespace only: {titles: " "} ------------------------------------------------------------------------------------------ Use Cases? E-commerce product URLs Blog post permalinks Content management systems API integrations ------------------------------------------------------------------------------------------ Why Do You Need It? Are you planning on creating slugs manually? 🀨 Or do you know the sorcery of Excel formulas or a Python script to do batch conversion? Ask yourself: Will it remove symbols and special characters? Will it provide clean slug output every time? What about German, French, Italian, Slavic, Nordic character conversions to plain English alphabets? 😈 This tool does all of that automatically. ------------------------------------------------------------------------------------------ How Does This Save You Time? If an input is not processed, will I be informed - What went wrong? How to fix it? How many inputs were processed? How many were left out or turned into ugly slugs? βœ… Yes to all of the above. Do you like those strings of alphanumeric and symbols clogging up your titles in the URL? this#%^-is&%_not%@&)_what+587@%will*#!help24$&_you%@ That slug is a nightmare to even read. This tool fixes that. ------------------------------------------------------------------------------------------ Does It Always Work? Yes. Always. How? Because it's designed to handle most commonly occurring edge cases. You won't lose money on any invalid input, system crash, or unforeseen errors. Before the slug generator engine runs, it does a self-test to check everything is running in order. ------------------------------------------------------------------------------------------ > πŸ”— API Integration - This actor can be integrated into your applications via Apify's REST API. ------------------------ Example: JavaScript const response = await fetch('https://api.apify.com/v2/acts/{actor-id}/runs', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ titles: "Product 1\nProduct 2\nProduct 3", format: "text", separator: "-", limit: 60 }) }); const result = await response.json(); console.log(result.data.output); ------------------------ Example: Python import requests response = requests.post( 'https://api.apify.com/v2/acts/{actor-id}/runs', json={ "titles": "Product 1\nProduct 2\nProduct 3", "format": "text", "separator": "-", "limit": 60 }, headers={'Authorization': 'Bearer YOUR_API_TOKEN'} ) slugs = response.json()['data'] ['output'] ------------------------ Getting Your API Token - Go to Apify console Settings β†’ Integrations β†’ API tokens Copy your token Use in Authorization header ------------------------------------------------------------------------------------------ End of README πŸ‘‹πŸ» ------------------------------------------------------------------------------------------ # Actor input Schema ## `titles` (type: `string`): Paste your text or JSON array here. ## `titlesUrl` (type: `string`): Provide URLs that are publicly accessible and reachable (http/https only) for your datasets. ## `inputFormat` (type: `string`): Select the format of your input data. ## `separator` (type: `string`): The character used to separate words in the slug. ## `limit` (type: `integer`): The slug generator will complete the word active at this character count. ## `dryRun` (type: `boolean`): Inspect input without generating slugs. Shows errors and stats only. ## Actor input object example ```json { "titles": "Enter your titles here, one per line. For example:\nMy First Blog Post\nLatest Product Name\nSummer Collection 2026", "inputFormat": "text", "separator": "-", "limit": 60, "dryRun": false } ```` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "titles": `Enter your titles here, one per line. For example: My First Blog Post Latest Product Name Summer Collection 2026` }; // Run the Actor and wait for it to finish const run = await client.actor("nrithm/slug-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "titles": """Enter your titles here, one per line. For example: My First Blog Post Latest Product Name Summer Collection 2026""" } # Run the Actor and wait for it to finish run = client.actor("nrithm/slug-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 '{ "titles": "Enter your titles here, one per line. For example:\\nMy First Blog Post\\nLatest Product Name\\nSummer Collection 2026" }' | apify call nrithm/slug-generator --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nrithm/slug-generator", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Slug Generator", "description": "Professional-grade slug generation with international support and greedy word truncation.\n\nCreate clean slugs each each time. \n\nIt can process a high volume of (up to 10M) input titles seamlessly.\n\nCheck README.md for all the details 🀘🏻", "version": "0.0", "x-build-id": "48wmTpW72Tlvq4ytJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nrithm~slug-generator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nrithm-slug-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/nrithm~slug-generator/runs": { "post": { "operationId": "runs-sync-nrithm-slug-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/nrithm~slug-generator/run-sync": { "post": { "operationId": "run-sync-nrithm-slug-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", "required": [ "titles" ], "properties": { "titles": { "title": "Titles (Direct Input)", "type": "string", "description": "Paste your text or JSON array here." }, "titlesUrl": { "title": "Titles to extract from accessible URLs", "type": "string", "description": "Provide URLs that are publicly accessible and reachable (http/https only) for your datasets." }, "inputFormat": { "title": "Input Format", "enum": [ "json", "csv", "tsv", "text" ], "type": "string", "description": "Select the format of your input data.", "default": "text" }, "separator": { "title": "Slug Separator", "enum": [ "-", "_", "." ], "type": "string", "description": "The character used to separate words in the slug.", "default": "-" }, "limit": { "title": "Truncation Threshold", "minimum": 1, "maximum": 1000, "type": "integer", "description": "The slug generator will complete the word active at this character count.", "default": 60 }, "dryRun": { "title": "Dry Run Mode", "type": "boolean", "description": "Inspect input without generating slugs. Shows errors and stats only.", "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 } } } } } } } } } } ```