---
id: telegraph
version: "2.2.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# telegraph — Telegraph API wrapper

License: permissive · Maintenance: active · Downloads: 107.3K/mo

## What it is and what it does

Telegraph is a client library for interacting with Telegraph, a simple publishing platform. It wraps Telegraph's HTTP API to let you create accounts, publish articles with HTML content, and manage pages programmatically from Python. The library supports both synchronous calls via the main Telegraph class and asynchronous operations through telegraph.aio, making it suitable for both simple scripts and async-based applications.

The package depends only on requests for HTTP communication and is designed to work across Python 3.7, 3.8, 3.9, 3.10, and 3.11. It abstracts away the details of Telegraph's REST endpoints, letting you focus on content creation and management rather than HTTP mechanics.

Use it for:

- Automatically publish articles to Telegraph from a Python application or script
- Build a content aggregator that republishes articles to Telegraph programmatically
- Integrate Telegraph publishing into an async web framework or bot
- Programmatically manage Telegraph accounts and pages from a backend service

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Telegraph is a Python wrapper for the Telegraph API that lets you create and manage articles on Telegraph with support for both synchronous and asynchronous operations.

Yes, if you need to publish or manage content on Telegraph programmatically. The package has low install friction, active maintenance, MIT licensing, and no known vulnerabilities. The main caveat is that the latest release is from 2022; verify that the API wrapper remains compatible with Telegraph's current service before relying on it in production.

## Install

pip install telegraph
uv add telegraph
poetry add telegraph

## Installing telegraph

Before you install: Low friction install with a single runtime dependency (requests). The package is actively maintained with recent commits and has been stable since its first release.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install telegraph

from telegraph import Telegraph

telegraph = Telegraph()
telegraph.create_account(short_name='1337')
response = telegraph.create_page('Hey', html_content='Hello, world!')
print(response['url'])

Verify before relying:

- Whether the async extra (telegraph[aio]) requires additional dependencies beyond requests
- Current API compatibility with Telegraph's service and any breaking changes since the 2022 release

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 107.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

telegraph api wrapper, create publish articles telegraph, python telegraph client, async telegraph api, telegraph content publishing, telegraph page creation, api-wrapper, publishing, async-support

[View on SkillFed](https://skillfed.io/packages/telegraph) · [View on PyPI](https://pypi.org/project/telegraph/)