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

Quota Based Pricing (QBP)

QBP (Quota Based Pricing) allows you to price each quota within a project uniquely.
To use this functionality, the QBP feature must be enabled by an operator in your buyer account. Please contact your account manager.
With quota based pricing, the PureSpectrum system allows researchers to set different prices on individual quotas.
This will capture harder-to-reach audiences faster with a customized incentive while keeping the budget in check with easier to acquire respondents.
This can be accomplished using the QBP parameter in the Create survey endpoint.
If QBP is enabled that would disable any request to create a TC
Also, once the parent survey is set with QBP on certain quota, then any traffic channels would only take NON QBP quotas into consideration when created.
To enable QBP for a survey the qbp parameters should be passed to the request body like this:
{
  ...

  "qbp" : {
    "enable": true,
    "quota_ids": [
      "abc", // buyer_quota_id
      "xyz"
    ]
    "category": "Age" // optional in case of UI.
  }
}
To disable it:
{
  ...
  
  "qbp" : {
    "enable": false
  }
}
Example
POST /surveys
{
    "live_url": "http://survey.com/",
    "test_url": "http://test.survey.com/",
    "survey_title": "Test QPB",
    "survey_category_code": 231,
    "survey_localization": "en_US",
    "completes_required": 100,
    "expected_ir": 10,
    "expected_loi": 10,
    "offer_price": 10,
    "field_time": 99,
    "qbp": {
        "enable": true,
        "quota_ids": [
            "M",
            "F"
        ]
    },
    "quotas": [
        {
            "buyer_quota_id": "M",
            "required_count": 50,
            "criteria": [
                {
                    "qualification_code": 211,
                    "condition_codes": [
                        "111"
                    ]
                }
            ]
        },
        {
            "buyer_quota_id": "F",
            "required_count": 50,
            "criteria": [
                {
                    "qualification_code": 211,
                    "condition_codes": [
                        "112"
                    ]
                }
            ]
        }
    ],
    "qualifications": [
        {
            "condition_codes": [
                "111",
                "112"
            ],
            "qualification_code": 211
        },
        {
            "range_sets": [
                {
                    "from": 18,
                    "to": 99,
                    "units": 311
                }
            ],
            "qualification_code": 212
        }
    ]
}
Modified at 2025-11-07 13:23:08
Previous
Field Evenly Over Time (FEOT)
Next
Quota Level Complete (QLC)