WhatsApp Research API

About this tool

The WhatsApp Research API lets you run automated market research surveys via WhatsApp. Provide a list of phone numbers and a set of questions — the API sends each contact the questions one by one as they reply, then generates a structured report with all answers.

Perfect for: price discovery, supplier surveys, customer satisfaction, availability checks, competitor research — at scale, programmatically.

How it works

Start research — POST /whatsapp/research/start with numbers[] and questions[]
Contacts receive — "Olá! Gostaríamos de fazer algumas perguntas rápidas. Pode nos ajudar?"
Auto-advance — Each reply triggers the next question automatically
Track progress — GET /whatsapp/research/:id returns live status
Get report — GET /whatsapp/research/:id/report returns structured Q&A per contact

Quick Start — Start Research

curl -X POST https://api.iteratools.com/whatsapp/research/start \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "numbers": ["+5548991234567", "+5511987654321"],
    "questions": [
      "Qual seu prazo médio de entrega?",
      "Qual o preço médio por unidade?",
      "Vocês atendem pessoa jurídica?"
    ]
  }'

Response — research started

{
  "ok": true,
  "research_id": "res_abc123def456",
  "total_contacts": 2,
  "messages_sent": 2,
  "status": "started"
}

Get Report

curl https://api.iteratools.com/whatsapp/research/res_abc123def456/report \
  -H "Authorization: Bearer YOUR_KEY"

{
  "ok": true,
  "research_id": "res_abc123def456",
  "status": "completed",
  "summary": { "total": 2, "responded": 2, "completion_rate": "100%" },
  "responses": [
    {
      "number": "+5548991234567",
      "answers": [
        { "question": "Qual seu prazo médio de entrega?", "answer": "3 dias úteis" },
        { "question": "Qual o preço médio por unidade?", "answer": "R$ 25,00" },
        { "question": "Vocês atendem pessoa jurídica?", "answer": "Sim, com CNPJ" }
      ]
    }
  ]
}

Endpoints

Method	Endpoint	Price	Description
POST	/whatsapp/research/start	$0.070/contact	Start research session
GET	/whatsapp/research/:id	$0.001	Check progress
POST	/whatsapp/research/:id/answer	$0.001	Record answer (internal webhook)
GET	/whatsapp/research/:id/report	$0.001	Get structured report

Pricing

$0.070 per contact when starting research (covers WhatsApp conversation cost). Status/report endpoints cost $0.001 each. Pay via x402 micropayment on Base (USDC) or Bearer API key.