iptuapi 1.0.0

SDK oficial para a IPTU API - Dados de IPTU de São Paulo

IPTU API - Python SDK

SDK oficial para integração com a IPTU API.

Instalação

pip install iptuapi

Uso Rápido

from iptuapi import IPTUClient

client = IPTUClient("sua_api_key")

# Consulta por endereço
resultado = client.consulta_endereco("Avenida Paulista", "1000")
print(resultado)

# Consulta por SQL (Starter+)
dados = client.consulta_sql("100-01-001-001")

# Avaliação de mercado (Pro+)
avaliacao = client.valuation_estimate(
    area_terreno=250,
    area_construida=180,
    bairro="Pinheiros",
    zona="ZM",
    tipo_uso="Residencial",
    tipo_padrao="Médio",
    ano_construcao=2010
)
print(f"Valor estimado: R$ {avaliacao['valor_estimado']:,.2f}")

Context Manager

with IPTUClient("sua_api_key") as client:
    resultado = client.consulta_endereco("Avenida Paulista")

Tratamento de Erros

from iptuapi import IPTUClient, NotFoundError, RateLimitError

client = IPTUClient("sua_api_key")

try:
    resultado = client.consulta_endereco("Rua Inexistente")
except NotFoundError:
    print("Imóvel não encontrado")
except RateLimitError:
    print("Limite de requisições excedido")

Documentação

Acesse a documentação completa em iptuapi.com.br/docs