Developer APIs

No auth required. Accepts username or email and password.

Request body

{
  "username": "your_username",
  "password": "your_password"
}

Response data

{
  "authToken": "00000000-0000-0000-0000-000000000000",
  "userId": 123,
  "userName": "creator",
  "email": "[email protected]",
  "publicUrl": "creator"
}

Lists all channels owned by the authenticated user, each including its video library and any platform-specific VAST ad settings that have been configured.

Example response

{
  "success": true,
  "data": [
    {
      "channelTubeId": 42,
      "name": "Main Channel",
      "url": "main-channel",
      "categoryName": "Entertainment",
      "pictureUrl": "https://cdn.example.com/tubestrimm/123/channel.jpg",
      "description": "My flagship channel.",
      "order": 1,
      "videos": [
        {
          "videoTubeId": 1001,
          "title": "Intro to the Network",
          "description": "A quick overview.",
          "durationSeconds": 185.5,
          "thumbnailUrl": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
          "providerVideoId": "dQw4w9WgXcQ",
          "providerName": "YouTube",
          "categoryName": "Promo"
        },
        {
          "videoTubeId": 1002,
          "title": "Behind the Scenes",
          "description": null,
          "durationSeconds": 612,
          "thumbnailUrl": "https://cdn.example.com/tubestrimm/123/thumb.jpg",
          "providerVideoId": "abc123",
          "providerName": "Custom",
          "categoryName": "Documentary"
        }
      ],
      "vastSettings": [
        {
          "platform": "web",
          "vastUrl": "https://ads.example.com/vast?channel=42&platform=web",
          "vastVersion": 1,
          "skippable": true,
          "adFrequency": 1,
          "midRollFrequency": 10,
          "slottable": false,
          "timeFrom": null,
          "timeTo": null,
          "vastType": "fullscreen",
          "allowAdsInVod": false
        },
        {
          "platform": "roku",
          "vastUrl": "https://ads.example.com/vast?channel=42&platform=roku",
          "vastVersion": 1,
          "skippable": false,
          "adFrequency": 1,
          "midRollFrequency": 0,
          "slottable": true,
          "timeFrom": 18,
          "timeTo": 23,
          "vastType": "fullscreen",
          "allowAdsInVod": false
        }
      ]
    },
    {
      "channelTubeId": 58,
      "name": "Kids Corner",
      "url": "kids-corner",
      "categoryName": "Kids",
      "pictureUrl": null,
      "description": null,
      "order": 2,
      "videos": [],
      "vastSettings": []
    }
  ]
}

Lists the channels the current user has favorited, most recently favorited first.

Example request

GET /api/v1/rest/favorites
Authorization: Bearer {authToken}

Example response

{
  "success": true,
  "data": [
    {
      "channelTubeId": 42,
      "name": "Main Channel",
      "url": "main-channel",
      "categoryName": "Entertainment",
      "pictureUrl": "https://cdn.example.com/tubestrimm/123/channel.jpg",
      "description": "My flagship channel.",
      "favoritedAt": "2026-06-23T09:15:00Z"
    },
    {
      "channelTubeId": 58,
      "name": "Kids Corner",
      "url": "kids-corner",
      "categoryName": "Kids",
      "pictureUrl": null,
      "description": null,
      "favoritedAt": "2026-06-20T18:02:11Z"
    }
  ]
}

When the user has no favorites, data is an empty array.

Adds a channel to the current user's favorites. The call is idempotent — favoriting a channel that is already a favorite still returns success. Returns channel_not_found when the channel id does not exist or has been deleted.

Example request

POST /api/v1/rest/favorites/42
Authorization: Bearer {authToken}

Example response

{
  "success": true,
  "data": {
    "channelTubeId": 42,
    "isFavorite": true
  }
}

No auth required. Accepts email (or username) and password.

{
  "email": "[email protected]",
  "password": "your_password"
}

{
  "data": {
    "access_token": "00000000-0000-0000-0000-000000000000",
    "token_type": "bearer",
    "expires_in": 3600
  }
}

Bearer required. Revokes the current token and returns a new one.

Bearer required.

{
  "data": {
    "id": 123,
    "full_name": "Jane Creator",
    "public_name": "creator",
    "publicUrl": "creator",
    "email": "[email protected]"
  }
}

