Metadata-Version: 2.5
Name: wozapi
Version: 1.0.3
Summary: WOZ-waarde, BAG-adresgegevens en kadastrale percelen van elk Nederlands adres via 1 endpoint. Client voor woz-api.nl.
Project-URL: Homepage, https://woz-api.nl
Project-URL: Documentation, https://wozapi.github.io/
Project-URL: Repository, https://github.com/WozApi/wozapi-clients
Project-URL: Prijzen, https://woz-api.nl/woz-api-prijs
Author-email: Wozapi <info@woz-api.nl>
License: MIT
Keywords: bag,kadaster,nederland,proptech,vastgoed,woz,woz-api,woz-waarde
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Dutch
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# wozapi (Python)

Python-client voor de [WOZ API van woz-api.nl](https://woz-api.nl): de WOZ-waarde,
BAG-adresgegevens en kadastrale percelen van elk Nederlands adres in 1 JSON-response.
Geen externe afhankelijkheden, alleen de standaardbibliotheek.

## Installeren

```bash
pip install wozapi
```

Liever zonder dependency-manager? `wozapi.py` staat op zichzelf en kun je ook los in je
project kopieren.

## Gebruik

```python
from wozapi import WozApi, WozApiError

client = WozApi("jouw-api-key")

try:
    adres = client.adres("Spuistraat 36C, 1012 TT Amsterdam")
    for woz in adres["woz"]:
        print(woz["peildatum"], woz["vastgesteldeWaarde"])
except WozApiError as fout:
    print(fout.status, fout.bericht)
```

Perceelgrenzen als GeoJSON meesturen:

```python
adres = client.adres("Spuistraat 36C, 1012 TT Amsterdam", geometrie=True)
```

Zoeken op BAG-identificatie in plaats van een adrestekst:

```python
client.nummeraanduiding("0363200000218908")
client.adresseerbaar_object("0363010000740855")
```

Creditsaldo opvragen:

```python
print(client.credits())
```

## Een lijst adressen

Een Excel of CSV met adressen per rij aanvullen met de WOZ-waarde, ook als een AI-assistent het
script voor je schrijft: het recept staat in de
[handleiding op woz-api.nl](https://woz-api.nl/docs#een-lijst-adressen). Een adres zonder
WOZ-waarde kost geen credit. Zonder code kan het ook: zie
[WOZ-waarden bij een lijst adressen in Excel](https://woz-api.nl/woz-waarden-in-excel).

## Wat kost het

Een gratis account geeft 10 credits. 1 credit is 1 uniek adres, en hetzelfde adres binnen
7 dagen opnieuw opvragen kost geen extra credit. De prijs per credit loopt van EUR 0,59 tot
EUR 0,30 excl. btw, afhankelijk van hoeveel je in een keer koopt; zie [de prijzen](https://woz-api.nl/woz-api-prijs).

Geen zin in code? Met de [Excel-wizard](https://woz-api.nl/woz-waarden-in-excel) upload je een
bestand met adressen en krijg je het aangevuld terug.

## Documentatie

- API-referentie: [woz-api.nl/swagger](https://woz-api.nl/swagger/index.html)
- Uitleg en achtergrond: [woz-api.nl/artikelen](https://woz-api.nl/artikelen)
- Ontwikkeling van WOZ-waarden per regio: [woz-api.nl/woz-waarde-ontwikkeling](https://woz-api.nl/woz-waarde-ontwikkeling)

## Licentie

MIT

## Wat het kost

EUR 0,59 per credit bij 100 credits, aflopend tot EUR 0,35 bij 1.000 credits, en EUR 0,32 en EUR 0,30
in bundels van 2.500 en 5.000 credits, excl. btw. Geen
abonnement en geen minimale afname, dus een maand zonder opvragingen kost niets. 1 credit is 1
uniek adres; hetzelfde adres binnen 7 dagen opnieuw opvragen kost geen extra credit. Een gratis
account geeft 10 credits. De staffel staat op [woz-api.nl/woz-api-prijs](https://woz-api.nl/woz-api-prijs).
