Audiences

List Audiences

get

Returns all your saved audiences.

Authorizations

Bearer

AuthorizationstringRequired

Bearer token for authentication

Query parameters

pageinteger · min: 1Optional

Page number

Default: 1

sizeinteger · min: 1 · max: 100Optional

Page size

Default: 50

Responses

200

Successful Response

application/json

totalintegerRequired

pageinteger · min: 1Required

sizeinteger · min: 1Required

pagesintegerRequired

422

Validation Error

application/json

get

/audiences

HTTPcURLJavaScriptPython

GET /audiences HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "text",
      "name": "text",
      "description": "text",
      "members_count": 1,
      "filters": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "lookback_window": 1,
      "status": "text",
      "user": "text",
      "last_synced": "2026-06-06T02:11:18.839Z",
      "created_at": "2026-06-06T02:11:18.839Z",
      "updated_at": "2026-06-06T02:11:18.839Z"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 1,
  "pages": 1
}

Create Audience

post

Creates a new audience from the provided filters. Building happens asynchronously in the background — the audience will have status: queued until the build completes.

Authorizations

Bearer

AuthorizationstringRequired

Bearer token for authentication

Body

application/json

namestringRequired

A name for this audience.

descriptionany ofOptional

stringOptional

or

nullOptional

lookback_windowany ofOptional

How many days of session history to include when building the audience.

Default: 60

integer · min: 1Optional

or

nullOptional

refresh_cronany ofOptionalDefault: 55 15 * * *

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

idstringRequired

namestringRequired

descriptionany ofOptional

stringOptional

or

nullOptional

members_countany ofOptional

integerOptional

or

nullOptional

filtersany ofOptional

or

nullOptional

lookback_windowany ofOptional

integerOptional

or

nullOptional

statusany ofOptional

stringOptional

or

nullOptional

userany ofOptional

stringOptional

or

nullOptional

last_syncedany ofOptional

string · date-timeOptional

or

nullOptional

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

422

Validation Error

application/json

post

/audiences

HTTPcURLJavaScriptPython

POST /audiences HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 517

{
  "name": "text",
  "filters": {
    "visitors": [
      {
        "field": "text",
        "method": "equals",
        "value": null
      }
    ],
    "sessions": [
      {
        "field": "text",
        "method": "equals",
        "value": null
      }
    ],
    "pages": [
      {
        "field": "text",
        "method": "equals",
        "value": null
      }
    ],
    "buyer_intent": [
      {
        "field": "text",
        "method": "equals",
        "value": null
      }
    ],
    "enrichment": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "field": "text",
          "method": "equals",
          "value": null
        }
      ]
    },
    "ml": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "field": "text",
          "method": "equals",
          "value": null
        }
      ]
    }
  },
  "description": "text",
  "lookback_window": 60,
  "refresh_cron": "55 15 * * *"
}

{
  "id": "text",
  "name": "text",
  "description": "text",
  "members_count": 1,
  "filters": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "lookback_window": 1,
  "status": "text",
  "user": "text",
  "last_synced": "2026-06-06T02:11:18.839Z",
  "created_at": "2026-06-06T02:11:18.839Z",
  "updated_at": "2026-06-06T02:11:18.839Z"
}

Get Audience

get

Returns a single audience by ID, including its filters and current build status.

Authorizations

Bearer

AuthorizationstringRequired

Bearer token for authentication

Path parameters

idstringRequired

Responses

200

Successful Response

application/json

idstringRequired

namestringRequired

descriptionany ofOptional

stringOptional

or

nullOptional

members_countany ofOptional

integerOptional

or

nullOptional

filtersany ofOptional

or

nullOptional

lookback_windowany ofOptional

integerOptional

or

nullOptional

statusany ofOptional

stringOptional

or

nullOptional

userany ofOptional

stringOptional

or

nullOptional

last_syncedany ofOptional

string · date-timeOptional

or

nullOptional

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

422

Validation Error

application/json

get

/audiences/{id}

HTTPcURLJavaScriptPython

