Create a preview - Emporia Research

{
  "audience": "CYBERSECURITY_PROFESSIONALS",
  "studyType": "QUANT",
  "loiMinutes": 15,
  "incidenceRate": 30,
  "targetNSize": 200,
  "filters": {
    "countries": ["US", "CA"],
    "employeeRanges": ["FIFTY_ONE_TO_FIVE_HUNDRED", "FIVE_HUNDRED_ONE_TO_ONE_THOUSAND"],
    "industries": ["HEALTHCARE"],
    "seniorities": ["VP", "DIRECTOR"]
  }
}

{
  "id": "4f1a9c2e7b3d4a8e9c6b2d5f8a1e3c7b",
  "expiresAt": "2026-10-28T16:12:44.207531Z",
  "audience": "CYBERSECURITY_PROFESSIONALS",
  "studyType": "QUANT",
  "loiMinutes": 15,
  "incidenceRate": 30,
  "targetNSize": 200,
  "filters": {
    "countries": ["CA", "US"],
    "employeeRanges": ["FIFTY_ONE_TO_FIVE_HUNDRED", "FIVE_HUNDRED_ONE_TO_ONE_THOUSAND"],
    "industries": ["HEALTHCARE"],
    "seniorities": ["DIRECTOR", "VP"]
  },
  "nSize": 340,
  "cpi": {
    "amount": 85.00,
    "currency": "USD"
  },
  "exampleProfiles": [
    {
      "jobTitle": "Director of Security Operations",
      "industry": "HEALTHCARE",
      "employeeRange": "FIFTY_ONE_TO_FIVE_HUNDRED",
      "country": "US",
      "seniority": "DIRECTOR"
    },
    {
      "jobTitle": "VP, Information Security",
      "industry": "HEALTHCARE",
      "employeeRange": "FIVE_HUNDRED_ONE_TO_ONE_THOUSAND",
      "country": "CA",
      "seniority": "VP"
    }
  ]
}

{
  "audience": "CYBERSECURITY_PROFESSIONALS",
  "studyType": "QUANT",
  "loiMinutes": 15,
  "incidenceRate": 30,
  "targetNSize": 200,
  "filters": {
    "countries": ["US", "CA"],
    "employeeRanges": ["FIFTY_ONE_TO_FIVE_HUNDRED", "FIVE_HUNDRED_ONE_TO_ONE_THOUSAND"],
    "industries": ["HEALTHCARE"],
    "seniorities": ["VP", "DIRECTOR"]
  }
}

{
  "id": "4f1a9c2e7b3d4a8e9c6b2d5f8a1e3c7b",
  "expiresAt": "2026-10-28T16:12:44.207531Z",
  "audience": "CYBERSECURITY_PROFESSIONALS",
  "studyType": "QUANT",
  "loiMinutes": 15,
  "incidenceRate": 30,
  "targetNSize": 200,
  "filters": {
    "countries": ["CA", "US"],
    "employeeRanges": ["FIFTY_ONE_TO_FIVE_HUNDRED", "FIVE_HUNDRED_ONE_TO_ONE_THOUSAND"],
    "industries": ["HEALTHCARE"],
    "seniorities": ["DIRECTOR", "VP"]
  },
  "nSize": 340,
  "cpi": {
    "amount": 85.00,
    "currency": "USD"
  },
  "exampleProfiles": [
    {
      "jobTitle": "Director of Security Operations",
      "industry": "HEALTHCARE",
      "employeeRange": "FIFTY_ONE_TO_FIVE_HUNDRED",
      "country": "US",
      "seniority": "DIRECTOR"
    },
    {
      "jobTitle": "VP, Information Security",
      "industry": "HEALTHCARE",
      "employeeRange": "FIVE_HUNDRED_ONE_TO_ONE_THOUSAND",
      "country": "CA",
      "seniority": "VP"
    }
  ]
}

Returns a quote and an id. Use the id to create a project within 24 hours, after which the quote expires. Values within one filter are OR’d; different filters are AND’d.

