Profanity Filtering

Profanity Filter looks for recognized profanity and replaces it with asterisks.

profanity_filter boolean Default: false

🛝

Try this feature out in our API Playground!

Enable Feature

To enable Profanity Filtering, use the following parameter in the query string when you call Deepgram’s /listen endpoint :

profanity_filter=true

To transcribe audio from a file on your computer, run the following cURL command in a terminal or your favorite API client.

curl \
  --request POST \
  --header 'Authorization: Token YOUR_DEEPGRAM_API_KEY' \
  --header 'Content-Type: audio/wav' \
  --data-binary @youraudio.wav \
  --url 'https://api.deepgram.com/v1/listen?profanity_filter=true'

🚧

Replace YOUR_DEEPGRAM_API_KEY with your Deepgram API Key.

Results

Filtered results will appear in the transcript as ****

{
    "metadata": {
        "transaction_key": "deprecated",
        "request_id": "9d5be02c-85a6-4e88-839e-474507583c70",
        "sha256": "36ee5ac2e476126b4a50bc192239ab73e5f9cdd496b0f27c516162447631a105",
        "created": "2024-12-14T00:07:25.012Z",
        "duration": 22.013313,
        "channels": 1,
        "models": [
            "1abfe86b-e047-4eed-858a-35e5625b41ee"
        ],
        "model_info": {
            "1abfe86b-e047-4eed-858a-35e5625b41ee": {
                "name": "2-general-nova",
                "version": "2024-01-06.5664",
                "arch": "nova-2"
            }
        }
    },
    "results": {
        "channels": [
            {
                "alternatives": [
                    {
                        "transcript": "it's a test of profanity filtering **** **** ******* **** you ******* **** *** **** you that's the end of the test",
                        "confidence": 0.9854036,
                        "words": [
                            {
                                "word": "it's",
                                "start": 1.92,
                                "end": 2.1599998,
                                "confidence": 0.94446576
                            },
                            {
                                "word": "a",
                                "start": 2.1599998,
                                "end": 2.32,
                                "confidence": 0.6431149
                            },
                            {
                                "word": "test",
                                "start": 2.32,
                                "end": 2.72,
                                "confidence": 0.9996898
                            },
                            {
                                "word": "of",
                                "start": 2.72,
                                "end": 2.96,
                                "confidence": 0.9829601
                            },
                            {
                                "word": "profanity",
                                "start": 2.96,
                                "end": 3.46,
                                "confidence": 0.99511766
                            },
                            {
                                "word": "filtering",
                                "start": 3.6799998,
                                "end": 4.18,
                                "confidence": 0.9920975
                            },
                            {
                                "word": "****",
                                "start": 5.12,
                                "end": 5.62,
                                "confidence": 0.9255334
                            },
                            {
                                "word": "****",
                                "start": 6.08,
                                "end": 6.58,
                                "confidence": 0.99655294
                            },
                            {
                                "word": "*******",
                                "start": 7.2,
                                "end": 7.7,
                                "confidence": 0.9951559
                            },
                            {
                                "word": "****",
                                "start": 8.32,
                                "end": 8.82,
                                "confidence": 0.627333
                            },
                            {
                                "word": "you",
                                "start": 9.5199995,
                                "end": 10.0199995,
                                "confidence": 0.67789125
                            },
                            {
                                "word": "*******",
                                "start": 11.068313,
                                "end": 11.568313,
                                "confidence": 0.96285325
                            },
                            {
                                "word": "****",
                                "start": 12.428312,
                                "end": 12.928312,
                                "confidence": 0.97373027
                            },
                            {
                                "word": "***",
                                "start": 18.028313,
                                "end": 18.348312,
                                "confidence": 0.8841204
                            },
                            {
                                "word": "****",
                                "start": 18.348312,
                                "end": 18.668312,
                                "confidence": 0.9854036
                            },
                            {
                                "word": "you",
                                "start": 18.668312,
                                "end": 19.168312,
                                "confidence": 0.9957408
                            },
                            {
                                "word": "that's",
                                "start": 19.94831,
                                "end": 20.268312,
                                "confidence": 0.9990535
                            },
                            {
                                "word": "the",
                                "start": 20.268312,
                                "end": 20.348312,
                                "confidence": 0.94378966
                            },
                            {
                                "word": "end",
                                "start": 20.348312,
                                "end": 20.508312,
                                "confidence": 0.9983961
                            },
                            {
                                "word": "of",
                                "start": 20.508312,
                                "end": 20.668312,
                                "confidence": 0.9802233
                            },
                            {
                                "word": "the",
                                "start": 20.668312,
                                "end": 20.748312,
                                "confidence": 0.9961033
                            },
                            {
                                "word": "test",
                                "start": 20.748312,
                                "end": 21.248312,
                                "confidence": 0.9991727
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

What’s Next