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_upandthumbs_downand 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
Release files for python-urbandict 0.3.17
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| python_urbandict-0.3.17.tar.gz | 4.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| python_urbandict-0.3.17-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 8.6 kB
Release files / python_urbandict-0.3.17.tar.gz
| Download URL | python_urbandict-0.3.17.tar.gz |
|---|---|
| Size | 4.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3affd6e24a4c55ae3d66ab6017ec3e218505b3fb434d9f2199a5fefdd73014cf
|
|
BLAKE2b-256 checksum How to use checksums |
877103f52435629532866673b7b83c376b8986f39d1d7cc88680c8a3908b97a8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 11, 2026.
Transparency logRelease files / python_urbandict-0.3.17-py3-none-any.whl
| Download URL | python_urbandict-0.3.17-py3-none-any.whl |
|---|---|
| Size | 4.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2da95a4d9eaae42f48eecfe1e8171b0fc49269d3db1f5c841db1d8b05f45241f
|
|
BLAKE2b-256 checksum How to use checksums |
8adeb9c00ce0bd7ac7a016a6d295a0c334ba88d8efc435bbcb79147dcb314ecd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 11, 2026.
Transparency log
