Skip to main content

Python API wrapper for the OpenKVK service

Project description

# OpenKVK: API wrapper
[![Build Status](](
## What is it ?

OpenKVK is an UNOFFICIAL python wrapper for the [openkvk API](

## Main Features
a few of the things this library does well:

- Get dutch company information by name or kvk-number
- Get lists of companies based on sbi-codes, location or both
- Output information in `json`, `csv` or `dict`
- Wrap your own queries with or without result parsing

## Command line interface
For quick access to the openkvk api you could use the OpenKVK CLI, like so:

openkvk --help
openkvk --kvk 27312152 --format json --output test.json

## Installation
The source code is currently hosted on GitHub at:

Install via `pip`:

pip install OpenKVK

And via `easy_install`:

easy_install OpenKVK

## Example

First you need to instantiate a OpenKVK client
from OpenKVKimport ApiClient

client = ApiClient()

The Client returns data as python dicts, to change this output format.
you could do one of the following

client = ApiClient('json')

The client can then be used to query by using the following:


The `city`, `name` and `sbi` functions also accept a maximum number of results (defaults to 99)
and a additional filters, like:

client.get_by_sbi('06.10',limit=150, plaats="Rotterdam")

for a full list of available filters check [openkvk](

If you like to construct you own SQL-queries and you like the results to be parsed to a valid JSON array, a python list of dicts or a valid csv
you could use the `QueryBuilder` class.

from OpenKVK import QueryBuilder

client = QueryBuilder()
client.query("SELECT * FROM kvk WHERE kvks = 27312152")

If you don't want the parsed results there is also a very minimalistic api client

from OpenKVK import BaseClient

client = BaseClient()
client.query("SELECT * FROM kvk WHERE kvks = 27312152")

## License

Version 0.4

- Bugfix QueryBuilder limiter

Version 0.3

- Added python 3 support
- Fixxed additional filters
- Updated documentation

Version 0.2

- Added Commandline interface
- Added method for querying bankruptcies
- Added tests
- Added
- Restructured classes
- Fixed csv output
- Fixed get_by_kvk() method

Version 0.1

First public preview release.

Project details

Download files

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

Files for OpenKVK, version 0.4
Filename, size File type Python version Upload date Hashes
Filename, size (377.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page