Treasure Data Predictive Segments API

Using Treasure Data’s predictive scoring model, based on predictive segments, marketers can predict profile behavior such as who is likely to churn, purchase, click, or convert in the near future. A predictive model is a set of rules that makes it possible to predict an unmeasured value from other, known values. The form of the rules is suggested by reviewing the data collected. Training is then used to make some predictions. Predictive modeling uses statistics to predict outcomes. Predictive modeling is a typically used statistical technique to predict future behavior. Predictive modeling solutions analyze historical and current data and the generated model helps predict future outcomes. In predictive modeling, data is collected, a statistical model is formulated, predictions are made, and the model is validated (or revised) as additional data becomes available. For example, risk models can be created to combine member information in complex ways with demographic and lifestyle information from external sources to improve underwriting accuracy. Predictive models analyze past performance to assess how likely a customer is to exhibit a specific behavior in the future. This category also encompasses models that seek out subtle data patterns to answer questions about customer performance, such as fraud detection models. Predictive models often perform calculations during live transactions—for example, to evaluate the risk or opportunity of a given customer or transaction to guide a decision. Treasure Data’s predictive scoring model uses predictive segments to customize predictive scoring models for a particular segment.

Operations 21

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /audiences/{audienceId}/predictive_segments List predictive scoring models · Retrieve list of predictive scoring models #
Ask an LLM
“What predictive scoring models exist on my parent segment?”
“Where can I see all predictive segments for a parent segment?”
Tell an agent
List predictive scoring models in parent segment {audienceId}.
Show all predictive segments on parent segment {audienceId}.
POST /audiences/{audienceId}/predictive_segments Create a predictive scoring model (legacy) · Create predictive scoring model (legacy) #
Ask an LLM
“How do I set up a predictive scoring model in legacy Audience Studio?”
“Can I choose which columns a predictive model uses as features?”
Tell an agent
Create predictive model {name} in parent segment {audienceId} from base segment {baseSegmentId}.
Set up a legacy predictive model {name} in parent segment {audienceId} scoring segment {scoredSegmentId}.
GET /audiences/{audienceId}/predictive_segments/{predictiveSegmentId} Get a predictive model's statistics (legacy) · Retrieve predictive scoring model #
Ask an LLM
“Where can I see the accuracy statistics of a predictive model in legacy Audience Studio?”
“What does a single predictive scoring model report about itself under its parent segment?”
Tell an agent
Show the statistics of predictive model {predictiveSegmentId} in parent segment {audienceId}.
Get legacy predictive model {predictiveSegmentId} from audience {audienceId}.
PATCH /audiences/{audienceId}/predictive_segments/{predictiveSegmentId} Update a predictive scoring model (legacy) · Update predictive scoring model (legacy) #
Ask an LLM
“Can I change the grade thresholds on a predictive model?”
“How do I edit the feature columns of an existing predictive model?”
Tell an agent
Update grade thresholds of predictive model {predictiveSegmentId} in parent segment {audienceId} to {gradeThresholds}.
Rename predictive model {predictiveSegmentId} in parent segment {audienceId} to {name}.
DELETE /audiences/{audienceId}/predictive_segments/{predictiveSegmentId} Delete a predictive scoring model (legacy) · Delete predictive scoring model (legacy) #
Ask an LLM
“How do I delete a predictive scoring model?”
“Can I remove a predictive segment I no longer need?”
Tell an agent destructive · confirm first
Delete predictive model {predictiveSegmentId} from parent segment {audienceId}.
Remove legacy predictive segment {predictiveSegmentId} in parent segment {audienceId}.
GET /audiences/{audienceId}/predictive_segments/{predictiveSegmentId}/executions List a predictive model's runs (legacy) · Retrieve predictive scoring model executions #
Ask an LLM
“Did the last training run of my legacy predictive model succeed?”
“Which executions has a predictive model in a parent segment gone through?”
Tell an agent
List executions of predictive model {predictiveSegmentId} in parent segment {audienceId}.
Show run status history for legacy model {predictiveSegmentId} in audience {audienceId}.
GET /audiences/{audienceId}/predictive_segments/guess_rule_async Get guessed rules for a segment (legacy) · Retrieve guessed rule #
Ask an LLM
“Can Treasure Data suggest segment rules for a predictive model in legacy Audience Studio?”
“What rules does the guesser propose for a given segment in a parent segment?”
Tell an agent
Get guessed predictive rules for segment {segmentId} in parent segment {audienceId}.
Suggest rules for segment {segmentId} under audience {audienceId} using the legacy guesser.
GET /audiences/{audienceId}/predictive_segments/{predictiveSegmentId}/model/columns List columns of a predictive model (legacy) · Retrieve column list #
Ask an LLM
“Which columns does a legacy predictive model read from the parent segment?”
“Can I cap how many model columns come back?”
Tell an agent
List the columns used by predictive model {predictiveSegmentId} in parent segment {audienceId}.
Show the first {limit} columns of legacy model {predictiveSegmentId} in audience {audienceId}.
GET /audiences/{audienceId}/predictive_segments/{predictiveSegmentId}/model/features List features of a predictive model (legacy) · Retrieve column list of features #
Ask an LLM
“Which features matter most in my legacy predictive model?”
“What feature importance does a predictive model under a parent segment report?”
Tell an agent
List the features of predictive model {predictiveSegmentId} in parent segment {audienceId}.
Show the top {limit} features of legacy model {predictiveSegmentId} in audience {audienceId}.
GET /audiences/{audienceId}/predictive_segments/{predictiveSegmentId}/score_histogram Get a predictive model's score histogram · Retrieve histogram #
Ask an LLM
“What does the score distribution of my predictive model look like?”
“Can I include the positive training samples in the score histogram?”
Tell an agent
Show the score histogram of predictive model {predictiveSegmentId} in parent segment {audienceId}.
Get the histogram for model {predictiveSegmentId} in audience {audienceId} with positive training set {with_positive_train}.
POST /audiences/{audienceId}/predictive_segments/{predictiveSegmentId}/run Train a predictive scoring model (legacy) · Train predictive scoring model (legacy) #
Ask an LLM
“How do I train a predictive scoring model?”
“Can I retrain a predictive model after changing its features?”
Tell an agent
Train predictive model {predictiveSegmentId} in parent segment {audienceId}.
Retrain legacy predictive model {predictiveSegmentId} of parent segment {audienceId}.
GET /entities/segments/{id}/predictive_segments/guess_rule_async Get suggested predictive rules for a segment · Retrieve predictive scoring rules #
Ask an LLM
“Can I get suggested predictive scoring rules for a segment by its entity ID?”
“What scoring rules does the entities API guess for one segment?”
Tell an agent
Get predictive scoring rules guessed for segment {id}.
Suggest predictive rules for entities segment {id}.
POST /entities/predictive_segments Create a predictive scoring model · Create predictive scoring model #
Ask an LLM
“Can I create a predictive scoring model through the entities API?”
“What attributes define a new predictive model in the current Audience Studio?”
Tell an agent
Create a predictive scoring model with attributes {attributes}.
Create a predictive model with attributes {attributes} linked to {relationships} via the entities API.
GET /entities/predictive_segments/{id} Get a predictive scoring model by ID · Retrieve predictive scording model by ID #
Ask an LLM
“Can I fetch one predictive scoring model by its entity ID alone?”
“How is a predictive model configured, looked up by ID?”
Tell an agent
Get predictive scoring model {id}.
Show the entities-API predictive model {id}.
PATCH /entities/predictive_segments/{id} Update a predictive scoring model · Update predictive scoring model #
Ask an LLM
“Can I patch a predictive model's settings using only its ID?”
“Which attributes of an entities-API predictive model can I change?”
Tell an agent
Update predictive scoring model {id} with attributes {attributes}.
Patch entities-API predictive model {id} to {attributes}.
DELETE /entities/predictive_segments/{id} Delete a predictive scoring model · Delete predictive scoring model #
Ask an LLM
“Can I delete a predictive model by its entity ID?”
“What removes a predictive scoring model in the current Audience Studio?”
Tell an agent destructive · confirm first
Delete predictive scoring model {id}.
Remove entities-API predictive model {id}.
POST /entities/predictive_segments/{id}/run Run a predictive scoring model · Run predictive scoring model #
Ask an LLM
“Can I kick off a predictive model run by its entity ID?”
“What starts scoring for a predictive model in the current Audience Studio?”
Tell an agent
Run predictive scoring model {id}.
Start scoring with entities-API predictive model {id} now.
GET /entities/predictive_segments/{id}/executions List runs of a predictive scoring model · Retrieve executions of predictive scoring model #
Ask an LLM
“Which runs has a predictive model gone through, looked up by its entity ID?”
“Has my entities-API predictive model finished its latest execution?”
Tell an agent
List executions of predictive scoring model {id}.
Show the run history of entities-API predictive model {id}.
GET /entities/predictive_segments/{id}/model/features List features of a predictive scoring model · Retrieve features of predictive scoring model #
Ask an LLM
“Which features does a predictive model use, fetched by entity ID?”
“Can I limit how many model features the entities API returns?”
Tell an agent
List the features of predictive scoring model {id}.
Show the top {limit} features of entities-API predictive model {id}.
GET /entities/predictive_segments/{id}/model/columns List columns of a predictive scoring model · Retrieve columns of predictive scoring model #
Ask an LLM
“Which columns feed a predictive model, fetched by entity ID?”
“Can I limit how many model columns the entities API returns?”
Tell an agent
List the columns of predictive scoring model {id}.
Show {limit} columns of entities-API predictive model {id}.
GET /entities/predictive_segments/{id}/model/score Get scores of a predictive scoring model · Retrieve scores of predictive scoring model #
Ask an LLM
“What scores did a predictive model produce?”
“Can I see the scoring results of an entities-API predictive model?”
Tell an agent
Get the scores of predictive scoring model {id}.
Show the model score output for predictive model {id}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/treasure-data:treasure-data-predictive-segments-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

treasure-data-predictive-segments-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: cdp-api Predictive Segments API
  description: All of the CDP APIs are organized around REST - if you've interacted with a RESTful API already, many of the concepts will be familiar to you. All API calls to CDP API should be made to the following endpoints depending on the region. For historical reasons there are REST API endpoints and JSON:API endpoints. JSON:API endpoints are located under "/entities".
  termsOfService: https://www.treasuredata.com/terms/
  version: 1.0.0
servers:
- url: https://api-cdp.treasuredata.com
- url: https://api-cdp.treasuredata.co.jp
- url: https://api-cdp.eu01.treasuredata.com
- url: https://api-cdp.ap02.treasuredata.com
- url: https://api-cdp.ap03.treasuredata.com
tags:


# --- truncated at 32 KB (45 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/treasure-data/refs/heads/main/openapi/treasure-data-predictive-segments-api-openapi.yml