Body

string

required

An audience ID from Get taxonomy.

string

required

QUANT or AI_MODERATED_INTERVIEW.

integer

required

Length of interview in minutes.

integer

default:"100"

Expected percentage of respondents who qualify, from 1 to 100.

integer

required

Completes wanted.

object

Narrows the audience. Values come from Get taxonomy.

Show properties

string[]

ISO 3166-1 alpha-2 country codes.

string[]

Company size buckets.

string[]

Industry buckets.

string[]

Seniority levels. Ignored when the audience has fixedSeniority: true.

Response

string

required

Preview ID.

string

required

UTC timestamp, 24 hours after the preview was created.

mixed

Echo of the request with defaults applied. For audiences with fixedSeniority: true, filters.seniorities shows the audience’s seniorities, not what you sent.

integer

required

Completes we expect to deliver.

object | null

required

Price per complete. null when nSize is 0.

Show properties

number

required

Price per complete.

string

required

ISO 4217 currency code.

object[]

required

Three to five anonymized profiles matching the filters. Empty when nSize is 0.

Show properties

string

Job title.

string

Industry ID.

string

Employee range ID.

string

ISO 3166-1 alpha-2 country code.

string

Seniority ID.

Errors

General errors are listed in the Overview.

Status	Code	When
400	`INVALID_AUDIENCE`	`audience` is missing or isn’t in the taxonomy.
400	`INVALID_STUDY_TYPE`	`studyType` is missing or isn’t `QUANT` or `AI_MODERATED_INTERVIEW`.
400	`INVALID_LOI`	`loiMinutes` is missing or isn’t a positive integer.
400	`INVALID_INCIDENCE_RATE`	`incidenceRate` is outside 1–100.
400	`INVALID_TARGET_N_SIZE`	`targetNSize` is missing or isn’t a positive integer.
400	`INVALID_FILTER_VALUE`	A filter value isn’t in the taxonomy.

{
  "audience": "CYBERSECURITY_PROFESSIONALS",
  "studyType": "QUANT",
  "loiMinutes": 15,
  "incidenceRate": 30,
  "targetNSize": 200,
  "filters": {
    "countries": ["US", "CA"],
    "employeeRanges": ["FIFTY_ONE_TO_FIVE_HUNDRED", "FIVE_HUNDRED_ONE_TO_ONE_THOUSAND"],
    "industries": ["HEALTHCARE"],
    "seniorities": ["VP", "DIRECTOR"]
  }
}

{
  "id": "4f1a9c2e7b3d4a8e9c6b2d5f8a1e3c7b",
  "expiresAt": "2026-10-28T16:12:44.207531Z",
  "audience": "CYBERSECURITY_PROFESSIONALS",
  "studyType": "QUANT",
  "loiMinutes": 15,
  "incidenceRate": 30,
  "targetNSize": 200,
  "filters": {
    "countries": ["CA", "US"],
    "employeeRanges": ["FIFTY_ONE_TO_FIVE_HUNDRED", "FIVE_HUNDRED_ONE_TO_ONE_THOUSAND"],
    "industries": ["HEALTHCARE"],
    "seniorities": ["DIRECTOR", "VP"]
  },
  "nSize": 340,
  "cpi": {
    "amount": 85.00,
    "currency": "USD"
  },
  "exampleProfiles": [
    {
      "jobTitle": "Director of Security Operations",
      "industry": "HEALTHCARE",
      "employeeRange": "FIFTY_ONE_TO_FIVE_HUNDRED",
      "country": "US",
      "seniority": "DIRECTOR"
    },
    {
      "jobTitle": "VP, Information Security",
      "industry": "HEALTHCARE",
      "employeeRange": "FIVE_HUNDRED_ONE_TO_ONE_THOUSAND",
      "country": "CA",
      "seniority": "VP"
    }
  ]
}

​Body

​Response

​Errors

Body

Response

Errors