Profanity Filter

Detect and censor profanity in text. Returns a censored copy of the input and the list of flagged words found.

Get API Key

Overview

Use Cases

User-generated content moderation
Chat and comment filtering
Forum and community platforms
Child-safe application layers

Features

Case-insensitive detection

Censors flagged words with asterisks

Returns deduplicated list of flagged words

Preserves surrounding punctuation and whitespace

API Endpoints

Check Profanity

Checks text for profanity, returning a censored version and the list of flagged words.

POST

https://api.requiems.xyz/v1/text/profanity

Parameters

Name	Type	Required	Description
text	`string`	Required	The text to check for profanity.

Try it out

Live Demo

Request

text * (string)

The text to check for profanity.

Response Fields

Field	Type	Description
has_profanity	`boolean`	Whether any profanity was detected in the text
censored	`string`	The input text with profane words replaced by asterisks
flagged_words	`array of strings`	Deduplicated list of profane words found (lowercase)

Code Examples

curl -X POST https://api.requiems.xyz/v1/text/profanity \
  -H "requiems-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Some text to check"}'

import requests

url = "https://api.requiems.xyz/v1/text/profanity"
headers = {
    "requiems-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {"text": "Some text to check"}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const response = await fetch('https://api.requiems.xyz/v1/text/profanity', {
  method: 'POST',
  headers: {
    'requiems-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ text: 'Some text to check' })
});

const data = await response.json();
console.log(data.data.has_profanity);
console.log(data.data.censored);

require 'net/http'
require 'json'

uri = URI('https://api.requiems.xyz/v1/text/profanity')
request = Net::HTTP::Post.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = { text: 'Some text to check' }.to_json

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)
puts data['data']['has_profanity']
puts data['data']['censored']

Error Responses

validation_failed

The text field is missing or empty.

bad_request

The request body is missing or malformed.

internal_error

Unexpected server error.

No results found