python-urbandict

This is a python project, that fetches definitions of words from urban dictionary's public API.

Future additions. PRs are always welcome :)

Calculate ratio of thumbs_up and thumbs_down and decide the probability of a correct definition.

Installation

Python 3.9 or higher is required

To install the library you can use the following command:

# Linux/MacOS
python3 -m pip install --upgrade python-urbandict

# Windows
py -3 -m pip install --upgrade python-urbandict

Or just try:

pip install python-urbandict

Quick Example

You can create an instance of the UrbanDict class and pass a word to it. After that you can use the search method that will retrieve the definitions from UrbanDictionary. If you want to you can also leave the word attribute empty, in which case a random word is selected by UrbanDictionary.

from pyurbandict import UrbanDict

word = UrbanDict("python")
results = word.search()
print(results[0])

>>> Definition(
    word='python',
    definition='The best thing to happen to [Computer Science] students in a data and [file] structures or [algorithms] class.',
    example='Joe: "Man...I spent a week coding that [algorithm] in C."\r\nMoe: "I got it [done in one] evening with [Python]. It works great."\r\nJoe: "Say, what? Where can I download that?"',
    author='TheNextBillGates',
    thumbs_up=243,
    thumbs_down=71,
    sound_urls=['https://api.twilio.com/2008-08-01/Accounts/ACd09691b82112e4b26fce156d7c01d0ed/Recordings/RE7065a4ef810937cc16ae2b6e4b54b67d'],
    written_on='2010-03-24T05:24:18.000Z',
    permalink='http://python.urbanup.com/4826760',
    defid=4826760,
    current_vote=''
)

Links

PyPi

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python_urbandict-0.3.17.tar.gz (4.5 kB view details)

Uploaded Jul 11, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

python_urbandict-0.3.17-py3-none-any.whl (4.2 kB view details)

Uploaded Jul 11, 2026 Python 3

File details

Details for the file python_urbandict-0.3.17.tar.gz.

File metadata

Download URL: python_urbandict-0.3.17.tar.gz
Upload date: Jul 11, 2026
Size: 4.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for python_urbandict-0.3.17.tar.gz
Algorithm	Hash digest
SHA256	`3affd6e24a4c55ae3d66ab6017ec3e218505b3fb434d9f2199a5fefdd73014cf`
MD5	`361f339e5737f14b1c31330b3d4947d9`
BLAKE2b-256	`877103f52435629532866673b7b83c376b8986f39d1d7cc88680c8a3908b97a8`

See more details on using hashes here.

Provenance

The following attestation bundles were made for python_urbandict-0.3.17.tar.gz:

Publisher: python-publish.yml on atbuy/pyurbandict

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: python_urbandict-0.3.17.tar.gz
- Subject digest: 3affd6e24a4c55ae3d66ab6017ec3e218505b3fb434d9f2199a5fefdd73014cf
- Sigstore transparency entry: 2142862622
- Sigstore integration time: Jul 11, 2026
Source repository:
- Permalink: atbuy/pyurbandict@bf89cb35a06ea85fe1d4d0d168b78f9b6e7f5b06
- Branch / Tag: refs/tags/v0.3.17
- Owner: https://github.com/atbuy
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-publish.yml@bf89cb35a06ea85fe1d4d0d168b78f9b6e7f5b06
- Trigger Event: release