We hope you enjoy our updated documentation! The old documentation website is still available here. Reach out to us with feedback or questions. Happy programming! 🎉

Get similar surveys

POST

/similar-projects

Last modified:2025-07-19 21:22:50

Description

Similar surveys helps you decide the best CPI based on previous studies with common market and audience. You will have the possibility to see the last three surveys with similar audience and check the average CPI.

The API will return the 3 most similar projects in the last 3, 6 or 9 months.

If the global query parameter is used, the AVG CPI shown is the Supplier AVG CPI + the Margin of the account. We will not show the price and the margin applied for another account.

The limits and ranges of this endpoint's criteria are customizable:

Search limit time in day/s)

Complete range ± %

LOI range ± %

IR range ± %

Time range in day/s

Please contact PureSpectrum support for any requested customization.

Request

Query Params

Body Params application/json

Example

{
    "survey_localization": "en_US",
    "completes_required": 1000,
    "expected_loi": 60,
    "expected_ir": 60,
    "field_time": 10
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://staging.spectrumsurveys.com/buyers/v2/similar-projects?global=1' \
--header 'Content-Type: application/json' \
--data-raw '{
    "survey_localization": "en_US",
    "completes_required": 1000,
    "expected_loi": 60,
    "expected_ir": 60,
    "field_time": 10
}'

Responses

🟢200Success

application/json

Body

Example

[
    {
        "cmp": 4046,
        "ps_survey_id": 1176668,
        "title": "Survey 1",
        "currency": {
            "fx": 323,
            "CR": 0.2368,
            "CRRate": 0.05,
            "ER": 0.7582,
            "symbol": "£",
            "BCPIfx": 3.59,
            "BCPI": 4.5
        },
        "epc": 0,
        "cpi": 4.5,
        "completes_required": 1000,
        "fielded": 0,
        "ir": 60,
        "loi": 60,
        "field_time": 10,
        "qualifications": [],
        "survey_closed_date": 1747692244751
    },
    {
        "cmp": 4046,
        "ps_survey_id": 1162895,
        "title": "Survey 2",
        "currency": {
            "fx": 323,
            "CR": 0.2367,
            "CRRate": 0.05,
            "ER": 0.7582,
            "symbol": "£",
            "BCPIfx": 3.59,
            "BCPI": 4.5
        },
        "epc": 0,
        "cpi": 4.5,
        "completes_required": 1000,
        "fielded": 0,
        "ir": 60,
        "loi": 60,
        "field_time": 10,
        "qualifications": [],
        "survey_closed_date": 1748766647362
    },
    {
        "cmp": 4046,
        "ps_survey_id": 1152702,
        "title": "Survey 3",
        "currency": {
            "fx": 323,
            "CR": 0.2367,
            "CRRate": 0.05,
            "ER": 0.7582,
            "symbol": "£",
            "BCPIfx": 3.59,
            "BCPI": 4.5
        },
        "epc": 5.64,
        "cpi": 4.5,
        "completes_required": 1000,
        "fielded": 0,
        "ir": 60,
        "loi": 60,
        "field_time": 10,
        "qualifications": [],
        "survey_closed_date": 1748248249327
    }
]

🟠400Bad Request

Modified at 2025-07-19 21:22:50

Create survey

Create group multi-country surveys

Get similar surveys

Description#

Request

Request Code Samples

Responses

Description