Como verificar uma entidade comercial dos EUA via API em Python

Publicado em 2026-04-11 por OpenSOSData

A verificação da entidade comercial é uma etapa essencial da conformidade com a KYB, da integração de fornecedores e da due diligence. Em vez de pesquisar manualmente o site da Secretaria de Estado de cada estado, você pode verificar qualquer entidade comercial dos EUA programaticamente usando a API OpenSOSData.

Pré-requisitos

• Python 3.7+
• An OpenSOSData API key (sign up here)
• The requests library: pip install requests

Pesquisa básica

import requests

API_KEY = "osd_your_api_key_here"
BASE_URL = "https://api.opensosdata.com/v1/lookup"

def lookup_entity(name, state):
    response = requests.post(
        BASE_URL,
        headers={
            "x-api-key": API_KEY,
            "Content-Type": "application/json"
        },
        json={
            "entity_name": name,
            "state": state
        }
    )
    return response.json()

result = lookup_entity("Apple Inc", "DE")

if result.get("success"):
    data = result["data"]
    print(f"Entity: {data['entityName']}")
    print(f"Status: {data['status']}")
    print(f"Type: {data['entityType']}")
    print(f"Agent: {data.get('registeredAgentName', 'N/A')}")
else:
    print(f"Failed: {result.get('error')}")

Tratamento de erros

A 200 with "success": true means a match was found. A 200 with "success": false means no match. A 402 means your wallet is empty.

Pesquisa em vários estados

Percorra os códigos estaduais para pesquisar vários estados. Cada chamada custa US$ 0,0314 (os acessos ao cache são gratuitos).

states = ["DE", "NV", "FL", "TX", "CA"]
for state in states:
    result = lookup_entity("Global Financial Impact LLC", state)
    if result.get("success") and result.get("data"):
        print(f"Found in {state}: {result['data']['entityName']}")
        break

For more details, see the full API documentation. For state coverage, visit the state coverage page.