Skip to content

Create Segment

There are two types of segments that users can upload to Blockgraph Platform:

1. Blockgraph ID (BGID) Segment

Resultant Blockgraph ID based segment can be uploaded via own identity or partner's identity.

a. Uploaded segment using node's own identity

Supported Signals in the data file

  • Household ID (Record ID)
  • Blockgraph ID
  • Postal Address
  • IP Address
  • Email address
  • IDFA
  • AAID
  • STB IDs
API Sequence to Create a Segment
  1. Load Segment File:
    • For files up to 150MB: Use POST file API
    • For files larger than 150MB: Upload directly to the provided S3 bucket (contact support for bucket details and credentials)
  2. Validate that this file was loaded via GET file API
  3. Create segment via POST Segment API
  4. Monitor job status to verify that it's completed via GET Jobs API

b. Upload segment using partner's identity

Supported Signals in the data file

  • Postal Address
  • IP Address
  • Email address
  • IDFA
  • AAID
  • STB IDs
API Sequence to Create a Lookup Segment
  1. Load Segment File:
    • For files up to 150MB: Use POST file API
    • For files larger than 150MB: Upload directly to the provided S3 bucket (contact support for bucket details and credentials)
  2. Validate that this file was loaded via GET file API
  3. Get Partner ID GET Partners API
  4. Create segment via POST Segment API
  5. Monitor job status to verify that it's completed via GET Jobs API

2. Segment of Hashed Signals

Resultant segment of Hashed Signals can be uploaded to nodes that do not have identity.

Supported Signals

  • Postal Address
  • IP Address
  • Email address
  • IDFA
  • AAID
  • STB ID
API Sequence to Create a Segment
  1. Load Segment File:
    • For files up to 150MB: Use POST file API
    • For files larger than 150MB: Upload directly to the provided S3 bucket (contact support for bucket details and credentials)
  2. Validate that this file was loaded via GET file API
  3. Create segment via POST Segment API
  4. Monitor job status to verify that it's completed via GET Jobs API