surveycoder 1.0.0

Python SDK for Survey Coder Pro — AI-powered survey coding

surveycoder

Python SDK for Survey Coder Pro — AI-powered open-ended survey coding.

Installation

pip install surveycoder
# With pandas integration:
pip install surveycoder[pandas]

Quick Start

from surveycoder import SurveyCoderClient

client = SurveyCoderClient(api_key="scp_live_your_key")

result = client.code(
    responses=[
        {"id": "1", "text": "Me gusta el sabor pero es caro"},
        {"id": "2", "text": "Excelente servicio al cliente"},
    ],
    coding_type="qualitative",
    language="es",
)

print(result["codebook"])
print(result["results"])

Pandas Integration

df = client.code_to_dataframe(
    responses=[...],
    coding_type="qualitative",
)
df.to_excel("coded.xlsx")

Export

# Excel
excel_bytes = client.export_excel(
    project_id=result["project_id"],
    layout="wide_by_question",
    include_categories=False,
)
with open("coded.xlsx", "wb") as f:
    f.write(excel_bytes)

# CSV
csv_text = client.export_csv(project_id=result["project_id"])

Large Datasets (async jobs)

job = client.code(responses=large_dataset)  # >= 50 responses
result = client.wait_for_job(job["job_id"])  # Polls every 5s

API Docs

https://api.surveycoder.io/docs