Version: 2025-12-18

Changelog

API Reference
Guide

AddedPrivate exchange CPI added to target-group-updated webhook

27 January 2026

private_exchange_cpi_change added to the target-group-updated webhook to notify when there are changes to cost per interview (CPI) for private exchanges.

Endpoints: target-group-updated webhook

Version: Added to releases from 2025-05-27 onwards.

BreakingNew Cint Exchange Demand API version 2025-12-18

18 December 2025

We're committed to continually enhancing the Cint Exchange Demand API to help you get to insights faster and more efficiently. Based on your feedback, the 2025-12-18 API version introduces improvements across design, structure, and performance.

Please use version 2025-12-18 to access the improvements outlined below.

New integration policy

The release of the Cint Exchange Demand API version 2025-12-18 introduces a new forward-only integration policy.

What is a forward-only integration

Once the 2025-12-18 version is used for a resource such as profiling, older API versions for the same resource will not be supported.

Why we are introducing this change

The new API version introduces advanced data structures, such as open-ended grouping, that are not compatible with legacy API versions. Updating a resource that has been created or modified using the newer version via older endpoints may lead to data inconsistencies, corruption, or integration errors. This policy helps preserve data integrity, ensures access to the full capabilities of the latest API version, and delivers a consistent, interchangeable experience.

What this means for you

If you begin using the Cint Exchange Demand API version 2025-12-18 for a specific resource, for example profiling, all subsequent create, write, or update operations for that resource must use the 2025-12-18 version of the API.

This approach ensures stability, data consistency, and long-term compatibility as the platform evolves.

How can you start integration?

Please contact your Cint integration consultant to learn more about our latest API version and how to enable access on your account.

Key changes

Profiling

New profiling features

Group open-ended questions. This allows multiple free-text questions to be bundled under a single group instead of completely separate items. Example: product feedback grouping two questions such as "what did you like most about the product?" and "what did you like least about the product?"
Apply a profile template to target group endpoints.
Apply a profile template combined with your own profiling setup.
Give quotas their own name using the name field to improve tracking.

Updated profiling features

Interlocked profiles are no longer a standalone object and are now part of the profiling object known as "blended profiles".
The target object is now the central piece that links questions, conditions, and quotas. Existing use of profiles will need to be refactored to accommodate the change.
Property fields have been renamed to improve clarity:
- filling_goal → completes_goal
- quota_percentage → completes_goal_percentage
- quota_nominal → completes_goal
- index → condition
- indexes → conditions
- ungrouped → target
- grouped → target
- interlocked_profiles → now specified by the ENUM value blended within profiles: []
Endpoints have been renamed:
- /apply-profiles → /manage-profiles
- /create_interlocked_profile → /create-blended-profile
- /generate-interlocked-profile → /generate-blended-profile
- /panel-distribution → /supplier-quota-distribution

Removed profiling endpoints

The endpoints below have been removed to accommodate the declarative profiles endpoint for launched target groups:

PUT https://api.cint.com/v1/demand/accounts/{account_id}/projects/{project_id}/target-groups/{target_group_id}/profiles/disable-quotas
GET https://api.cint.com/v1/demand/accounts/{account_id}/projects/{project_id}/target-groups/{target_group_id}/profiles
POST https://api.cint.com/v1/demand/accounts/{account_id}/projects/{project_id}/target-groups/{target_group_id}/profiles/:profile_id/convert-to-regular-profile
POST https://api.cint.com/v1/demand/accounts/{account_id}/projects/{project_id}/target-groups/{target_group_id}/profiles/:profile_id/group-quotas

Example: New profile markup

"profiles": [
  {
    "object": "regular",
    "id": "01JY5Q1GY7JWX1JHQH8D1W2N9Z",
    "name": "birth gender",
    "description": "¿Es usted…?",
    "description_translated": "What is your gender?",
    "quotas_enabled": true,
    "targets": [
      {
        "id": "01JY5V5NDSVHG8S3FX63Y73K3F",
        "text": "Hombre",
        "text_translated": "Male",
        "conditions": [
          {
            "object": "selection",
            "question_id": 43,
            "option": "1"
          }
        ],
        "quota": {
          "name": "SF-BirthGender-Quota-1",
          "completes_goal_percentage": 49.21,
          "completes_goal": 492,
          "completes": 0,
          "prescreens": 0
        }
      }
    ]
  }
]

Feasibility

Updated the feasibility endpoint to simplify calls by removing the requirement for project_id:

Removed: POST https://api.cint.com/v1/demand/accounts/{account_id}/projects/{project_id}/target-groups/calculate-feasibility
New endpoint: POST https://api.cint.com/v1/demand/accounts/{account_id}/target-groups/calculate-feasibility

The supplier_ids: [] within the allocations: {} object now matches its usage across other endpoints.

General improvements

Updated error messages clarify what went wrong to increase clarity.

Additional changes

human_readable_id now follows snake_case standard. Affected endpoint: GET https://api.cint.com/v1/demand/accounts/{account_id}/projects/{project_id}
Target group performance endpoint currency format updated to match all other endpoints: "completes_cost": {"value": "2.7352", "currency_code": "USD", "currency_scale": null}
client_cpi renamed to client_cost_per_interview_note to clarify it refers to a note, not the actual CPI.
pricing_model and type enum value ratecard changed to rate_card (snake_case). Affected endpoints:
- https://api.cint.com/v1/demand/accounts/{account_id}/projects/{project_id}/target-groups/{target_group_id}
- https://api.cint.com/v1/demand/accounts/{account_id}/projects/{project_id}/target-groups/{target_group_id}/overview
- https://api.cint.com/v1/demand/accounts/{account_id}/business-units/{business_unit_id}/generate-price-prediction

Deprecated endpoints and attributes

Removed feasibility endpoint (deprecated in 2025-05-27): POST https://api.cint.com/v1/demand/accounts/{account_id}/projects/{project_id}/target-groups/calculate-feasibility
Removed Exclusion endpoints (deprecated in 2025-05-27):
- GET https://api.cint.com/v1/demand/accounts/{account_id}/projects/{project_id}/target-groups/{target_group_id}/exclusions/cid
- POST https://api.cint.com/v1/demand/accounts/{account_id}/projects/{project_id}/target-groups/{target_group_id}/exclusions/cid
- GET https://api.cint.com/v1/demand/accounts/{account_id}/projects/{project_id}/target-groups/{target_group_id}/exclusions/rid
- POST https://api.cint.com/v1/demand/accounts/{account_id}/projects/{project_id}/target-groups/{target_group_id}/exclusions/rid
Removed Download Report (deprecated from 2025-05-27): GET https://api.cint.com/v1/demand/accounts/{account_id}/reports/download
Removed purchase_order_number attribute (deprecated in 2025-05-27). Affected endpoints: GET/POST/PUT project endpoints.
Removed name attribute (deprecated in 2025-05-27). Affected endpoints: target-groups endpoints.

Next steps

If you already have an existing integration, please contact your Cint integration consultant for access to the latest version of the Cint Exchange Demand API.

If you're not yet integrated with the Cint Exchange Demand API, please contact your Cint integration consultant to learn more.