GET /audiences/{id} HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "name": "text",
  "description": "text",
  "members_count": 1,
  "filters": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "lookback_window": 1,
  "status": "text",
  "user": "text",
  "last_synced": "2026-06-06T02:11:18.839Z",
  "created_at": "2026-06-06T02:11:18.839Z",
  "updated_at": "2026-06-06T02:11:18.839Z"
}

Delete Audience

delete

Deletes an audience and all its members.

Authorizations

Bearer

AuthorizationstringRequired

Bearer token for authentication

Path parameters

idstringRequired

Responses

200

Successful Response

application/json

idstringRequired

namestringRequired

messagestringRequired

422

Validation Error

application/json

delete

/audiences/{id}

HTTPcURLJavaScriptPython

DELETE /audiences/{id} HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "name": "text",
  "message": "text"
}

Refresh Audience

post

Triggers a rebuild of the audience. Returns 400 if the audience is already syncing.

Authorizations

Bearer

AuthorizationstringRequired

Bearer token for authentication

Path parameters

idstringRequired

Responses

200

Successful Response

application/json

audience_idstringRequired

namestringRequired

statusany ofOptional

stringOptional

or

nullOptional

422

Validation Error

application/json

post

/audiences/{id}/refresh

HTTPcURLJavaScriptPython

POST /audiences/{id}/refresh HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "audience_id": "text",
  "name": "text",
  "status": "text"
}

List Audience Members

get

Returns the visitor profiles that belong to this audience.

Authorizations

Bearer

AuthorizationstringRequired

Bearer token for authentication

Path parameters

idstringRequired

Query parameters

pageinteger · min: 1Optional

Page number

Default: 1

sizeinteger · min: 1 · max: 100Optional

Page size

Default: 50

Responses

200

Successful Response

application/json

totalintegerRequired

pageinteger · min: 1Required

sizeinteger · min: 1Required

pagesintegerRequired

422

Validation Error

application/json

get

/audiences/{id}/members

HTTPcURLJavaScriptPython

GET /audiences/{id}/members HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "first_name": "text",
      "personal_city": "text",
      "married": true,
      "company_phone": "text",
      "company_sic": "text",
      "company_employee_count": "text",
      "un_processed_timestamp": 1,
      "last_name": "text",
      "personal_state": "text",
      "income_range": "text",
      "professional_address2": "text",
      "company_naics": "text",
      "primary_industry": "text",
      "un_updated_timestamp": 1,
      "business_email": "text",
      "personal_zip": "text",
      "net_worth": "text",
      "professional_city": "text",
      "company_address": "text",
      "business_email_validation_status": "text",
      "mobile_phone": "text",
      "personal_zip4": "text",
      "homeowner": true,
      "professional_state": "text",
      "company_city": "text",
      "business_email_last_seen": "2026-06-06T02:11:18.839Z",
      "hem": "text",
      "linkedin_url": "text",
      "personal_email": "text",
      "job_title": "text",
      "professional_zip": "text",
      "company_state": "text",
      "personal_email_validation_status": "text",
      "record_uuid": "text",
      "personal_address": "text",
      "personal_phone": "text",
      "seniority_level": "text",
      "professional_zip4": "text",
      "company_zip": "text",
      "personal_email_last_seen": "2026-06-06T02:11:18.839Z",
      "personal_address2": "text",
      "gender": "text",
      "department": "text",
      "company_name": "text",
      "company_linkedin_url": "text",
      "last_updated": "2026-06-06T02:11:18.839Z",
      "age_range": "text",
      "professional_address": "text",
      "company_domain": "text",
      "company_revenue": "text",
      "ip": "text",
      "last_session_date": "2026-06-06T02:11:18.839Z",
      "last_session_exit_url": "text",
      "last_session_entry_url": "text",
      "last_session_entry_referer_url": "text",
      "total_session_count": 1,
      "last_session_est_duration": 1,
      "last_session_total_pages_visited": 1,
      "lead_category": "text",
      "tag_id": "text",
      "file_type": "text"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 1,
  "pages": 1
}