API Basics
Data Tools
Browser Bot
HTML Clean
URL Info
Security and Networking
Legacy APIs

Bad Word Filter

Detect bad words, swear words and profanity in a given text.

Currently works with a mostly English database which includes "leetspeak". The filter uses natural language processing (NLP) to decode the content into logical words ignoring punctuation, case, formatting, etc. We also apply word transformations to detect obfuscation of bad words like repeating characters, spurious whitespace and special characters. As well as detection and extraction of bad words you can also use this API to censor bad words from the supplied text.

End Point

Test API
API Request
contentyesstringThe content to scan. This can be either a URL to load from, a file upload (multipart/form-data) or an HTML content string
censor-characternostringThe character to use to censor out the bad words found
catalognostringstrictWhich catalog of bad words to use, we currently maintain two bad word catalogs:
  • strict - the largest database of bad words which includes profanity, obscenity, sexual, rude, cuss, dirty, swear and objectionable words and phrases. This catalog is suitable for environments of all ages including educational or children's content
  • obscene - like the strict catalog but does not include any mild profanities, idiomatic phrases or words which are considered formal terminology. This catalog is suitable for adult environments where certain types of bad words are considered OK
API Response
is-badbooleanDoes the text contain bad words
bad-words-totalintegerTotal number of bad words detected
bad-words-listarrayAn array of the bad words found
censored-contentstringThe censored content (only set if censor-character has been set)
API Performance
Avg Latency15msAverage RTT for requests within the same data center/region
Max Rate200/secondMaximum inbound request rate. Exceeding this will result in request throttling
Max Concurrency250Maximum concurrent/simultaneous requests. Exceeding this will result in error code 06 [TOO MANY CONNECTIONS]

API Example
curl https://neutrinoapi.net/bad-word-filter \ --header "User-ID: <your-user-id>" \ --header "API-Key: <your-api-key>" \ --data-urlencode "censor-character=" \ --data-urlencode "catalog=strict" \ --data-urlencode "content=https://en.wikipedia.org/wiki/Profanity"