Get Data Cloud Segments for Targeting (Beta) Action

Retrieve Data Cloud segments for audience targeting in media campaigns.

This action is available in API version 68.0 and later.

Special Access Rules 

To access this action, ensure that you have the Media Cloud Base user permission set enabled.

Supported REST HTTP Methods 

URI: /services/data/v68.0/actions/standard/GetDataCloudSegmentsForTgt

Formats: JSON, XML

HTTP Methods: POST

Authentication: Authorization: Bearer TOKEN

Where TOKEN is a variable.

Inputs 

InputTypeDescription
dataSpaceIdstringOptional.
The ID of the data space to filter segments by. If blank, the default data space is used.
segmentStatusstringOptional.
The segment status to filter by. For example, ACTIVE or INACTIVE. Defaults to ACTIVE.
queryLimitintOptional.
The maximum number of segments to return.
queryOffsetintOptional.
The number of segments to skip for pagination. Defaults to 0.
startDatedateOptional.
The earliest last-modified date to include in results. Use ISO format YYYY-MM-DD.
endDatedateOptional.
The latest last-modified date to include in results. Use ISO format YYYY-MM-DD.

Outputs 

OutputTypeDescription
isSuccessbooleanIndicates whether the query was successful.
upsertedSegmentListstring array[]The IDs of the ad target segment value records that were inserted or updated.
upsertedSegmentCountintThe number of ad target segment value records that were inserted or updated.
errorMessagestringA short summary of the error. For the full error, search server logs by the reference ID.

Example 

POST

This sample request is for the Get Data Cloud Segments for Targeting (Beta) action.

1{
2  "inputs": [
3    {
4      "segmentStatus": "ACTIVE",
5      "queryLimit": 50,
6      "queryOffset": 0,
7      "startDate": "2026-01-01",
8      "endDate": "2026-08-31"
9    }
10  ]
11}

This sample response is for the Get Data Cloud Segments for Targeting (Beta) action.

1[
2  {
3    "actionName": "GetDataCloudSegmentsForTgt",
4    "errors": null,
5    "invocationId": null,
6    "isSuccess": true,
7    "outputValues": {
8      "isSuccess": true,
9      "upsertedSegmentList": ["a0xxx0000004CjrAAE"],
10      "upsertedSegmentCount": 1,
11      "errorMessage": null
12    },
13    "sortOrder": -1,
14    "version": 1
15  }
16]