Skip to main content

Untappd Scraper

Web scrape public Untappd pages into data classes.

Quickstart

User queries

from untappd_scraper.user import User

users = ["gregavola"]

for user_id in users:
    user = User(user_id)
    print(f"\n{user.name=}")

    for checkin in user.activity():
        print(f"\n\t{checkin.name=}\n\t\t{checkin}")

    print("\n\nLists:")

    for userlist in user.lists():
        print(f"\n\t{userlist.name=} {userlist.num_items=}")

    print("\n\nRecent Venues:")

    for venue in user.venue_history():
        ago = datetime.now().date() - venue.last_visit
        print(
            f"\n\t{venue.name=} {venue.last_visit.strftime('%b %d %Y')} "
            + f"({ago.days} days ago)"
        )```

    print("\n\nRecent Uniques:")

    for beer in user.beer_history():
        print(f"\t{beer}, {beer.total_checkins=}")

Venue queries

from untappd_scraper.venue import Venue

venue_ids = [
    14705,  # 4 pines
    99967,  # collaroy
]

for venue_id in venue_ids:
    venue = Venue(venue_id)
    print(f"\n{venue.name=}")

    for num, checkin in enumerate(venue.activity(), start=1):
        print(f"\n\t{num=}\t{checkin.name=}\n\t\t{checkin}")

# Load a venue by name. Try to be as unambiguous as possible
venue = Venue.from_name("hotel sweeney")
print(f"\n{venue.name=} {venue.verified=}\t{venue.categories=}\n")
print("\n".join([str(beer) for beer in venue.activity()]))

for menu in venue.menus():
    print(f"\n{menu.selection=} / {menu.name=}")

    print("\n\t\t", end="")
    print("\n\t\t".join(str(beer) for beer in menu.beers))

Notes

untappd-scraper is just that - a scraper. It doesn't store data. So, for example, if you query a user's unique beer history (with User.beer_history()) you will not be able to see the entire history. Just what is public on the web, which is the most recent 25 uniques.

Release files for untappd-scraper 0.17.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for untappd-scraper 0.17.2
File Size Uploaded
untappd_scraper-0.17.2.tar.gz 369.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for untappd-scraper 0.17.2
File Interpreter ABI Platform
untappd_scraper-0.17.2-py3-none-any.whl Python 3 none any Details

Total release size: 405.5 kB

Release files / untappd_scraper-0.17.2.tar.gz

Download URL untappd_scraper-0.17.2.tar.gz
Size 369.8 kB
Tags Source
SHA-256 checksum
How to use checksums
781976f4ffba088fa4f49a73a9d32cb3b71449b3ebd5d6434da80083270e72da
BLAKE2b-256 checksum
How to use checksums
1c37adee9dea0c3b09c0c83dbfee2184bf62c281dfa4d136cc43d770b7ce1dfe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / untappd_scraper-0.17.2-py3-none-any.whl

Download URL untappd_scraper-0.17.2-py3-none-any.whl
Size 35.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
81b6352c794e29f8af56d53371531f20cd4f88d027c2dd747bb7d2707700738f
BLAKE2b-256 checksum
How to use checksums
6da84c6883cf60b6aa9f51669052a1a47fe4412107e12b4ad7d7fff3963ea731
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.17.2 This release

2 release files

0.17.1

2 release files

0.15.2

2 release files

0.15.1

2 release files

0.15.0

2 release files

0.14.0

2 release files

0.13.1

2 release files

0.13.0

2 release files

0.11.3

2 release files

0.11.2

2 release files

0.11.1

2 release files

0.11

2 release files

0.10

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page