White-label web/app branding from UserCustomApps, or mobile app colors when configured.

{
  "data": {
    "user_id": 123,
    "title": "My Network",
    "hex1": "#EF4E32",
    "hex2": "#091221",
    "hex3": "#102944",
    "fontColor": "#EAE9F9",
    "header_background": "white",
    "FAQ": "...",
    "PrivacyPolicy": "https://example.com/privacy",
    "logo_header": "{base64}",
    "logo_android": "{base64}",
    "useVastSettings": false
  }
}

App record from Studio → Apps for the calling platform. The Platform-Id header is required: ios / android / mobile, roku, fire-tv, apple-tv or android-tv (the legacy Platform header is still accepted). It selects which app record and store product IDs are returned; a missing or unknown value returns HTTP 422 with errors.platform_id instead of silently falling back to the mobile app.

{
  "data": {
    "user_id": 123,
    "slug": "my-network",
    "app_name": "My Network App",
    "hex1": "#FF5722",
    "hex2": "#212121",
    "hex3": "#000000",
    "fontColor": "#FFFFFF",
    "Logo": "{base64}",
    "Icon": "{base64}",
    "privacy_policy_link": "https://example.com/privacy",
    "about": "Welcome.",
    "platform": "Mobile",
    "app_id": "7",
    "is_paid": true,
    "store_product_id": "com.yourbrand.app.weekly",
    "store_products": [
      {
        "product_id": "com.yourbrand.app.weekly",
        "billing_period": "Weekly",
        "display_name": "Weekly access"
      },
      {
        "product_id": "com.yourbrand.app.monthly",
        "billing_period": "Monthly",
        "display_name": "Monthly access"
      },
      {
        "product_id": "com.yourbrand.app.yearly",
        "billing_period": "Yearly",
        "display_name": "Yearly access"
      }
    ],
    "vod_ppv_enabled": true,
    "vod_ppv_store_product_id": "com.yourbrand.app.vod",
    "vod_ppv_access_hours": 48
  }
}

is_paid gates app-wide access via the subscription endpoints. store_products lists every configured subscription for this client store; store_product_id is the primary/first id (compat). When vod_ppv_enabled is true, each VOD video requires a separate one-time purchase (vod_ppv_store_product_id) that unlocks that video for vod_ppv_access_hours.

TV apps. With Platform-Id: roku, fire-tv, apple-tv or android-tv the same shape carries that app's record. The color slots map to the TV theme roles edited in Studio → Apps: hex1 = primary, hex2 = secondary, hex3 = background, fontColor = style. Roku additionally returns ad_link (the optional app-level VAST tag) and reads these settings on every launch, so a color change reaches installed channels without a rebuild.

GET /api/v1/services/custom/users/123/app_settings
Platform-Id: roku
Device-Id: device-unique-id

{
  "data": {
    "user_id": 123,
    "slug": "My Network",
    "app_name": "My Network",
    "hex1": "#E17600",
    "hex2": "#BBBBBB",
    "hex3": "#000000",
    "fontColor": "#FFFFFF",
    "Logo": "",
    "Icon": "",
    "privacy_policy_link": "https://example.com/privacy",
    "about": "Welcome to my channel network.",
    "platform": "Roku",
    "app_id": "2",
    "is_paid": false,
    "store_product_id": null,
    "vod_ppv_enabled": false,
    "vod_ppv_store_product_id": null,
    "vod_ppv_access_hours": 48,
    "vod_ppv_preview_seconds": 0,
    "store_products": [],
    "time_format": "12-hour",
    "ad_link": null
  }
}

Channel categories for filters. Pass default=1 to omit nested channels.

Channels scheduled for today. Send Platform: mobile to limit to channels assigned in the mobile app. Query params: language_id, category_id (comma-separated; 999 = live only), search, skip, take, newest, oldest, most_subscribed.

GET /api/v1/services/custom/users/creator/channels?skip=0&take=20
Platform: mobile
timezone: America/New_York

{
  "data": [
    {
      "id": 42,
      "categoryId": 3,
      "userId": 123,
      "name": "Main Channel",
      "url": "main-channel",
      "pictureUrl": "https://cdn.example.com/.../channel.jpg",
      "isWhiteLabeled": 1,
      "playLiveFirst": false,
      "privateChannel": false,
      "isVerified": true,
      "liveAvailable": true,
      "guideMode": "fixed",
      "keepGuideOpened": 0,
      "vodAvailable": true,
      "scheduleAvailable": true
    }
  ]
}

