Survey Design Optimization

import os, requests, time

SM = os.environ["SURVEYMONKEY_TOKEN"]
MV = os.environ["MAVERA_API_KEY"]
SM_BASE = "https://api.surveymonkey.com/v3"
MB = "https://app.mavera.io/api/v1"
SM_H = {"Authorization": f"Bearer {SM}"}
MV_H = {"Authorization": f"Bearer {MV}", "Content-Type": "application/json"}

SURVEY_ID = os.environ.get("SURVEY_ID", "your_survey_id")

# 1. Pull survey structure
survey = requests.get(f"{SM_BASE}/surveys/{SURVEY_ID}/details",
    headers=SM_H).json()
print(f"Survey: {survey.get('title', 'Untitled')}")

# 2. Extract questions in human-readable format
survey_text = []
q_num = 0
for page in survey.get("pages", []):
    page_title = page.get("title", "")
    if page_title:
        survey_text.append(f"\n--- Page: {page_title} ---")

    for q in page.get("questions", []):
        q_num += 1
        heading = q.get("headings", [{}])[0].get("heading", "Untitled")
        q_type = q.get("family", "unknown")
        subtype = q.get("subtype", "")
        required = "Required" if q.get("required", {}).get("text") else "Optional"

        choices = []
        for c in q.get("answers", {}).get("choices", []):
            choices.append(c.get("text", ""))
        for r in q.get("answers", {}).get("rows", []):
            choices.append(f"Row: {r.get('text', '')}")

        q_text = f"Q{q_num}. [{q_type}/{subtype}] [{required}] {heading}"
        if choices:
            q_text += f"\n     Options: {', '.join(choices[:10])}"
        survey_text.append(q_text)

full_survey = "\n".join(survey_text)
print(f"Questions: {q_num}")

# 3. Create respondent personas
RESPONDENT_PROFILES = [
    {"name": "SM: Busy Executive",
     "desc": "C-level, reads fast, low patience for long surveys. Will abandon if confused."},
    {"name": "SM: Detail-Oriented Analyst",
     "desc": "Data person. Wants precise questions. Will overthink ambiguous wording."},
    {"name": "SM: Non-Native English Speaker",
     "desc": "International respondent. Struggles with idioms, double negatives, jargon."},
]

persona_ids = []
for profile in RESPONDENT_PROFILES:
    p = requests.post(f"{MB}/personas", headers=MV_H, json={
        "name": profile["name"],
        "description": profile["desc"],
    }).json()
    persona_ids.append(p["id"])
    time.sleep(0.3)

# 4. Focus Group: personas "take" the survey
fg = requests.post(f"{MB}/focus-groups", headers=MV_H, json={
    "name": f"Survey Review: {survey.get('title', 'Survey')}",
    "persona_ids": persona_ids,
    "context": f"""You are about to take this survey. Read each question carefully.

FULL SURVEY:
{full_survey}""",
    "questions": [
        "Go through each question. Which ones confused you? For each confusing question, explain what's unclear and suggest a rephrasing.",
        "Are any questions leading or biased? Which ones and why?",
        "At what point in the survey would you consider abandoning it? Why?",
        "Which questions would you skip if they were optional? Why?",
        "Rate the overall survey experience (1-10) and explain your rating.",
        "If you could remove 3 questions without losing important data, which 3?",
        "Rewrite the single worst question in this survey.",
    ],
    "responses_per_persona": 3,
}).json()

# 5. Poll for results
for _ in range(20):
    time.sleep(5)
    result = requests.get(f"{MB}/focus-groups/{fg['id']}",
        headers=MV_H).json()
    if result.get("status") == "completed":
        break

print(f"\nFocus Group: {fg['id']}")
for resp in result.get("responses", []):
    print(f"\n[{resp.get('persona_name', '?')}] {resp.get('question', '')[:60]}...")
    print(f"  → {resp.get('answer', '')[:300]}")

const SM = process.env.SURVEYMONKEY_TOKEN;
const MV = process.env.MAVERA_API_KEY;
const SM_BASE = "https://api.surveymonkey.com/v3";
const MB = "https://app.mavera.io/api/v1";
const smH = { Authorization: `Bearer ${SM}` };
const mvH = { Authorization: `Bearer ${MV}`, "Content-Type": "application/json" };
const SURVEY_ID = process.env.SURVEY_ID || "your_survey_id";

// 1. Survey structure
const survey = await fetch(`${SM_BASE}/surveys/${SURVEY_ID}/details`,
  { headers: smH }).then(r => r.json());
console.log(`Survey: ${survey.title}`);

// 2. Extract questions
const surveyText = [];
let qNum = 0;
for (const page of survey.pages || []) {
  if (page.title) surveyText.push(`\n--- Page: ${page.title} ---`);
  for (const q of page.questions || []) {
    qNum++;
    const heading = q.headings?.[0]?.heading || "Untitled";
    const required = q.required?.text ? "Required" : "Optional";
    const choices = [
      ...(q.answers?.choices || []).map(c => c.text),
      ...(q.answers?.rows || []).map(r => `Row: ${r.text}`),
    ].filter(Boolean).slice(0, 10);
    let text = `Q${qNum}. [${q.family}/${q.subtype || ""}] [${required}] ${heading}`;
    if (choices.length) text += `\n     Options: ${choices.join(", ")}`;
    surveyText.push(text);
  }
}
console.log(`Questions: ${qNum}`);

// 3. Create respondent personas
const profiles = [
  { name: "SM: Busy Executive", desc: "C-level. Fast reader, low patience. Abandons if confused." },
  { name: "SM: Detail-Oriented Analyst", desc: "Data person. Wants precise questions. Overthinks ambiguity." },
  { name: "SM: Non-Native English Speaker", desc: "International. Struggles with idioms, double negatives." },
];

const personaIds = [];
for (const profile of profiles) {
  const p = await fetch(`${MB}/personas`, { method: "POST", headers: mvH,
    body: JSON.stringify({ name: profile.name, description: profile.desc }) }).then(r => r.json());
  personaIds.push(p.id);
  await new Promise(r => setTimeout(r, 300));
}

// 4. Focus Group
const fg = await fetch(`${MB}/focus-groups`, { method: "POST", headers: mvH,
  body: JSON.stringify({
    name: `Survey Review: ${survey.title}`,
    persona_ids: personaIds,
    context: `Take this survey. Read each question carefully.\n\n${surveyText.join("\n")}`,
    questions: [
      "Which questions confused you? Explain and suggest rephrasing.",
      "Are any questions leading or biased? Which and why?",
      "At what point would you abandon the survey? Why?",
      "Which optional questions would you skip? Why?",
      "Rate overall experience (1-10) and explain.",
      "If you could remove 3 questions, which 3?",
      "Rewrite the single worst question.",
    ],
    responses_per_persona: 3,
  }),
}).then(r => r.json());

// 5. Poll
let result;
for (let i = 0; i < 20; i++) {
  await new Promise(r => setTimeout(r, 5000));
  result = await fetch(`${MB}/focus-groups/${fg.id}`, { headers: mvH }).then(r => r.json());
  if (result.status === "completed") break;
}

console.log(`\nFocus Group: ${fg.id}`);
for (const resp of result.responses || []) {
  console.log(`\n[${resp.persona_name || "?"}] ${(resp.question || "").slice(0, 60)}...`);
  console.log(`  → ${(resp.answer || "").slice(0, 300)}`);
}