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!

Client for the Offenes Köln API

Project Description

Offenes Köln is a platform that allows for flexible access
to the content of the City of Cologne/Germany's city council information system.

Find more information about the platform at

More detailed information on the REST API is available at


pip install okclient

**Quick start**

import okclient
oc = okclient.Client()

# Search for documents containing "Haushalt"
result = oc.documents(query="haushalt")
for doc in result:
print, doc.title

# Retrieve the document with identifier "3323/2008"
# including attachments and thumbnails
result = oc.documents("3323/2008", attachments=True,
print result[0].date, result[0].title
print result[0].attachments[0].url
print result[0].attachments[0].content

# Find streets surrounding a geo position
# (reverse geocoding)
streets = oc.streets(lat=50.959, lon=6.946)
for street in streets:
(name, distance) = street
print "%s is %d meters away" % (name, distance)

# Find position of street "Mittelstraße"
# (also called geocoding)
mittelstr = oc.locations("Mittelstraße")
# return quasi-centroid of that street
print mittelstr.averages[0]
# print out all nodes of that streets
for node in mittelstr.nodes:
print node


Feel free to give feedback via the Issue tracking at

**Stay tuned**

Stay informed about changes in this client and the API by following our
commits on Github (see URL above), reading our Blog and/or following
the twitter account.

Release History

This version
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.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(4.9 kB) Copy SHA256 Hash SHA256
Source Feb 2, 2013

Supported By

WebFaction WebFaction Technical Writing 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 Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting