Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Python binding for the Socialtext REST API

Project Description

This is a client for Socialtext’s REST API. The goal of this project is to provide an extensible library that helps you focus on building applications that leverage the power of Socialtext instead of worrying about HTTP methods and status codes.

You can read the documentation at:


You can install python-socialtext using pip or easy_install:

pip install python-socialtext

# or

easy_install python-socialtext

The tests use nose and can be run using:

python test

# or


You can use Sphinx to build the documentation locally:

cd docs
make html # windows: use make.bat

# open the _build/index.html document in your browser

Python API

Quick start:

from socialtext import Socialtext

st = Socialtext(url=ST_URL, username=USERNAME, password=PASSWORD)

st.signals.create("This is a signal from the API!")
<Signal: 1234>


<Page: test_page>, <Page: test_page_2>, <Page: test_page_3>

ws = st.workspaces.get("ws-name")
<Page: test_page>, <Page: test_page_2>, <Page: test_page_3>


Development takes place on Github. You can file bug reports and pull requests there.


This project follows the git-flow branch methodology. So, there will always be two branches in the repository:

The stable, production branch.
Active development work towards the next release. All pull requests will be merged into this branch.

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(65.5 kB) Copy SHA256 Hash SHA256
Source None Dec 29, 2011

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting