Python

Consulte CPF em Python com requests ou urllib nativo.

Integrando com Cursor, Lovable, v0 ou outra IA?

Copie o prompt de integração e cole direto no seu assistente de IA - ele saberá exatamente como usar a API.

Pré-requisitos

Python 3.8+
Uma API Key em app.cpfhub.io

Exemplo

import os
import requests

cpf     = '12345678909'
api_key = os.environ['CPFHUB_API_KEY']

res = requests.get(
  f'https://api.cpfhub.io/cpf/{cpf}',
  headers={'x-api-key': api_key},
)
res.raise_for_status()

data = res.json()['data']
print(data['name'])       # "Fulano de Tal"
print(data['birthDate'])  # "15/06/1990"
print(data['gender'])     # "M"

Instalação de dependências

bash

pip install requests

urllib faz parte da biblioteca padrão - sem instalação necessária.

Com Django

Python

# views.py
import os
import requests
from django.http import JsonResponse

API_KEY = os.environ['CPFHUB_API_KEY']

def consulta_cpf(request, cpf):
    res = requests.get(
        f'https://api.cpfhub.io/cpf/{cpf}',
        headers={'x-api-key': API_KEY},
    )

    if res.status_code == 404:
        return JsonResponse({'error': 'CPF não encontrado'}, status=404)

    res.raise_for_status()
    return JsonResponse({'data': res.json()['data']})

Campos retornados

Campo	Tipo	Exemplo
`cpf`	str	`"12345678909"`
`name`	str	`"Fulano de Tal"`
`nameUpper`	str	`"FULANO DE TAL"`
`gender`	str	`"M"`
`birthDate`	str	`"15/06/1990"`
`day`	int	`15`
`month`	int	`6`
`year`	int	`1990`

Tratamento de erros

HTTP	`error.code`	Descrição
404	`CPF_NOT_FOUND`	CPF não consta na base
422	`INVALID_CPF_DIGITS`	Dígitos verificadores inválidos
429	`RATE_LIMIT_EXCEEDED`	Muitas requisições
401	`UNAUTHORIZED`	API Key inválida ou ausente

Links

Atualizado em 17 de maio de 2026