PureSpectrum
PureSpectrum websiteHelp center
PureSpectrum websiteHelp center
  1. Guides
  • Intro
  • API Overview
  • Definitions
  • Survey Lifecycle
  • Create Your First Survey
  • Redirect URLs
  • Changelog
  • HTTP Status Codes
  • General Reference Codes
    • Survey Status Codes
    • Respondent Status Codes
    • Survey Category Codes
    • Age Unit Codes
    • Currency Codes
    • Survey Localization Codes
  • Guides
    • Getting Started
    • Create Survey Examples
    • Multi-Country Surveys
    • Children Age & Gender
    • Append Respondent Demographics to the Survey Entry Link
    • Test Survey Flow
    • Supplier Blends & Groups
    • Respondent Exclusion / Recontact
    • Survey Exclusion Group
    • Quotas on Clicks
    • Field Evenly Over Time (FEOT)
    • Quota Based Pricing (QBP)
    • Quota Level Complete (QLC)
    • Quota Throttling
    • Templates
    • Bypassing Automatic Variable Mapping
    • Research Defender's Predupe
    • Subscriber Emails
    • Real-Time Notifications (SNS)
  • API Reference
  • Schemas
    • Feasibility
      • Feasibility request schema
      • Feasibility response schema
    • Surveys
      • Create survey full request schema
      • Create survey minimum request schema
      • Create survey response schema
      • Update survey status request schema
      • Update survey status response schema
      • Get survey status response
    • Qualifications
      • Qualification Schema
      • Create qualification request schema
    • Quotas
      • Quota Schema
      • Create quota request schema
      • Create quota response schema
    • Attributes
      • Get attributes response
    • Supplier management
      • Supplier
      • List of all suppliers response
      • List of all suppliers per survey response
      • Update the list of suppliers for a Survey request
      • Update the list of suppliers for a Survey response
    • Other
      • Generic error response
  1. Guides

Supplier Blends & Groups

Supplier Blends#

The Supplier Blend feature allows you to save presets for Supplier Allocation, Flexibility and Groups.
In order to avoid having to create Supplier Groups and Allocations manually for every survey, you can use Supplier Blends to quickly apply these presets by choosing them from a list.
You are also able to set a Supplier Blend as a default so that new surveys will have this Blend applied automatically.
For more information on this feature, access the Supplier Blends & Grouping page.
Supplier Blend endpoints
See below the list of available endpoints for supplier blend management:
Get list of supplier blends
Create supplier blend

Creating Survey with Supplier Blend Applied#

When creating a survey with POST /surveys you can pass the blend_id parameter to the payload in order to apply a supplier blend to the survey.
Example:
{
    "live_url": "http://example.com/survey",
    "test_url": "http://example.com/survey-test",
    "survey_title": "API Blend Test",
    "click_balancing": 0,
    "estimated_clicks": 0,
    "survey_category_code": 211,
    "survey_localization": "en_US",
    "completes_required": 100,
    "expected_ir": 65,
    "expected_loi": 5,
    "field_time": 5,
    "source": "platform",
    "buyer_user_id": 51,
    "buyer_company": 25,
    "qualifications": [],
    
    "blend_id": "sb123456789"
}

Supplier Groups#

With a growing list of suppliers, some buyers may choose to group suppliers together for a cleaner UI/API experience.
Grouped suppliers appear as a single supplier, combining and controlling the allocations and CPI values of multiple suppliers to make the UI more user friendly, and easier to manage. The grouped supplier is not a mechanism to hide survey details or buyer details from any party.
The endpoint that will enable you to do this can be found here Update the list of suppliers for a Survey.
Modified at 2025-07-04 13:01:20
Previous
Test Survey Flow
Next
Respondent Exclusion / Recontact