vodAvailable is true when the channel has at least one linked VOD catalog video. scheduleAvailable is true when the channel has a published linear schedule for today (request timezone). Apps use these flags to show a VOD mode toggle and to keep VOD-only channels in the list even when they have no schedule for today.

Scheduled videos for one or more channels and dates. Required query: channels_ids (comma-separated), dates (comma-separated; yyyy-MM-dd, or the compact yyyyMMdd / yyyyMMddHHmmss forms — any time part is ignored, schedules resolve per calendar day). Optional: page, per_page, timezone.

GET /api/v1/services/custom/users/creator/channels/video?channels_ids=42,58&dates=2026-06-04&page=1&per_page=6

{
  "data": [
    {
      "customId": "42-1001-1",
      "videoTubeId": 1001,
      "userId": 123,
      "title": "Morning Show",
      "providerVideoId": "dQw4w9WgXcQ",
      "channelId": 42,
      "duration": 1800,
      "timeDuration": "0h. 30min",
      "startDate": "2026-06-04 06:00:00",
      "endDate": "2026-06-04 06:30:00",
      "providerName": "YouTube",
      "durationInDate": "6:00am-6:30am",
      "thumbnail": "https://i.ytimg.com/vi/.../hqdefault.jpg",
      "streamUrl": null,
      "isVod": false
    }
  ],
  "links": { "first": null, "last": null, "prev": null, "next": null },
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 6,
    "total": 1
  }
}

Note: this endpoint returns the paginated object at the top level (data / links / meta), not wrapped in an extra { data } envelope. isVod is always false for schedule rows.

On-demand (VOD) catalog for one or more channels. Same paginated shape as /users/{id}/channels/video. Required query: channels_ids (comma-separated). Optional: page, per_page (default 50).

GET /api/v1/services/custom/users/creator/channels/vod?channels_ids=42&page=1&per_page=50
Platform-Id: ios
Device-Id: device-unique-id

{
  "data": [
    {
      "customId": "42-2001-vod",
      "videoTubeId": 2001,
      "userId": 123,
      "title": "Highlight Reel",
      "providerVideoId": "987654321",
      "channelId": 42,
      "duration": 720,
      "timeDuration": "0h. 12min",
      "startDate": "2026-06-04 00:00:00",
      "endDate": "2026-06-04 00:12:00",
      "providerName": "Vimeo",
      "durationInDate": "0:00-0:12",
      "thumbnail": "https://cdn.example.com/.../thumb.jpg",
      "streamUrl": "https://player.vimeo.com/...",
      "isVod": true
    }
  ],
  "links": { "first": null, "last": null, "prev": null, "next": null },
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 50,
    "total": 1
  }
}

Apps should render timeDuration (not schedule start/end) when isVod is true. When app VOD PPV is enabled, unlock each videoTubeId via the VOD PPV endpoints before playback.

Returns cached Vimeo progressive playback renditions for a video. Used by TV/app clients to pick the best width (1280 / 960 / 640 / 426) for direct playback. Non-expired renditions are returned when available; otherwise every cached rendition is returned so the client can still attempt playback.

GET /api/v1/services/custom/token_by_video/1001

{
  "data": [
    {
      "url": "https://vod-progressive.akamaized.net/.../video-1280.mp4",
      "expiration_date": "2026-06-08T18:30:00Z",
      "width": "1280",
      "height": "720"
    },
    {
      "url": "https://vod-progressive.akamaized.net/.../video-640.mp4",
      "expiration_date": "2026-06-08T18:30:00Z",
      "width": "640",
      "height": "360"
    }
  ]
}

Returns { "data": [] } when no cached renditions exist for the video (e.g. non-Vimeo providers, which are played directly via providerVideoId).

Live-stream videos scheduled on a channel for the given day. When date is omitted the current UTC date is used. Times are formatted yyyy-MM-dd HH:mm:ss.

GET /api/v1/services/custom/users/creator/channels/42/live?date=2026-06-08

