Reo.dev: Reo Get Segment Buyers

List the buyers in a Reo.dev BUYER segment: name, designation, business email, LinkedIn, account ID and activity score.

Tool ID: reo_get_segment_buyers

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'reo_get_segment_buyers',
  {
    "segment_id": "123e4567-e89b-42d3-a456-426614174000"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline run reo_get_segment_buyers --input '{
  "segment_id": "123e4567-e89b-42d3-a456-426614174000"
}'

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "data": [
      {
        "id": "id_123",
        "org_id": "org_123",
        "developer_name": "Example"
      }
    ],
    "page_no": 123,
    "page_size": 123
  }
}

Use deepline describe reo_get_segment_buyers --json for the latest machine-readable contract.

Input reference

Overview Returns the list of buyers (contacts) belonging to a specific BUYER-type segment, with contact and profile details. Use the segment ID from List Segments to scope this call. ### Path Parameters | Name | Type | Required | Description | |---|---|---|---| | `segment_id` | string (UUID) | Yes | ID of a BUYER-type segment, from List Segments | ### Errors | Code | When it happens | Response body | |---|---|---| | 400 | `X-API-KEY` header missing or empty | `{"error":"Missing API Key"}` | | 403 | Invalid API key, or a write API key used on this host · Segment ID doesn’t exist · Segment isn’t BUYER type · Segment ID is malformed or empty | Bad key: `{"error":"Invalid API Key."}` · Unknown or wrong-type segment: `{"error":"Invalid Segment"}` · Malformed or empty ID: `{"error":"Invalid Segment Id."}` | ### ENUMs | Field | Value | Meaning | |---|---|---| | activity_score | `HIGH` | See the live schema below for the complete notes.

Name	Type	Required	Default	Details
`payload.segment_id`	`string`	Yes	—	ID of a BUYER-type segment, from List Segments. Format: `uuid`.
`payload.page`	`integer`	No	`1`	Page number. Defaults to 1.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.data`	`array \| null`	No	—	Result records.
`result.data.data[].id`	`string`	No	—	Buyer ID.
`result.data.data[].org_id`	`string`	No	—	Account ID of the person’s company.
`result.data.data[].developer_name`	`string`	No	—	Full name.
`result.data.data[].developer_first_name`	`string`	No	—	First name.
`result.data.data[].developer_last_name`	`string`	No	—	Last name.
`result.data.data[].developer_linkedin`	`string`	No	—	LinkedIn profile URL. Empty string when unknown.
`result.data.data[].developer_github`	`string`	No	—	GitHub profile URL. Empty string when unknown.
`result.data.data[].developer_business_email`	`string`	No	—	Business email. Empty string when unknown.
`result.data.data[].first_activity_date`	`string`	No	—	Date of the first activity, `YYYY-MM-DD`.
`result.data.data[].last_activity_date`	`string`	No	—	Date of the latest activity, `YYYY-MM-DD`.
`result.data.data[].first_activity`	`integer`	No	—	First activity timestamp, epoch milliseconds.
`result.data.data[].latest_activity_time`	`integer`	No	—	Latest activity timestamp, epoch milliseconds. Named `latest_activity` on account APIs.
`result.data.data[].tags`	`string`	No	—	Tags, as a comma-separated string. Empty string when none.
`result.data.data[].city`	`string`	No	—	City.
`result.data.data[].state`	`string`	No	—	State or region.
`result.data.data[].country`	`string`	No	—	Country.
`result.data.data[].designation`	`string`	No	—	Job title.
`result.data.data[].seniority`	`"Entry Level" \| "Architect" \| "Director" \| "VP" \| "CXO" \| "Founder"`	No	—	Seniority of the current role. See ENUMs. - `Entry Level`, `Architect`, `Director`, `VP`, `CXO`, `Founder`: Seniority of the buyer’s current role Allowed: `Entry Level`, `Architect`, `Director`, `VP`, `CXO`, `Founder`.
`result.data.data[].activity_score`	`"HIGH" \| "MEDIUM" \| "LOW"`	No	—	Activity band. See ENUMs. - `HIGH`: `activity_score_numeric` 60–100. Strong engagement, high activity levels - `MEDIUM`: `activity_score_numeric` 20–60. Moderate engagement, requires nurturing - `LOW`: `activity_score_numeric` 0–20. Minimal activity, potential drop-off risk Allowed: `HIGH`, `MEDIUM`, `LOW`.
`result.data.data[].activity_score_numeric`	`number`	No	—	Numeric activity score, 0–100. Can be a decimal.
`result.data.data[].segment_id`	`string`	No	—	ID of the segment this record belongs to.
`result.data.data[].segment_name`	`string`	No	—	Display name of the segment.
`result.data.data[].agent_tags`	`string`	No	—	Tags added by Reo Agents, as a comma-separated string. Empty string when none.
`result.data.data[].employee_count_range`	`"1-10" \| "11-50" \| "51-250" \| "251-1K" \| "1K-5K" \| "5K-10K" \| "10K-50K" \| "50K-100K" \| "100K+"`	No	—	Company headcount band. See ENUMs. - `1-10`, `11-50`, `51-250`, `251-1K`, `1K-5K`, `5K-10K`, `10K-50K`, `50K-100K`, `100K+`: Headcount band of the buyer’s company Allowed: `1-10`, `11-50`, `51-250`, `251-1K`, `1K-5K`, `5K-10K`, `10K-50K`, `50K-100K`, `100K+`.
`result.data.data[].reo_developer_link`	`string`	No	—	Deep link to the buyer on the Buyers page in Reo.
`result.data.page_no`	`integer`	No	—	Current page number.
`result.data.page_size`	`integer`	No	—	Number of records returned on this page. `0` on a page past the last one (on segment and list APIs).
`result.data.total_pages`	`integer`	No	—	Total number of pages.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation