Surveys

Create Round-Robin Survey

Create a round-robin (pairwise comparison) survey campaign. This creates the campaign, uploads images to CDN, and sets up the round-robin question with image options. Users will be shown pairs of images and asked to pick their preference. With N images, users compare N*(N-1)/2 pairs.

POST/nfthing/survey/round-robin/create

Headers

Field	Type	Required	Description
X-API-Key	string	Yes	Your Membrane API key.

Form fields

Field	Type	Required	Description
title	string	Yes	Survey title.
description	string	Yes	Survey description.
content_url	string	No	URL associated with the survey.
category	string	Yes	Survey category.
tagline	string	Yes	Short tagline.
reward_amount	integer	Yes	Reward amount.
question	string	Yes	The pairwise comparison question text.
images	file[]	Yes	Image files (min 2). Filename (minus extension) becomes the title.

Example response

200 OK

{
  "success": true,
  "message": "Round-robin survey created successfully",
  "data": {
    "id": 232,
    "post_id": "a7dedbe6-2cd5-448e-8669-f48b9c7ad38b",
    "type": "round_robin_survey",
    "title": "Product Comparison",
    "is_live": false,
    "ad_feedback_id": 795,
    "question": "Which product design do you prefer?",
    "total_images": 3,
    "total_pairs": 3,
    "image_options": [
      {
        "title": "Product_A",
        "image_url": "https://cdn.example.com/ads/round_robin/uuid_Product_A.jpg"
      },
      {
        "title": "Product_B",
        "image_url": "https://cdn.example.com/ads/round_robin/uuid_Product_B.jpg"
      },
      {
        "title": "Product_C",
        "image_url": "https://cdn.example.com/ads/round_robin/uuid_Product_C.jpg"
      }
    ]
  }
}

Notes

• This endpoint uses multipart/form-data — Content-Type is set automatically by your HTTP client.
• Pick at least 2 image files. With 3 images you get 3 pairs, 4 → 6, 5 → 10.