{
  "data": [
    {
      "videoTubeId": 5001,
      "channelId": "42",
      "startDate": "2026-06-08 19:00:00",
      "endDate": "2026-06-08 20:00:00",
      "description": "Live keynote",
      "timeDuration": "1h. 0min",
      "isPrivate": false,
      "IsRRated": false,
      "isRemovedByProvider": false,
      "isRestrictedByProvider": false,
      "providerVideoId": "987654321",
      "thumbnail": "https://cdn.example.com/.../live.jpg",
      "title": "Evening Live",
      "uri": "",
      "providerName": "Vimeo",
      "live": true
    }
  ]
}

Lists the channels the user has favorited, most recently favorited first. Each item uses the same channel shape as /users/{id}/channels with marked set to true.

GET /api/v1/services/custom/users/creator/app/favorites

{
  "data": [
    {
      "id": 42,
      "name": "Creator Channel",
      "url": "creator-channel",
      "pictureUrl": "https://cdn.example.com/.../channel.jpg",
      "liveAvailable": true,
      "marked": true
    }
  ]
}

When the user has no favorites, data is an empty array.

Whether the device/viewer is entitled to a paid app. When the app is not marked paid, entitled is true and isPaidApp is false.

{
  "data": {
    "entitled": true,
    "status": "active",
    "expiresUtc": "2026-09-01T12:00:00Z",
    "isPaidApp": true,
    "storeProductId": "com.yourbrand.app.weekly",
    "storeProductIds": [
      "com.yourbrand.app.weekly",
      "com.yourbrand.app.monthly",
      "com.yourbrand.app.yearly"
    ]
  }
}

Verifies a store subscription receipt / purchase token and records entitlement for the device (and viewer when authenticated). product_id must be one of the configured subscription Product IDs for that store (any billing period).

{
  "store_platform": "Apple",
  "product_id": "com.yourbrand.app.monthly",
  "receipt_data": "{transaction-receipt-or-purchase-token}",
  "original_transaction_id": "1000000123456789",
  "device_id": "device-unique-id"
}

{
  "data": {
    "ok": true,
    "entitled": true,
    "error": null,
    "expiresUtc": "2026-09-01T12:00:00Z"
  }
}

Restores entitlement from known original transaction ids (and/or device history). Same result shape as verify.

{
  "store_platform": "Apple",
  "device_id": "device-unique-id",
  "original_transaction_ids": ["1000000123456789"]
}

Per-video unlock status for app-level VOD pay-per-view. When VOD PPV is disabled for the app, unlocked is true and vodPpvEnabled is false. channel_tube_id is optional: the app-level switch says the app sells unlocks, the channel's Pay-Per-View setting says which videos need one, so pass the channel the video is being watched from when the same video appears in several channels.

GET /api/v1/services/custom/users/creator/apps/vod_ppv/status?video_tube_id=2001
Platform-Id: ios
Device-Id: device-unique-id

{
  "data": {
    "vodPpvEnabled": true,
    "unlocked": false,
    "expiresUtc": null,
    "storeProductId": "com.yourbrand.app.vod",
    "accessDurationHours": 48
  }
}

No auth required. Accepts application/json or application/x-www-form-urlencoded bodies. Also reachable at the legacy-compatible path https://strimm.com/api/v1/activity (same handler) for clients that kept the old URL shape and only swap the host.

Request body

{
  "source": "android_tv",
  "action": "play_channel",
  "client_id": "123",
  "channel_id": "42",
  "user_id": "device-id-or-viewer-id"
}

Fields

Response (HTTP 200)

{
  "message": "Success"
}

Note: for compatibility with the legacy analytics contract this endpoint returns a bare { "message" } object, not the { data } envelope used by the rest of the Custom API.

Watch-session heartbeats

While a channel is playing, post a play_channel event every 60 seconds. The server folds consecutive heartbeats with the same source + client_id + user_id + channel_id into one watch session, extending its end time on each heartbeat. If no heartbeat arrives for more than 3 minutes the session is closed and its duration recorded (minimum 60 seconds credited); the next heartbeat starts a new session.

Whether a channel is included in the account's Roku app.

Example response (JSON inside the XML envelope)

{
  "ChannelTubeId": 42,
  "AddedToRoku": true,
  "LastUpdateDate": "2024-01-22T12:56:28"
}