Registry / http-networking / fathom-python

fathom-python

library0.0.37pypypi✓ verified 85d ago

Official Python SDK for Fathom Analytics, providing a simple interface to record page views, events, and goals via the Fathom API. Current version 0.0.37, actively maintained with irregular releases.

http-networking

pip install fathom-python

package ↗homepage ↗

INSTALL

IMPORT

SIG · FATHOM-PYTHON

fathom-python

http-networkingpythonv0.0.37

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Fathom

✓ from fathom_python import Fathom

✗ from fathom import FathomClient

Initialize the client with your API token and site ID, then record a page view.

from fathom import FathomClient client = FathomClient( api_token=os.environ.get('FATHOM_API_TOKEN', ''), site_id=os.environ.get('FATHOM_SITE_ID', '') ) # Record a page view response = client.pageview( url='https://example.com/page', referrer='https://example.com/other' ) print(response)

Debug

Known issues

breakingIn version 0.0.30 the 'pageview' method signature changed: 'hostname' parameter was removed and 'url' is now required to be a full URL including protocol. Older versions expected just a path.

fix

Always provide the full URL (e.g., 'https://example.com/page').

affects: >=0.0.30

deprecatedThe 'event' method is deprecated since 0.0.35. Use 'goal' instead for recording custom goals.

fix

Replace client.event(name=..., url=...) with client.goal(goal_id=..., url=...).

affects: >=0.0.35

gotchaThe library does not automatically retry on rate limits or network errors. You must wrap calls in your own retry logic.

fix

Use requests.Session with retries or a library like tenacity.

affects: all

Upgrade

Version history

0.0.37latest on PyPI · released Nov 25, 2025

Audit

Dependencies

requestsrequiredHTTP client for API calls

Agent activity

15 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/fathom-python/ ↗

homepagehttps://fathomhq.com ↗