# Focus · YouTube API

> Typed Focus mode operations for YouTube accounts, generated from the YouTube focus module (same behaviour as the generic /accounts/{accountId}/focus routes).

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## YouTube: Get Channel dashboard

`GET /accounts/{accountId}/youtube/channel-dashboard`

Channel stats + 28-day totals + latest 5 uploads with analytics · quota: 3 units + 3 analytics queries (channels.list, playlistItems.list, videos.list, analytics.reports.query). Channel stats, last 28 days, latest uploads with their performance. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels/list Generic route: /v1/accounts/{accountId}/focus/channel-dashboard.

Access: `read` · MCP tool: `youtube-channel-dashboard-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date))
- `until` (string (date))

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-dashboard" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "channel": {
    "id": "string",
    "title": "string",
    "thumbnail_url": "https://example.com",
    "subscriber_count": 1,
    "view_count": 1,
    "video_count": 1
  },
  "period": {
    "since": "string",
    "until": "string"
  },
  "totals": {
    "key": 1.5
  },
  "latest_videos": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "tags": [
        "string"
      ],
      "category_id": "string",
      "default_language": "string",
      "default_audio_language": "string",
      "privacy_status": "public",
      "publish_at": "2026-10-13T09:00:00.000Z",
      "is_scheduled": true,
      "self_declared_made_for_kids": true,
      "made_for_kids": true,
      "contains_synthetic_media": true,
      "has_paid_product_placement": true,
      "license": "youtube",
      "embeddable": true,
      "public_stats_viewable": true,
      "recording_date": "2026-10-13T09:00:00.000Z",
      "thumbnail_url": "https://example.com",
      "published_at": "2026-10-13T09:00:00.000Z",
      "upload_status": "uploaded",
      "failure_reason": "string",
      "rejection_reason": "string",
      "processing_status": "string",
      "duration_seconds": 1,
      "definition": "string",
      "caption": true,
      "has_custom_thumbnail": true,
      "is_short": true,
      "is_live": true
    }
  ],
  "top_videos": [
    {
      "video": "string",
      "views": 1.5,
      "estimatedMinutesWatched": 1.5
    }
  ],
  "analytics_error": "string"
}
```

## YouTube: Get API quota

`GET /accounts/{accountId}/youtube/quota`

Quota buckets and cost table (no API call) · quota: none (no API call). YouTube Data API quota: per-project daily buckets and per-operation costs. Usage comes from ctx.quota.usage() when the API meters it. Network docs: https://developers.google.com/youtube/v3/determine_quota_cost Generic route: /v1/accounts/{accountId}/focus/quota.

Access: `read` · MCP tool: `youtube-quota-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/quota" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "resets_at": "2026-10-13T09:00:00.000Z",
  "buckets": [
    {
      "bucket": "string",
      "limit": 1,
      "used": 1,
      "remaining": 1
    }
  ],
  "costs": [
    {
      "operation": "string",
      "units": 1,
      "bucket": "string"
    }
  ]
}
```

## YouTube: List Activity feed

`GET /accounts/{accountId}/youtube/activities`

Channel activities · quota: 1 unit (activities.list). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/activities/list Generic route: /v1/accounts/{accountId}/focus/activities.

Access: `read` · MCP tool: `youtube-activities-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–50)
- `cursor` (string)
- `published_after` (string (date-time))
- `published_before` (string (date-time))

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/activities" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "type": "string",
      "title": "string",
      "published_at": "2026-10-13T09:00:00.000Z",
      "video_id": "string",
      "playlist_id": "string",
      "thumbnail_url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: List Videos

`GET /accounts/{accountId}/youtube/videos`

List uploads (uploads playlist + videos.list per page; q= uses search.list) · quota: 2 units (playlistItems.list, videos.list). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.

Access: `read` · MCP tool: `youtube-videos-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–50)
- `cursor` (string)
- `filter` (string; one of all, public, unlisted, private, scheduled, shorts, videos, live, processing, failed)
- `q` (string): Search own videos (uses the 100/day search bucket)
- `order` (string; one of date, rating, relevance, title, viewCount)
- `scan_pages` (integer; 1–10): Scan several pages for sparse filters

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "tags": [
        "string"
      ],
      "category_id": "string",
      "default_language": "string",
      "default_audio_language": "string",
      "privacy_status": "public",
      "publish_at": "2026-10-13T09:00:00.000Z",
      "is_scheduled": true,
      "self_declared_made_for_kids": true,
      "made_for_kids": true,
      "contains_synthetic_media": true,
      "has_paid_product_placement": true,
      "license": "youtube",
      "embeddable": true,
      "public_stats_viewable": true,
      "recording_date": "2026-10-13T09:00:00.000Z",
      "thumbnail_url": "https://example.com",
      "published_at": "2026-10-13T09:00:00.000Z",
      "upload_status": "uploaded",
      "failure_reason": "string",
      "rejection_reason": "string",
      "processing_status": "string",
      "duration_seconds": 1,
      "definition": "string",
      "caption": true,
      "has_custom_thumbnail": true,
      "is_short": true,
      "is_live": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Videos item

`POST /accounts/{accountId}/youtube/videos`

Upload a video (resumable) + optional thumbnail/playlists/captions/first comment · quota: 1 videos.insert bucket (videos.insert). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.

Access: `write` · MCP tool: `youtube-videos-create` · Zernio: `POST /v1/posts/{postId}/update-metadata`, `POST /v1/posts/{postId}/edit`, `POST /v1/posts/{postId}/unpublish`, `POST /v1/inbox/posts/{postId}/like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `media` (string; required): Video file (≤256 GB / 12 h)
- `title` (string; required; ≤ 100 characters)
- `description` (string; ≤ 5000 characters)
- `privacy_status` (string; required; one of public, unlisted, private)
- `publish_at` (string (date-time)): Schedule: uploads as private, released publicly at this time
- `self_declared_made_for_kids` (boolean; required)
- `tags` (array of string)
- `category_id` (string)
- `default_language` (string)
- `default_audio_language` (string)
- `localizations` (object): BCP-47 language → { title, description }
- `contains_synthetic_media` (boolean)
- `has_paid_product_placement` (boolean)
- `license` (string; one of youtube, creativeCommon)
- `embeddable` (boolean)
- `public_stats_viewable` (boolean)
- `notify_subscribers` (boolean)
- `recording_date` (string (date-time))
- `is_short` (boolean): Override Shorts detection
- `add_shorts_hashtag` (boolean)
- `thumbnail` (string)
- `playlist_ids` (array of string)
- `captions` (array of object)
  - `captions[].media` (string)
  - `captions[].language` (string)
  - `captions[].name` (string; ≤ 150 characters)
  - `captions[].is_draft` (boolean)
- `first_comment` (string; ≤ 10000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media": "string",
    "title": "string",
    "description": "string",
    "privacy_status": "private",
    "self_declared_made_for_kids": true
  }'
```

Response 201:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "tags": [
    "string"
  ],
  "category_id": "string",
  "default_language": "string",
  "default_audio_language": "string",
  "privacy_status": "public",
  "publish_at": "2026-10-13T09:00:00.000Z",
  "is_scheduled": true,
  "self_declared_made_for_kids": true,
  "made_for_kids": true,
  "contains_synthetic_media": true,
  "has_paid_product_placement": true,
  "license": "youtube",
  "embeddable": true,
  "public_stats_viewable": true,
  "recording_date": "2026-10-13T09:00:00.000Z",
  "thumbnail_url": "https://example.com",
  "published_at": "2026-10-13T09:00:00.000Z",
  "upload_status": "uploaded",
  "failure_reason": "string",
  "rejection_reason": "string",
  "processing_status": "string",
  "duration_seconds": 1,
  "definition": "string",
  "caption": true,
  "has_custom_thumbnail": true,
  "is_short": true,
  "is_live": true,
  "view_count": 1,
  "like_count": 1,
  "comment_count": 1,
  "width": 1,
  "height": 1,
  "localizations": {
    "key": {
      "title": "string",
      "description": "string"
    }
  },
  "url": "https://example.com",
  "studio_url": "https://example.com"
}
```

## YouTube: Get a Videos item

`GET /accounts/{accountId}/youtube/videos/{itemId}`

Video details (all owner parts) · quota: 1 unit (videos.list). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.

Access: `read` · MCP tool: `youtube-videos-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "tags": [
    "string"
  ],
  "category_id": "string",
  "default_language": "string",
  "default_audio_language": "string",
  "privacy_status": "public",
  "publish_at": "2026-10-13T09:00:00.000Z",
  "is_scheduled": true,
  "self_declared_made_for_kids": true,
  "made_for_kids": true,
  "contains_synthetic_media": true,
  "has_paid_product_placement": true,
  "license": "youtube",
  "embeddable": true,
  "public_stats_viewable": true,
  "recording_date": "2026-10-13T09:00:00.000Z",
  "thumbnail_url": "https://example.com",
  "published_at": "2026-10-13T09:00:00.000Z",
  "upload_status": "uploaded",
  "failure_reason": "string",
  "rejection_reason": "string",
  "processing_status": "string",
  "duration_seconds": 1,
  "definition": "string",
  "caption": true,
  "has_custom_thumbnail": true,
  "is_short": true,
  "is_live": true,
  "view_count": 1,
  "like_count": 1,
  "comment_count": 1,
  "width": 1,
  "height": 1,
  "localizations": {
    "key": {
      "title": "string",
      "description": "string"
    }
  },
  "url": "https://example.com",
  "studio_url": "https://example.com"
}
```

## YouTube: Update a Videos item

`PATCH /accounts/{accountId}/youtube/videos/{itemId}`

Update metadata (read-modify-write) · quota: 51 units (videos.list, videos.update). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.

Access: `write` · MCP tool: `youtube-videos-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `title` (string; ≤ 100 characters)
- `description` (string; ≤ 5000 characters)
- `tags` (array of string)
- `category_id` (string)
- `default_language` (string)
- `default_audio_language` (string)
- `privacy_status` (string; one of public, unlisted, private)
- `publish_at` (string (date-time) | null)
- `self_declared_made_for_kids` (boolean)
- `contains_synthetic_media` (boolean)
- `has_paid_product_placement` (boolean)
- `license` (string; one of youtube, creativeCommon)
- `embeddable` (boolean)
- `public_stats_viewable` (boolean)
- `recording_date` (string (date-time) | null)
- `localizations` (object): BCP-47 language → { title, description }
- `brand_partner` (object)
  - `brand_partner.channel_id` (string; pattern ^UC)
  - `brand_partner.channel_handle` (string; pattern ^@)
- `thumbnail` (string): New custom thumbnail (JPEG/PNG ≤50 MB)
- `playlist_id` (string): Also add to this playlist

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "tags": [
      "string"
    ],
    "category_id": "string",
    "default_language": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "tags": [
    "string"
  ],
  "category_id": "string",
  "default_language": "string",
  "default_audio_language": "string",
  "privacy_status": "public",
  "publish_at": "2026-10-13T09:00:00.000Z",
  "is_scheduled": true,
  "self_declared_made_for_kids": true,
  "made_for_kids": true,
  "contains_synthetic_media": true,
  "has_paid_product_placement": true,
  "license": "youtube",
  "embeddable": true,
  "public_stats_viewable": true,
  "recording_date": "2026-10-13T09:00:00.000Z",
  "thumbnail_url": "https://example.com",
  "published_at": "2026-10-13T09:00:00.000Z",
  "upload_status": "uploaded",
  "failure_reason": "string",
  "rejection_reason": "string",
  "processing_status": "string",
  "duration_seconds": 1,
  "definition": "string",
  "caption": true,
  "has_custom_thumbnail": true,
  "is_short": true,
  "is_live": true,
  "view_count": 1,
  "like_count": 1,
  "comment_count": 1,
  "width": 1,
  "height": 1,
  "localizations": {
    "key": {
      "title": "string",
      "description": "string"
    }
  },
  "url": "https://example.com",
  "studio_url": "https://example.com"
}
```

## YouTube: Delete a Videos item

`DELETE /accounts/{accountId}/youtube/videos/{itemId}`

Delete permanently · quota: 50 units (videos.delete). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.

Access: `write` · MCP tool: `youtube-videos-delete` · Zernio: `DELETE /v1/inbox/posts/{postId}/like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: Rate (Videos)

`POST /accounts/{accountId}/youtube/videos/{itemId}/rate`

Like, dislike or clear rating · quota: 50 units (videos.rate). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.

Access: `write` · MCP tool: `youtube-videos-rate`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `rating` (string; required; one of like, dislike, none)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos/ITEM_ID/rate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "rating": "like"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: My rating (Videos)

`POST /accounts/{accountId}/youtube/videos/{itemId}/rating`

Read the channel’s rating · quota: 1 unit (videos.getRating). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.

Access: `write` · MCP tool: `youtube-videos-rating`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos/ITEM_ID/rating" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Set thumbnail (Videos)

`POST /accounts/{accountId}/youtube/videos/{itemId}/set-thumbnail`

Upload a custom thumbnail (JPEG/PNG ≤50 MB) · quota: 50 units (thumbnails.set). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.

Access: `write` · MCP tool: `youtube-videos-set-thumbnail`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `media` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos/ITEM_ID/set-thumbnail" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Add to playlist (Videos)

`POST /accounts/{accountId}/youtube/videos/{itemId}/add-to-playlist`

Insert into a playlist · quota: 50 units (playlistItems.insert). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.

Access: `write` · MCP tool: `youtube-videos-add-to-playlist`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `playlist_id` (string; required)
- `position` (integer)
- `note` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos/ITEM_ID/add-to-playlist" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "playlist_id": "string",
    "position": 0,
    "note": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Change visibility (Videos)

`POST /accounts/{accountId}/youtube/videos/{itemId}/set-visibility`

Set privacy (clears schedule unless private) · quota: 51 units (videos.list, videos.update). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.

Access: `write` · MCP tool: `youtube-videos-set-visibility`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `privacy_status` (string; required; one of public, unlisted, private)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos/ITEM_ID/set-visibility" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "privacy_status": "public"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Publish now (Videos)

`POST /accounts/{accountId}/youtube/videos/{itemId}/publish-now`

Make public immediately · quota: 51 units (videos.list, videos.update). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.

Access: `write` · MCP tool: `youtube-videos-publish-now`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos/ITEM_ID/publish-now" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Schedule (Videos)

`POST /accounts/{accountId}/youtube/videos/{itemId}/schedule`

Set status.publishAt (video becomes private until then) · quota: 51 units (videos.list, videos.update). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.

Access: `write` · MCP tool: `youtube-videos-schedule`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `publish_at` (string (date-time); required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos/ITEM_ID/schedule" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "publish_at": "2026-10-13T09:00:00.000Z"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Processing status (Videos)

`POST /accounts/{accountId}/youtube/videos/{itemId}/processing-status`

Upload/processing state, failure and rejection reasons · quota: 1 unit (videos.list). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.

Access: `write` · MCP tool: `youtube-videos-processing-status`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos/ITEM_ID/processing-status" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Shorts

`GET /accounts/{accountId}/youtube/shorts`

List Shorts (scans 3 upload pages by default) · quota: 2 units (playlistItems.list, videos.list). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.

Access: `read` · MCP tool: `youtube-shorts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–50)
- `cursor` (string)
- `scan_pages` (integer; 1–10)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/shorts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "tags": [
        "string"
      ],
      "category_id": "string",
      "default_language": "string",
      "default_audio_language": "string",
      "privacy_status": "public",
      "publish_at": "2026-10-13T09:00:00.000Z",
      "is_scheduled": true,
      "self_declared_made_for_kids": true,
      "made_for_kids": true,
      "contains_synthetic_media": true,
      "has_paid_product_placement": true,
      "license": "youtube",
      "embeddable": true,
      "public_stats_viewable": true,
      "recording_date": "2026-10-13T09:00:00.000Z",
      "thumbnail_url": "https://example.com",
      "published_at": "2026-10-13T09:00:00.000Z",
      "upload_status": "uploaded",
      "failure_reason": "string",
      "rejection_reason": "string",
      "processing_status": "string",
      "duration_seconds": 1,
      "definition": "string",
      "caption": true,
      "has_custom_thumbnail": true,
      "is_short": true,
      "is_live": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Shorts item

`POST /accounts/{accountId}/youtube/shorts`

Upload a Short (vertical, ≤3 min) · quota: 1 videos.insert bucket (videos.insert). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.

Access: `write` · MCP tool: `youtube-shorts-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `media` (string; required): Video file (≤256 GB / 12 h)
- `title` (string; required; ≤ 100 characters)
- `description` (string; ≤ 5000 characters)
- `privacy_status` (string; required; one of public, unlisted, private)
- `publish_at` (string (date-time)): Schedule: uploads as private, released publicly at this time
- `self_declared_made_for_kids` (boolean; required)
- `tags` (array of string)
- `category_id` (string)
- `default_language` (string)
- `default_audio_language` (string)
- `localizations` (object): BCP-47 language → { title, description }
- `contains_synthetic_media` (boolean)
- `has_paid_product_placement` (boolean)
- `license` (string; one of youtube, creativeCommon)
- `embeddable` (boolean)
- `public_stats_viewable` (boolean)
- `notify_subscribers` (boolean)
- `recording_date` (string (date-time))
- `is_short` (boolean): Override Shorts detection
- `add_shorts_hashtag` (boolean)
- `thumbnail` (string)
- `playlist_ids` (array of string)
- `captions` (array of object)
  - `captions[].media` (string)
  - `captions[].language` (string)
  - `captions[].name` (string; ≤ 150 characters)
  - `captions[].is_draft` (boolean)
- `first_comment` (string; ≤ 10000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/shorts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media": "string",
    "title": "string",
    "description": "string",
    "privacy_status": "private",
    "self_declared_made_for_kids": true
  }'
```

Response 201:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "tags": [
    "string"
  ],
  "category_id": "string",
  "default_language": "string",
  "default_audio_language": "string",
  "privacy_status": "public",
  "publish_at": "2026-10-13T09:00:00.000Z",
  "is_scheduled": true,
  "self_declared_made_for_kids": true,
  "made_for_kids": true,
  "contains_synthetic_media": true,
  "has_paid_product_placement": true,
  "license": "youtube",
  "embeddable": true,
  "public_stats_viewable": true,
  "recording_date": "2026-10-13T09:00:00.000Z",
  "thumbnail_url": "https://example.com",
  "published_at": "2026-10-13T09:00:00.000Z",
  "upload_status": "uploaded",
  "failure_reason": "string",
  "rejection_reason": "string",
  "processing_status": "string",
  "duration_seconds": 1,
  "definition": "string",
  "caption": true,
  "has_custom_thumbnail": true,
  "is_short": true,
  "is_live": true,
  "view_count": 1,
  "like_count": 1,
  "comment_count": 1,
  "width": 1,
  "height": 1,
  "localizations": {
    "key": {
      "title": "string",
      "description": "string"
    }
  },
  "url": "https://example.com",
  "studio_url": "https://example.com"
}
```

## YouTube: Get a Shorts item

`GET /accounts/{accountId}/youtube/shorts/{itemId}`

Video details (all owner parts) · quota: 1 unit (videos.list). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.

Access: `read` · MCP tool: `youtube-shorts-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/shorts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "tags": [
    "string"
  ],
  "category_id": "string",
  "default_language": "string",
  "default_audio_language": "string",
  "privacy_status": "public",
  "publish_at": "2026-10-13T09:00:00.000Z",
  "is_scheduled": true,
  "self_declared_made_for_kids": true,
  "made_for_kids": true,
  "contains_synthetic_media": true,
  "has_paid_product_placement": true,
  "license": "youtube",
  "embeddable": true,
  "public_stats_viewable": true,
  "recording_date": "2026-10-13T09:00:00.000Z",
  "thumbnail_url": "https://example.com",
  "published_at": "2026-10-13T09:00:00.000Z",
  "upload_status": "uploaded",
  "failure_reason": "string",
  "rejection_reason": "string",
  "processing_status": "string",
  "duration_seconds": 1,
  "definition": "string",
  "caption": true,
  "has_custom_thumbnail": true,
  "is_short": true,
  "is_live": true,
  "view_count": 1,
  "like_count": 1,
  "comment_count": 1,
  "width": 1,
  "height": 1,
  "localizations": {
    "key": {
      "title": "string",
      "description": "string"
    }
  },
  "url": "https://example.com",
  "studio_url": "https://example.com"
}
```

## YouTube: Update a Shorts item

`PATCH /accounts/{accountId}/youtube/shorts/{itemId}`

Update metadata (read-modify-write) · quota: 51 units (videos.list, videos.update). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.

Access: `write` · MCP tool: `youtube-shorts-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `title` (string; ≤ 100 characters)
- `description` (string; ≤ 5000 characters)
- `tags` (array of string)
- `category_id` (string)
- `default_language` (string)
- `default_audio_language` (string)
- `privacy_status` (string; one of public, unlisted, private)
- `publish_at` (string (date-time) | null)
- `self_declared_made_for_kids` (boolean)
- `contains_synthetic_media` (boolean)
- `has_paid_product_placement` (boolean)
- `license` (string; one of youtube, creativeCommon)
- `embeddable` (boolean)
- `public_stats_viewable` (boolean)
- `recording_date` (string (date-time) | null)
- `localizations` (object): BCP-47 language → { title, description }
- `brand_partner` (object)
  - `brand_partner.channel_id` (string; pattern ^UC)
  - `brand_partner.channel_handle` (string; pattern ^@)
- `thumbnail` (string): New custom thumbnail (JPEG/PNG ≤50 MB)
- `playlist_id` (string): Also add to this playlist

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/shorts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "tags": [
      "string"
    ],
    "category_id": "string",
    "default_language": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "tags": [
    "string"
  ],
  "category_id": "string",
  "default_language": "string",
  "default_audio_language": "string",
  "privacy_status": "public",
  "publish_at": "2026-10-13T09:00:00.000Z",
  "is_scheduled": true,
  "self_declared_made_for_kids": true,
  "made_for_kids": true,
  "contains_synthetic_media": true,
  "has_paid_product_placement": true,
  "license": "youtube",
  "embeddable": true,
  "public_stats_viewable": true,
  "recording_date": "2026-10-13T09:00:00.000Z",
  "thumbnail_url": "https://example.com",
  "published_at": "2026-10-13T09:00:00.000Z",
  "upload_status": "uploaded",
  "failure_reason": "string",
  "rejection_reason": "string",
  "processing_status": "string",
  "duration_seconds": 1,
  "definition": "string",
  "caption": true,
  "has_custom_thumbnail": true,
  "is_short": true,
  "is_live": true,
  "view_count": 1,
  "like_count": 1,
  "comment_count": 1,
  "width": 1,
  "height": 1,
  "localizations": {
    "key": {
      "title": "string",
      "description": "string"
    }
  },
  "url": "https://example.com",
  "studio_url": "https://example.com"
}
```

## YouTube: Delete a Shorts item

`DELETE /accounts/{accountId}/youtube/shorts/{itemId}`

Delete permanently · quota: 50 units (videos.delete). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.

Access: `write` · MCP tool: `youtube-shorts-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/shorts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: Rate (Shorts)

`POST /accounts/{accountId}/youtube/shorts/{itemId}/rate`

Like, dislike or clear rating · quota: 50 units (videos.rate). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.

Access: `write` · MCP tool: `youtube-shorts-rate`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `rating` (string; required; one of like, dislike, none)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/shorts/ITEM_ID/rate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "rating": "like"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Add to playlist (Shorts)

`POST /accounts/{accountId}/youtube/shorts/{itemId}/add-to-playlist`

Insert into a playlist · quota: 50 units (playlistItems.insert). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.

Access: `write` · MCP tool: `youtube-shorts-add-to-playlist`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `playlist_id` (string; required)
- `position` (integer)
- `note` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/shorts/ITEM_ID/add-to-playlist" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "playlist_id": "string",
    "position": 0,
    "note": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Change visibility (Shorts)

`POST /accounts/{accountId}/youtube/shorts/{itemId}/set-visibility`

Set privacy (clears schedule unless private) · quota: 51 units (videos.list, videos.update). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.

Access: `write` · MCP tool: `youtube-shorts-set-visibility`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `privacy_status` (string; required; one of public, unlisted, private)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/shorts/ITEM_ID/set-visibility" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "privacy_status": "public"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Schedule (Shorts)

`POST /accounts/{accountId}/youtube/shorts/{itemId}/schedule`

Set status.publishAt (video becomes private until then) · quota: 51 units (videos.list, videos.update). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.

Access: `write` · MCP tool: `youtube-shorts-schedule`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `publish_at` (string (date-time); required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/shorts/ITEM_ID/schedule" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "publish_at": "2026-10-13T09:00:00.000Z"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Scheduled

`GET /accounts/{accountId}/youtube/scheduled`

Scheduled videos (scans up to 4 upload pages) · quota: 2 units (playlistItems.list, videos.list). Private videos with status.publishAt — the native YouTube schedule. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: /v1/accounts/{accountId}/focus/scheduled.

Access: `read` · MCP tool: `youtube-scheduled-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string)
- `scan_pages` (integer; 1–10)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/scheduled" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "tags": [
        "string"
      ],
      "category_id": "string",
      "default_language": "string",
      "default_audio_language": "string",
      "privacy_status": "public",
      "publish_at": "2026-10-13T09:00:00.000Z",
      "is_scheduled": true,
      "self_declared_made_for_kids": true,
      "made_for_kids": true,
      "contains_synthetic_media": true,
      "has_paid_product_placement": true,
      "license": "youtube",
      "embeddable": true,
      "public_stats_viewable": true,
      "recording_date": "2026-10-13T09:00:00.000Z",
      "thumbnail_url": "https://example.com",
      "published_at": "2026-10-13T09:00:00.000Z",
      "upload_status": "uploaded",
      "failure_reason": "string",
      "rejection_reason": "string",
      "processing_status": "string",
      "duration_seconds": 1,
      "definition": "string",
      "caption": true,
      "has_custom_thumbnail": true,
      "is_short": true,
      "is_live": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Get a Scheduled item

`GET /accounts/{accountId}/youtube/scheduled/{itemId}`

Video details (all owner parts) · quota: 1 unit (videos.list). Private videos with status.publishAt — the native YouTube schedule. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: /v1/accounts/{accountId}/focus/scheduled.

Access: `read` · MCP tool: `youtube-scheduled-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/scheduled/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "tags": [
    "string"
  ],
  "category_id": "string",
  "default_language": "string",
  "default_audio_language": "string",
  "privacy_status": "public",
  "publish_at": "2026-10-13T09:00:00.000Z",
  "is_scheduled": true,
  "self_declared_made_for_kids": true,
  "made_for_kids": true,
  "contains_synthetic_media": true,
  "has_paid_product_placement": true,
  "license": "youtube",
  "embeddable": true,
  "public_stats_viewable": true,
  "recording_date": "2026-10-13T09:00:00.000Z",
  "thumbnail_url": "https://example.com",
  "published_at": "2026-10-13T09:00:00.000Z",
  "upload_status": "uploaded",
  "failure_reason": "string",
  "rejection_reason": "string",
  "processing_status": "string",
  "duration_seconds": 1,
  "definition": "string",
  "caption": true,
  "has_custom_thumbnail": true,
  "is_short": true,
  "is_live": true,
  "view_count": 1,
  "like_count": 1,
  "comment_count": 1,
  "width": 1,
  "height": 1,
  "localizations": {
    "key": {
      "title": "string",
      "description": "string"
    }
  },
  "url": "https://example.com",
  "studio_url": "https://example.com"
}
```

## YouTube: Update a Scheduled item

`PATCH /accounts/{accountId}/youtube/scheduled/{itemId}`

Reschedule / edit · quota: 51 units (videos.list, videos.update). Private videos with status.publishAt — the native YouTube schedule. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: /v1/accounts/{accountId}/focus/scheduled.

Access: `write` · MCP tool: `youtube-scheduled-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `title` (string; ≤ 100 characters)
- `description` (string; ≤ 5000 characters)
- `tags` (array of string)
- `category_id` (string)
- `default_language` (string)
- `default_audio_language` (string)
- `privacy_status` (string; one of public, unlisted, private)
- `publish_at` (string (date-time) | null)
- `self_declared_made_for_kids` (boolean)
- `contains_synthetic_media` (boolean)
- `has_paid_product_placement` (boolean)
- `license` (string; one of youtube, creativeCommon)
- `embeddable` (boolean)
- `public_stats_viewable` (boolean)
- `recording_date` (string (date-time) | null)
- `localizations` (object): BCP-47 language → { title, description }
- `brand_partner` (object)
  - `brand_partner.channel_id` (string; pattern ^UC)
  - `brand_partner.channel_handle` (string; pattern ^@)
- `thumbnail` (string): New custom thumbnail (JPEG/PNG ≤50 MB)
- `playlist_id` (string): Also add to this playlist

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/scheduled/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "tags": [
      "string"
    ],
    "category_id": "string",
    "default_language": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "tags": [
    "string"
  ],
  "category_id": "string",
  "default_language": "string",
  "default_audio_language": "string",
  "privacy_status": "public",
  "publish_at": "2026-10-13T09:00:00.000Z",
  "is_scheduled": true,
  "self_declared_made_for_kids": true,
  "made_for_kids": true,
  "contains_synthetic_media": true,
  "has_paid_product_placement": true,
  "license": "youtube",
  "embeddable": true,
  "public_stats_viewable": true,
  "recording_date": "2026-10-13T09:00:00.000Z",
  "thumbnail_url": "https://example.com",
  "published_at": "2026-10-13T09:00:00.000Z",
  "upload_status": "uploaded",
  "failure_reason": "string",
  "rejection_reason": "string",
  "processing_status": "string",
  "duration_seconds": 1,
  "definition": "string",
  "caption": true,
  "has_custom_thumbnail": true,
  "is_short": true,
  "is_live": true,
  "view_count": 1,
  "like_count": 1,
  "comment_count": 1,
  "width": 1,
  "height": 1,
  "localizations": {
    "key": {
      "title": "string",
      "description": "string"
    }
  },
  "url": "https://example.com",
  "studio_url": "https://example.com"
}
```

## YouTube: Delete a Scheduled item

`DELETE /accounts/{accountId}/youtube/scheduled/{itemId}`

Delete permanently · quota: 50 units (videos.delete). Private videos with status.publishAt — the native YouTube schedule. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: /v1/accounts/{accountId}/focus/scheduled.

Access: `write` · MCP tool: `youtube-scheduled-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/scheduled/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: Publish now (Scheduled)

`POST /accounts/{accountId}/youtube/scheduled/{itemId}/publish-now`

Make public immediately · quota: 51 units (videos.list, videos.update). Private videos with status.publishAt — the native YouTube schedule. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: /v1/accounts/{accountId}/focus/scheduled.

Access: `write` · MCP tool: `youtube-scheduled-publish-now`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/scheduled/ITEM_ID/publish-now" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Unschedule (Scheduled)

`POST /accounts/{accountId}/youtube/scheduled/{itemId}/unschedule`

Keep private, clear publishAt · quota: 51 units (videos.list, videos.update). Private videos with status.publishAt — the native YouTube schedule. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: /v1/accounts/{accountId}/focus/scheduled.

Access: `write` · MCP tool: `youtube-scheduled-unschedule`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/scheduled/ITEM_ID/unschedule" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Translations

`GET /accounts/{accountId}/youtube/video-localizations`

List translations of a video · quota: 1 unit (videos.list). Per-language video title & description (videos.localizations). Needs the video default language. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos#localizations Generic route: /v1/accounts/{accountId}/focus/video-localizations.

Access: `read` · MCP tool: `youtube-video-localizations-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `video_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/video-localizations?video_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "video_id": "string",
      "language": "en",
      "title": "string",
      "description": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Translations item

`POST /accounts/{accountId}/youtube/video-localizations`

Add a translation · quota: 52 units (videos.list, videos.update). Per-language video title & description (videos.localizations). Needs the video default language. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos#localizations Generic route: /v1/accounts/{accountId}/focus/video-localizations.

Access: `write` · MCP tool: `youtube-video-localizations-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `video_id` (string; required)
- `language` (string; required)
- `title` (string; required; ≤ 100 characters)
- `description` (string)
- `default_language` (string): Set the video default language if missing

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/video-localizations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "video_id": "string",
    "language": "en",
    "title": "string",
    "description": "string",
    "default_language": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "video_id": "string",
  "language": "en",
  "title": "string",
  "description": "string"
}
```

## YouTube: Update a Translations item

`PATCH /accounts/{accountId}/youtube/video-localizations/{itemId}`

Edit a translation · quota: 52 units (videos.list, videos.update). Per-language video title & description (videos.localizations). Needs the video default language. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos#localizations Generic route: /v1/accounts/{accountId}/focus/video-localizations.

Access: `write` · MCP tool: `youtube-video-localizations-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `title` (string; ≤ 100 characters)
- `description` (string)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/video-localizations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "video_id": "string",
  "language": "en",
  "title": "string",
  "description": "string"
}
```

## YouTube: Delete a Translations item

`DELETE /accounts/{accountId}/youtube/video-localizations/{itemId}`

Remove a translation · quota: 52 units (videos.list, videos.update). Per-language video title & description (videos.localizations). Needs the video default language. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos#localizations Generic route: /v1/accounts/{accountId}/focus/video-localizations.

Access: `write` · MCP tool: `youtube-video-localizations-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/video-localizations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: List Subtitles

`GET /accounts/{accountId}/youtube/captions`

List tracks of a video · quota: 50 units (captions.list). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: /v1/accounts/{accountId}/focus/captions.

Access: `read` · MCP tool: `youtube-captions-list` · Zernio: `GET /v1/accounts/{accountId}/youtube-captions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `video_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/captions?video_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "video_id": "string",
      "language": "en",
      "name": "string",
      "track_kind": "standard",
      "audio_track_type": "string",
      "is_draft": true,
      "is_cc": true,
      "is_auto_synced": true,
      "status": "serving",
      "failure_reason": "string",
      "last_updated": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Subtitles item

`POST /accounts/{accountId}/youtube/captions`

Upload a caption track · quota: 400 units (captions.insert). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: /v1/accounts/{accountId}/focus/captions.

Access: `write` · MCP tool: `youtube-captions-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `video_id` (string; required)
- `language` (string; required)
- `name` (string; ≤ 150 characters)
- `is_draft` (boolean)
- `media` (string)
- `text` (string): Or paste the caption file content

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/captions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "video_id": "string",
    "language": "en",
    "name": "string",
    "is_draft": false,
    "media": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "video_id": "string",
  "language": "en",
  "name": "string",
  "track_kind": "standard",
  "audio_track_type": "string",
  "is_draft": true,
  "is_cc": true,
  "is_auto_synced": true,
  "status": "serving",
  "failure_reason": "string",
  "last_updated": "2026-10-13T09:00:00.000Z"
}
```

## YouTube: Update a Subtitles item

`PATCH /accounts/{accountId}/youtube/captions/{itemId}`

Toggle draft and/or replace the file · quota: 450 units (captions.update). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: /v1/accounts/{accountId}/focus/captions.

Access: `write` · MCP tool: `youtube-captions-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `is_draft` (boolean)
- `media` (string)
- `text` (string)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/captions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "is_draft": true,
    "media": "string",
    "text": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "video_id": "string",
  "language": "en",
  "name": "string",
  "track_kind": "standard",
  "audio_track_type": "string",
  "is_draft": true,
  "is_cc": true,
  "is_auto_synced": true,
  "status": "serving",
  "failure_reason": "string",
  "last_updated": "2026-10-13T09:00:00.000Z"
}
```

## YouTube: Delete a Subtitles item

`DELETE /accounts/{accountId}/youtube/captions/{itemId}`

Delete a track · quota: 50 units (captions.delete). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: /v1/accounts/{accountId}/focus/captions.

Access: `write` · MCP tool: `youtube-captions-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/captions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: Download (Subtitles)

`POST /accounts/{accountId}/youtube/captions/{itemId}/download`

Download (convert tfmt, machine-translate tlang) · quota: 200 units (captions.download). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: /v1/accounts/{accountId}/focus/captions.

Access: `write` · MCP tool: `youtube-captions-download`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `tfmt` (string; one of sbv, scc, srt, ttml, vtt)
- `tlang` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/captions/ITEM_ID/download" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "tfmt": "sbv",
    "tlang": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Transcript (Subtitles)

`POST /accounts/{accountId}/youtube/captions/transcript`

Zernio-style transcript: cues + text · quota: 250 units (captions.list, captions.download). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: /v1/accounts/{accountId}/focus/captions.

Access: `write` · MCP tool: `youtube-captions-transcript`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `video_id` (string; required)
- `language` (string)
- `format` (string; one of json, srt, vtt)
- `track_id` (string)
- `tlang` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/captions/transcript" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "video_id": "string",
    "language": "en",
    "format": "json",
    "track_id": "string",
    "tlang": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Search

`GET /accounts/{accountId}/youtube/search`

Search · quota: 1 search.list bucket (search.list). search.list — own content (for_mine) or public. Uses the separate 100 calls/day bucket. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/search/list Generic route: /v1/accounts/{accountId}/focus/search.

Access: `read` · MCP tool: `youtube-search-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–50)
- `cursor` (string)
- `q` (string)
- `for_mine` (boolean)
- `channel_id` (string)
- `type` (string; one of video, channel, playlist)
- `order` (string; one of date, rating, relevance, title, videoCount, viewCount)
- `event_type` (string; one of completed, live, upcoming)
- `published_after` (string (date-time))
- `published_before` (string (date-time))

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/search" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "kind": "string",
      "title": "string",
      "description": "string",
      "published_at": "2026-10-13T09:00:00.000Z",
      "channel_id": "string",
      "channel_title": "string",
      "thumbnail_url": "https://example.com",
      "live_broadcast_content": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: List Playlists

`GET /accounts/{accountId}/youtube/playlists`

List playlists (+ default flag) · quota: 1 unit (playlists.list). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: /v1/accounts/{accountId}/focus/playlists.

Access: `read` · MCP tool: `youtube-playlists-list` · Zernio: `GET /v1/accounts/{accountId}/youtube-playlists`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–50)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "privacy_status": "public",
      "item_count": 1,
      "default_language": "string",
      "localizations": {},
      "thumbnail_url": "https://example.com",
      "published_at": "2026-10-13T09:00:00.000Z",
      "podcast_status": "string",
      "is_default": true,
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Playlists item

`POST /accounts/{accountId}/youtube/playlists`

Create playlist (not idempotent) · quota: 50 units (playlists.insert). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: /v1/accounts/{accountId}/focus/playlists.

Access: `write` · MCP tool: `youtube-playlists-create` · Zernio: `POST /v1/accounts/{accountId}/youtube-playlists`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `title` (string; required; ≤ 150 characters)
- `description` (string; ≤ 5000 characters)
- `privacy_status` (string; one of public, unlisted, private)
- `default_language` (string)
- `localizations` (object): BCP-47 language → { title, description }

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "privacy_status": "private",
    "default_language": "string",
    "localizations": {
      "key": {
        "title": "string",
        "description": "string"
      }
    }
  }'
```

Response 201:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "privacy_status": "public",
  "item_count": 1,
  "default_language": "string",
  "localizations": {
    "key": {
      "title": "string",
      "description": "string"
    }
  },
  "thumbnail_url": "https://example.com",
  "published_at": "2026-10-13T09:00:00.000Z",
  "podcast_status": "string",
  "is_default": true,
  "url": "https://example.com"
}
```

## YouTube: Get a Playlists item

`GET /accounts/{accountId}/youtube/playlists/{itemId}`

Playlist details · quota: 1 unit (playlists.list). Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: /v1/accounts/{accountId}/focus/playlists.

Access: `read` · MCP tool: `youtube-playlists-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "privacy_status": "public",
  "item_count": 1,
  "default_language": "string",
  "localizations": {
    "key": {
      "title": "string",
      "description": "string"
    }
  },
  "thumbnail_url": "https://example.com",
  "published_at": "2026-10-13T09:00:00.000Z",
  "podcast_status": "string",
  "is_default": true,
  "url": "https://example.com"
}
```

## YouTube: Update a Playlists item

`PATCH /accounts/{accountId}/youtube/playlists/{itemId}`

Edit playlist · quota: 51 units (playlists.list, playlists.update). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: /v1/accounts/{accountId}/focus/playlists.

Access: `write` · MCP tool: `youtube-playlists-update` · Zernio: `PUT /v1/accounts/{accountId}/youtube-playlists`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `title` (string; ≤ 150 characters)
- `description` (string; ≤ 5000 characters)
- `privacy_status` (string; one of public, unlisted, private)
- `default_language` (string)
- `localizations` (object): BCP-47 language → { title, description }

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "privacy_status": "private",
    "default_language": "string",
    "localizations": {
      "key": {
        "title": "string",
        "description": "string"
      }
    }
  }'
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "privacy_status": "public",
  "item_count": 1,
  "default_language": "string",
  "localizations": {
    "key": {
      "title": "string",
      "description": "string"
    }
  },
  "thumbnail_url": "https://example.com",
  "published_at": "2026-10-13T09:00:00.000Z",
  "podcast_status": "string",
  "is_default": true,
  "url": "https://example.com"
}
```

## YouTube: Delete a Playlists item

`DELETE /accounts/{accountId}/youtube/playlists/{itemId}`

Delete playlist · quota: 50 units (playlists.delete). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: /v1/accounts/{accountId}/focus/playlists.

Access: `write` · MCP tool: `youtube-playlists-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: Set as default (Playlists)

`POST /accounts/{accountId}/youtube/playlists/{itemId}/set-default`

Default playlist for the composer (stored on the account; validated) · quota: 1 unit (playlists.list). Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: /v1/accounts/{accountId}/focus/playlists.

Access: `write` · MCP tool: `youtube-playlists-set-default`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlists/ITEM_ID/set-default" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Add video (Playlists)

`POST /accounts/{accountId}/youtube/playlists/{itemId}/add-video`

Insert a video · quota: 50 units (playlistItems.insert). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: /v1/accounts/{accountId}/focus/playlists.

Access: `write` · MCP tool: `youtube-playlists-add-video`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `video_id` (string; required)
- `position` (integer)
- `note` (string; ≤ 280 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlists/ITEM_ID/add-video" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "video_id": "string",
    "position": 0,
    "note": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Playlist items

`GET /accounts/{accountId}/youtube/playlist-items`

Items of a playlist · quota: 1 unit (playlistItems.list). Videos in a playlist: add, reorder (position), note, remove. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistItems Generic route: /v1/accounts/{accountId}/focus/playlist-items.

Access: `read` · MCP tool: `youtube-playlist-items-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–50)
- `cursor` (string)
- `playlist_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlist-items" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "playlist_id": "string",
      "video_id": "string",
      "title": "string",
      "position": 0,
      "note": "string",
      "start_at": "2026-10-13T09:00:00.000Z",
      "end_at": "2026-10-13T09:00:00.000Z",
      "thumbnail_url": "https://example.com",
      "video_published_at": "2026-10-13T09:00:00.000Z",
      "added_at": "2026-10-13T09:00:00.000Z",
      "privacy_status": "string",
      "video_owner_channel_title": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Playlist items item

`POST /accounts/{accountId}/youtube/playlist-items`

Add a video · quota: 50 units (playlistItems.insert). Videos in a playlist: add, reorder (position), note, remove. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistItems Generic route: /v1/accounts/{accountId}/focus/playlist-items.

Access: `write` · MCP tool: `youtube-playlist-items-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `playlist_id` (string; required)
- `video_id` (string; required)
- `position` (integer)
- `note` (string; ≤ 280 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlist-items" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "playlist_id": "string",
    "video_id": "string",
    "position": 0,
    "note": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "playlist_id": "string",
  "video_id": "string",
  "title": "string",
  "position": 0,
  "note": "string",
  "start_at": "2026-10-13T09:00:00.000Z",
  "end_at": "2026-10-13T09:00:00.000Z",
  "thumbnail_url": "https://example.com",
  "video_published_at": "2026-10-13T09:00:00.000Z",
  "added_at": "2026-10-13T09:00:00.000Z",
  "privacy_status": "string",
  "video_owner_channel_title": "string"
}
```

## YouTube: Update a Playlist items item

`PATCH /accounts/{accountId}/youtube/playlist-items/{itemId}`

Reorder / edit note · quota: 51 units (playlistItems.list, playlistItems.update). Videos in a playlist: add, reorder (position), note, remove. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistItems Generic route: /v1/accounts/{accountId}/focus/playlist-items.

Access: `write` · MCP tool: `youtube-playlist-items-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `position` (integer)
- `note` (string; ≤ 280 characters)
- `playlist_id` (string)
- `video_id` (string)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlist-items/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "position": 0,
    "note": "string",
    "playlist_id": "string",
    "video_id": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "playlist_id": "string",
  "video_id": "string",
  "title": "string",
  "position": 0,
  "note": "string",
  "start_at": "2026-10-13T09:00:00.000Z",
  "end_at": "2026-10-13T09:00:00.000Z",
  "thumbnail_url": "https://example.com",
  "video_published_at": "2026-10-13T09:00:00.000Z",
  "added_at": "2026-10-13T09:00:00.000Z",
  "privacy_status": "string",
  "video_owner_channel_title": "string"
}
```

## YouTube: Delete a Playlist items item

`DELETE /accounts/{accountId}/youtube/playlist-items/{itemId}`

Remove from playlist · quota: 50 units (playlistItems.delete). Videos in a playlist: add, reorder (position), note, remove. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistItems Generic route: /v1/accounts/{accountId}/focus/playlist-items.

Access: `write` · MCP tool: `youtube-playlist-items-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlist-items/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: Move (Playlist items)

`POST /accounts/{accountId}/youtube/playlist-items/{itemId}/move`

Move to a position (0-based) · quota: 51 units (playlistItems.list, playlistItems.update). Videos in a playlist: add, reorder (position), note, remove. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistItems Generic route: /v1/accounts/{accountId}/focus/playlist-items.

Access: `write` · MCP tool: `youtube-playlist-items-move`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `position` (integer; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlist-items/ITEM_ID/move" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "position": 0
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Playlist images

`GET /accounts/{accountId}/youtube/playlist-images`

Images of a playlist · quota: 1 unit (playlistImages.list). Custom playlist thumbnails (1:1 JPEG/PNG ≤50 MB). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistImages Generic route: /v1/accounts/{accountId}/focus/playlist-images.

Access: `read` · MCP tool: `youtube-playlist-images-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–50)
- `cursor` (string)
- `playlist_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlist-images" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "playlist_id": "string",
      "type": "hero",
      "width": 1,
      "height": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Playlist images item

`POST /accounts/{accountId}/youtube/playlist-images`

Upload image · quota: 50 units (playlistImages.insert). Custom playlist thumbnails (1:1 JPEG/PNG ≤50 MB). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistImages Generic route: /v1/accounts/{accountId}/focus/playlist-images.

Access: `write` · MCP tool: `youtube-playlist-images-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `playlist_id` (string; required)
- `media` (string; required)
- `type` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlist-images" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "playlist_id": "string",
    "media": "string",
    "type": "hero"
  }'
```

Response 201:

```json
{
  "id": "string",
  "playlist_id": "string",
  "type": "hero",
  "width": 1,
  "height": 1
}
```

## YouTube: Update a Playlist images item

`PATCH /accounts/{accountId}/youtube/playlist-images/{itemId}`

Replace image · quota: 50 units (playlistImages.update). Custom playlist thumbnails (1:1 JPEG/PNG ≤50 MB). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistImages Generic route: /v1/accounts/{accountId}/focus/playlist-images.

Access: `write` · MCP tool: `youtube-playlist-images-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `playlist_id` (string; required)
- `media` (string; required)
- `type` (string)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlist-images/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "playlist_id": "string",
    "media": "string",
    "type": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "playlist_id": "string",
  "type": "hero",
  "width": 1,
  "height": 1
}
```

## YouTube: Delete a Playlist images item

`DELETE /accounts/{accountId}/youtube/playlist-images/{itemId}`

Delete image · quota: 50 units (playlistImages.delete). Custom playlist thumbnails (1:1 JPEG/PNG ≤50 MB). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistImages Generic route: /v1/accounts/{accountId}/focus/playlist-images.

Access: `write` · MCP tool: `youtube-playlist-images-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlist-images/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: Get Overview

`GET /accounts/{accountId}/youtube/analytics-overview`

Overview (daily + totals + cards + content types + channel insights) · quota: 6 analytics queries (analytics.reports.query). Views, watch time, subscribers, engagement — daily series + period totals + Shorts/long-form split. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/reports/query Generic route: /v1/accounts/{accountId}/focus/analytics-overview.

Access: `read` · MCP tool: `youtube-analytics-overview-get` · Zernio: `GET /v1/analytics/youtube/channel-insights`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 28 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)
- `granularity` (string; one of day, month)
- `video_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-overview" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "since": "string",
  "until": "string",
  "totals": {
    "key": 1.5
  },
  "series": [
    {
      "date": "string",
      "metrics": {}
    }
  ],
  "youtube_totals": {},
  "youtube_series": [
    {
      "date": "string",
      "metrics": {}
    }
  ],
  "content_types": [
    {}
  ],
  "insights": {},
  "errors": {}
}
```

## YouTube: Get Reach

`GET /accounts/{accountId}/youtube/analytics-reach`

Reach: traffic_sources, traffic_sources_daily, search_terms, external_sites, playback_locations, embedded_sites, impressions · quota: 7 analytics queries (analytics.reports.query). Traffic sources, YouTube search terms, external sites, playback locations; thumbnail impressions/CTR via the Reporting API reach job. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-reach.

Access: `read` · MCP tool: `youtube-analytics-reach-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 28 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)
- `video_id` (string): Filter to one video
- `playlist_id` (string)
- `group_id` (string): Analytics group
- `country` (string): ISO 3166-1 alpha-2
- `creator_content_type` (string; one of SHORTS, VIDEO_ON_DEMAND, LIVE_STREAM, STORY)
- `include_impressions` (boolean): Read channel_reach_basic_a1 bulk reports

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-reach" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "since": "2026-10-13",
  "until": "2026-10-13",
  "sections": {
    "key": {
      "report": "string",
      "label": "string",
      "columns": [
        {
          "name": "string",
          "type": "dimension",
          "data_type": "string"
        }
      ],
      "rows": [
        [
          null
        ]
      ],
      "items": [
        {}
      ],
      "series": [
        {
          "date": "string",
          "metrics": {}
        }
      ]
    }
  },
  "errors": {
    "key": {
      "code": "string",
      "message": "string"
    }
  }
}
```

## YouTube: Get Engagement

`GET /accounts/{accountId}/youtube/analytics-engagement`

Engagement: engagement, watch_time, top_videos, subscribers_by_video, sharing_services, cards, engaged_views · quota: 7 analytics queries (analytics.reports.query). Likes, comments, shares, playlist adds, subscribers per video, cards, sharing services, top videos. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-engagement.

Access: `read` · MCP tool: `youtube-analytics-engagement-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 28 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)
- `video_id` (string): Filter to one video
- `playlist_id` (string)
- `group_id` (string): Analytics group
- `country` (string): ISO 3166-1 alpha-2
- `creator_content_type` (string; one of SHORTS, VIDEO_ON_DEMAND, LIVE_STREAM, STORY)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-engagement" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "since": "2026-10-13",
  "until": "2026-10-13",
  "sections": {
    "key": {
      "report": "string",
      "label": "string",
      "columns": [
        {
          "name": "string",
          "type": "dimension",
          "data_type": "string"
        }
      ],
      "rows": [
        [
          null
        ]
      ],
      "items": [
        {}
      ],
      "series": [
        {
          "date": "string",
          "metrics": {}
        }
      ]
    }
  },
  "errors": {
    "key": {
      "code": "string",
      "message": "string"
    }
  }
}
```

## YouTube: Get Audience

`GET /accounts/{accountId}/youtube/analytics-audience`

Audience: demographics, age, gender, subscribed_status, youtube_products, countries · quota: 6 analytics queries (analytics.reports.query). Age, gender, subscribed vs not, YouTube products, top countries. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-audience.

Access: `read` · MCP tool: `youtube-analytics-audience-get` · Zernio: `GET /v1/analytics/youtube/demographics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 28 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)
- `video_id` (string): Filter to one video
- `playlist_id` (string)
- `group_id` (string): Analytics group
- `country` (string): ISO 3166-1 alpha-2
- `creator_content_type` (string; one of SHORTS, VIDEO_ON_DEMAND, LIVE_STREAM, STORY)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-audience" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "since": "2026-10-13",
  "until": "2026-10-13",
  "sections": {
    "key": {
      "report": "string",
      "label": "string",
      "columns": [
        {
          "name": "string",
          "type": "dimension",
          "data_type": "string"
        }
      ],
      "rows": [
        [
          null
        ]
      ],
      "items": [
        {}
      ],
      "series": [
        {
          "date": "string",
          "metrics": {}
        }
      ]
    }
  },
  "errors": {
    "key": {
      "code": "string",
      "message": "string"
    }
  }
}
```

## YouTube: Get Demographics

`GET /accounts/{accountId}/youtube/analytics-demographics`

Demographics · quota: 3 analytics queries (analytics.reports.query). Zernio-style age/gender (viewer %) and country (views), channel or per video. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-demographics.

Access: `read` · MCP tool: `youtube-analytics-demographics-get` · Zernio: `GET /v1/analytics/youtube/demographics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 28 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)
- `video_id` (string)
- `breakdown` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-demographics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "demographics": {
    "age": [
      {
        "dimension": "string",
        "value": 1.5
      }
    ],
    "gender": [
      {
        "dimension": "string",
        "value": 1.5
      }
    ],
    "country": [
      {
        "dimension": "string",
        "value": 1.5
      }
    ]
  }
}
```

## YouTube: Get Geography

`GET /accounts/{accountId}/youtube/analytics-geography`

Geography: countries, us_states, cities · quota: 3 analytics queries (analytics.reports.query). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-geography.

Access: `read` · MCP tool: `youtube-analytics-geography-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 28 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)
- `video_id` (string): Filter to one video
- `playlist_id` (string)
- `group_id` (string): Analytics group
- `country` (string): ISO 3166-1 alpha-2
- `creator_content_type` (string; one of SHORTS, VIDEO_ON_DEMAND, LIVE_STREAM, STORY)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-geography" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "since": "2026-10-13",
  "until": "2026-10-13",
  "sections": {
    "key": {
      "report": "string",
      "label": "string",
      "columns": [
        {
          "name": "string",
          "type": "dimension",
          "data_type": "string"
        }
      ],
      "rows": [
        [
          null
        ]
      ],
      "items": [
        {}
      ],
      "series": [
        {
          "date": "string",
          "metrics": {}
        }
      ]
    }
  },
  "errors": {
    "key": {
      "code": "string",
      "message": "string"
    }
  }
}
```

## YouTube: Get Devices

`GET /accounts/{accountId}/youtube/analytics-devices`

Devices: devices, operating_systems, device_os · quota: 3 analytics queries (analytics.reports.query). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-devices.

Access: `read` · MCP tool: `youtube-analytics-devices-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 28 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)
- `video_id` (string): Filter to one video
- `playlist_id` (string)
- `group_id` (string): Analytics group
- `country` (string): ISO 3166-1 alpha-2
- `creator_content_type` (string; one of SHORTS, VIDEO_ON_DEMAND, LIVE_STREAM, STORY)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-devices" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "since": "2026-10-13",
  "until": "2026-10-13",
  "sections": {
    "key": {
      "report": "string",
      "label": "string",
      "columns": [
        {
          "name": "string",
          "type": "dimension",
          "data_type": "string"
        }
      ],
      "rows": [
        [
          null
        ]
      ],
      "items": [
        {}
      ],
      "series": [
        {
          "date": "string",
          "metrics": {}
        }
      ]
    }
  },
  "errors": {
    "key": {
      "code": "string",
      "message": "string"
    }
  }
}
```

## YouTube: Get Shorts vs videos vs live

`GET /accounts/{accountId}/youtube/analytics-content-types`

Shorts vs videos vs live: content_types, content_types_daily, top_shorts, premium · quota: 4 analytics queries (analytics.reports.query). creatorContentType split, daily, top Shorts, Premium views. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-content-types.

Access: `read` · MCP tool: `youtube-analytics-content-types-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 28 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)
- `video_id` (string): Filter to one video
- `playlist_id` (string)
- `group_id` (string): Analytics group
- `country` (string): ISO 3166-1 alpha-2
- `creator_content_type` (string; one of SHORTS, VIDEO_ON_DEMAND, LIVE_STREAM, STORY)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-content-types" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "since": "2026-10-13",
  "until": "2026-10-13",
  "sections": {
    "key": {
      "report": "string",
      "label": "string",
      "columns": [
        {
          "name": "string",
          "type": "dimension",
          "data_type": "string"
        }
      ],
      "rows": [
        [
          null
        ]
      ],
      "items": [
        {}
      ],
      "series": [
        {
          "date": "string",
          "metrics": {}
        }
      ]
    }
  },
  "errors": {
    "key": {
      "code": "string",
      "message": "string"
    }
  }
}
```

## YouTube: Get Video analytics

`GET /accounts/{accountId}/youtube/analytics-video`

Per-video analytics (Zernio daily-views + more) · quota: 2 units + 4 analytics queries (videos.list, analytics.reports.query). One video: daily views/watch time/engagement, traffic sources, retention, demographics. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/channel_reports#video-reports Generic route: /v1/accounts/{accountId}/focus/analytics-video.

Access: `read` · MCP tool: `youtube-analytics-video-get` · Zernio: `GET /v1/analytics/youtube/daily-views`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 28 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)
- `video_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-video" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "video_id": "string",
  "daily": {},
  "sections": {},
  "errors": {}
}
```

## YouTube: Get Audience retention

`GET /accounts/{accountId}/youtube/analytics-retention`

Retention curve · quota: 1 unit + 1 analytics query (videos.list, analytics.reports.query). audienceWatchRatio by elapsedVideoTimeRatio (100 points), relative retention, started/stopped watching. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/channel_reports#audience-retention-reports Generic route: /v1/accounts/{accountId}/focus/analytics-retention.

Access: `read` · MCP tool: `youtube-analytics-retention-get` · Zernio: `GET /v1/analytics/youtube/video-retention`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 28 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)
- `video_id` (string)
- `audience_type` (string; one of ORGANIC, AD_INSTREAM, AD_INDISPLAY)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-retention" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "videoId": "string",
  "title": "string",
  "durationSeconds": 1,
  "retentionCurve": [
    {
      "elapsedVideoTimeRatio": 1.5,
      "audienceWatchRatio": 1.5,
      "relativeRetentionPerformance": 1.5,
      "startedWatching": 1.5,
      "stoppedWatching": 1.5,
      "totalSegmentImpressions": 1.5
    }
  ]
}
```

## YouTube: Get Playlist analytics

`GET /accounts/{accountId}/youtube/analytics-playlists`

Playlist analytics: top_playlists, playlist_daily · quota: 2 analytics queries (analytics.reports.query). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-playlists.

Access: `read` · MCP tool: `youtube-analytics-playlists-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 28 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)
- `video_id` (string): Filter to one video
- `playlist_id` (string)
- `group_id` (string): Analytics group
- `country` (string): ISO 3166-1 alpha-2
- `creator_content_type` (string; one of SHORTS, VIDEO_ON_DEMAND, LIVE_STREAM, STORY)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-playlists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "since": "2026-10-13",
  "until": "2026-10-13",
  "sections": {
    "key": {
      "report": "string",
      "label": "string",
      "columns": [
        {
          "name": "string",
          "type": "dimension",
          "data_type": "string"
        }
      ],
      "rows": [
        [
          null
        ]
      ],
      "items": [
        {}
      ],
      "series": [
        {
          "date": "string",
          "metrics": {}
        }
      ]
    }
  },
  "errors": {
    "key": {
      "code": "string",
      "message": "string"
    }
  }
}
```

## YouTube: Get Live analytics

`GET /accounts/{accountId}/youtube/analytics-live`

Live analytics: live_vs_on_demand, concurrent, summary · quota: 3 analytics queries (analytics.reports.query). Live vs on-demand; concurrent viewers for a stream (video_id). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-live.

Access: `read` · MCP tool: `youtube-analytics-live-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 28 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)
- `video_id` (string): Filter to one video
- `playlist_id` (string)
- `group_id` (string): Analytics group
- `country` (string): ISO 3166-1 alpha-2
- `creator_content_type` (string; one of SHORTS, VIDEO_ON_DEMAND, LIVE_STREAM, STORY)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-live" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "since": "2026-10-13",
  "until": "2026-10-13",
  "sections": {
    "key": {
      "report": "string",
      "label": "string",
      "columns": [
        {
          "name": "string",
          "type": "dimension",
          "data_type": "string"
        }
      ],
      "rows": [
        [
          null
        ]
      ],
      "items": [
        {}
      ],
      "series": [
        {
          "date": "string",
          "metrics": {}
        }
      ]
    }
  },
  "errors": {
    "key": {
      "code": "string",
      "message": "string"
    }
  }
}
```

## YouTube: Get Report builder

`GET /accounts/{accountId}/youtube/analytics-report`

Run a report · quota: 1 analytics query (analytics.reports.query). Any named report (54) or a custom reports.query (metrics/dimensions/filters/sort). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/reports/query Generic route: /v1/accounts/{accountId}/focus/analytics-report.

Access: `read` · MCP tool: `youtube-analytics-report-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 28 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)
- `video_id` (string): Filter to one video
- `playlist_id` (string)
- `group_id` (string): Analytics group
- `country` (string): ISO 3166-1 alpha-2
- `creator_content_type` (string; one of SHORTS, VIDEO_ON_DEMAND, LIVE_STREAM, STORY)
- `report` (string; one of overview, daily, monthly, engaged-views, engagement, watch-time, subscribers, subscribers-by-video, top-videos, traffic-sources, traffic-sources-daily, traffic-source-detail, …)
- `metrics` (string): custom: comma-separated metrics
- `dimensions` (string)
- `filters` (string): dim==value;dim2==a,b
- `sort` (string)
- `max_results` (integer; 1–250)
- `currency` (string): ISO 4217 for revenue reports
- `source_type` (string): traffic-source-detail: insightTrafficSourceType
- `report_type_id` (string): bulk: Reporting API report type
- `create_job` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-report" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "report": "string",
  "label": "string",
  "since": "string",
  "until": "string",
  "columns": [
    {
      "name": "string",
      "type": "string",
      "data_type": "string"
    }
  ],
  "rows": [
    [
      null
    ]
  ],
  "items": [
    {}
  ]
}
```

## YouTube: List Analytics groups

`GET /accounts/{accountId}/youtube/analytics-groups`

Groups · quota: 1 analytics query (analytics.groups.list). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: /v1/accounts/{accountId}/focus/analytics-groups.

Access: `read` · MCP tool: `youtube-analytics-groups-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-groups" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "item_type": "youtube#video",
      "item_count": 1,
      "published_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Analytics groups item

`POST /accounts/{accountId}/youtube/analytics-groups`

Create group · quota: 1 analytics query (analytics.groups.insert). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: /v1/accounts/{accountId}/focus/analytics-groups.

Access: `write` · MCP tool: `youtube-analytics-groups-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `title` (string; required)
- `item_type` (string; one of youtube#video, youtube#playlist, youtube#channel, youtubePartner#asset)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-groups" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "item_type": "youtube#video"
  }'
```

Response 201:

```json
{
  "id": "string",
  "title": "string",
  "item_type": "youtube#video",
  "item_count": 1,
  "published_at": "2026-10-13T09:00:00.000Z"
}
```

## YouTube: Get a Analytics groups item

`GET /accounts/{accountId}/youtube/analytics-groups/{itemId}`

Group · quota: 1 analytics query (analytics.groups.list). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: /v1/accounts/{accountId}/focus/analytics-groups.

Access: `read` · MCP tool: `youtube-analytics-groups-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-groups/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "item_type": "youtube#video",
  "item_count": 1,
  "published_at": "2026-10-13T09:00:00.000Z"
}
```

## YouTube: Update a Analytics groups item

`PATCH /accounts/{accountId}/youtube/analytics-groups/{itemId}`

Rename group · quota: 1 analytics query (analytics.groups.update). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: /v1/accounts/{accountId}/focus/analytics-groups.

Access: `write` · MCP tool: `youtube-analytics-groups-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `title` (string; required)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-groups/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "item_type": "youtube#video",
  "item_count": 1,
  "published_at": "2026-10-13T09:00:00.000Z"
}
```

## YouTube: Delete a Analytics groups item

`DELETE /accounts/{accountId}/youtube/analytics-groups/{itemId}`

Delete group · quota: 1 analytics query (analytics.groups.delete). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: /v1/accounts/{accountId}/focus/analytics-groups.

Access: `write` · MCP tool: `youtube-analytics-groups-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-groups/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: Add item (Analytics groups)

`POST /accounts/{accountId}/youtube/analytics-groups/{itemId}/add-item`

Add a video/playlist/channel · quota: 1 analytics query (analytics.groupItems.insert). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: /v1/accounts/{accountId}/focus/analytics-groups.

Access: `write` · MCP tool: `youtube-analytics-groups-add-item`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `resource_id` (string; required)
- `kind` (string; one of youtube#video, youtube#playlist, youtube#channel, youtubePartner#asset)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-groups/ITEM_ID/add-item" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "resource_id": "string",
    "kind": "youtube#video"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Group items

`GET /accounts/{accountId}/youtube/analytics-group-items`

Items in a group · quota: 1 analytics query (analytics.groupItems.list). Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groupItems Generic route: /v1/accounts/{accountId}/focus/analytics-group-items.

Access: `read` · MCP tool: `youtube-analytics-group-items-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `group_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-group-items?group_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "group_id": "string",
      "kind": "youtube#video",
      "resource_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Group items item

`POST /accounts/{accountId}/youtube/analytics-group-items`

Add item · quota: 1 analytics query (analytics.groupItems.insert). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groupItems Generic route: /v1/accounts/{accountId}/focus/analytics-group-items.

Access: `write` · MCP tool: `youtube-analytics-group-items-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `group_id` (string; required)
- `resource_id` (string; required)
- `kind` (string; one of youtube#video, youtube#playlist, youtube#channel, youtubePartner#asset)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-group-items" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "group_id": "string",
    "resource_id": "string",
    "kind": "youtube#video"
  }'
```

Response 201:

```json
{
  "id": "string",
  "group_id": "string",
  "kind": "youtube#video",
  "resource_id": "string"
}
```

## YouTube: Delete a Group items item

`DELETE /accounts/{accountId}/youtube/analytics-group-items/{itemId}`

Remove item · quota: 1 analytics query (analytics.groupItems.delete). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groupItems Generic route: /v1/accounts/{accountId}/focus/analytics-group-items.

Access: `write` · MCP tool: `youtube-analytics-group-items-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-group-items/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: List Bulk report types

`GET /accounts/{accountId}/youtube/report-types`

Reporting API report types · quota: 1 reporting query (reporting.reportTypes.list). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: /v1/accounts/{accountId}/focus/report-types.

Access: `read` · MCP tool: `youtube-report-types-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `include_system_managed` (boolean)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/report-types" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "system_managed": true,
      "deprecate_time": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: List Bulk report jobs

`GET /accounts/{accountId}/youtube/reporting-jobs`

Jobs · quota: 1 reporting query (reporting.jobs.list). One job per report type; daily CSVs arrive ~48 h after creation (30-day backfill, 60-day retention). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: /v1/accounts/{accountId}/focus/reporting-jobs.

Access: `read` · MCP tool: `youtube-reporting-jobs-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `include_system_managed` (boolean)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/reporting-jobs" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "report_type_id": "string",
      "name": "string",
      "create_time": "2026-10-13T09:00:00.000Z",
      "expire_time": "2026-10-13T09:00:00.000Z",
      "system_managed": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Bulk report jobs item

`POST /accounts/{accountId}/youtube/reporting-jobs`

Create job · quota: 1 reporting query (reporting.jobs.create). One job per report type; daily CSVs arrive ~48 h after creation (30-day backfill, 60-day retention). Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: /v1/accounts/{accountId}/focus/reporting-jobs.

Access: `write` · MCP tool: `youtube-reporting-jobs-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `report_type_id` (string; required): e.g. channel_reach_basic_a1, channel_basic_a3
- `name` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/reporting-jobs" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "report_type_id": "string",
    "name": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "report_type_id": "string",
  "name": "string",
  "create_time": "2026-10-13T09:00:00.000Z",
  "expire_time": "2026-10-13T09:00:00.000Z",
  "system_managed": true
}
```

## YouTube: Delete a Bulk report jobs item

`DELETE /accounts/{accountId}/youtube/reporting-jobs/{itemId}`

Delete job · quota: 1 reporting query (reporting.jobs.delete). One job per report type; daily CSVs arrive ~48 h after creation (30-day backfill, 60-day retention). Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: /v1/accounts/{accountId}/focus/reporting-jobs.

Access: `write` · MCP tool: `youtube-reporting-jobs-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/reporting-jobs/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: List reports (Bulk report jobs)

`POST /accounts/{accountId}/youtube/reporting-jobs/{itemId}/reports`

Generated daily reports · quota: 1 reporting query (reporting.jobs.reports.list). One job per report type; daily CSVs arrive ~48 h after creation (30-day backfill, 60-day retention). Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: /v1/accounts/{accountId}/focus/reporting-jobs.

Access: `write` · MCP tool: `youtube-reporting-jobs-reports`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/reporting-jobs/ITEM_ID/reports" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Bulk reports

`GET /accounts/{accountId}/youtube/reporting-reports`

Reports of a job · quota: 1 reporting query (reporting.jobs.reports.list). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: /v1/accounts/{accountId}/focus/reporting-reports.

Access: `read` · MCP tool: `youtube-reporting-reports-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `job_id` (string; required)
- `created_after` (string (date-time))
- `since` (string (date))
- `until` (string (date))
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/reporting-reports?job_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "job_id": "string",
      "start_time": "2026-10-13T09:00:00.000Z",
      "end_time": "2026-10-13T09:00:00.000Z",
      "create_time": "2026-10-13T09:00:00.000Z",
      "download_url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Download CSV (Bulk reports)

`POST /accounts/{accountId}/youtube/reporting-reports/{itemId}/download`

Download and parse the report · quota: 2 reporting queries (reporting.jobs.reports.get, reporting.media.download). Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: /v1/accounts/{accountId}/focus/reporting-reports.

Access: `write` · MCP tool: `youtube-reporting-reports-download`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `job_id` (string; required)
- `parse` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/reporting-reports/ITEM_ID/download" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": "string",
    "parse": true
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Comments

`GET /accounts/{accountId}/youtube/comments`

Comment threads (5 replies inline; channel-wide by default) · quota: 1 unit (commentThreads.list). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `read` · MCP tool: `youtube-comments-list` · Zernio: `GET /v1/inbox/comments`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `video_id` (string)
- `moderation_status` (string; one of published, heldForReview, likelySpam)
- `order` (string; one of time, relevance)
- `search_terms` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "text_html": "string",
      "author": "string",
      "author_id": "string",
      "author_avatar_url": "https://example.com",
      "author_url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "post_id": "string",
      "thread_id": "string",
      "parent_id": "string",
      "is_reply": true,
      "reply_count": 1,
      "can_reply": true,
      "moderation_status": "published",
      "image_url": "https://example.com",
      "is_own": true,
      "replies": [
        {
          "id": "string",
          "text": "string",
          "text_html": "string",
          "author": "string",
          "author_id": "string",
          "author_avatar_url": "https://example.com"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Comments item

`POST /accounts/{accountId}/youtube/comments`

Post a top-level comment on a video · quota: 50 units (commentThreads.insert). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `youtube-comments-create` · Zernio: `POST /v1/inbox/comments/{postId}`, `POST /v1/inbox/comments/{postId}/{commentId}/moderation`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `video_id` (string; required)
- `text` (string; required; ≤ 10000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "video_id": "string",
    "text": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "text": "string",
  "text_html": "string",
  "author": "string",
  "author_id": "string",
  "author_avatar_url": "https://example.com",
  "author_url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "post_id": "string",
  "thread_id": "string",
  "parent_id": "string",
  "is_reply": true,
  "reply_count": 1,
  "can_reply": true,
  "moderation_status": "published",
  "image_url": "https://example.com",
  "is_own": true,
  "replies": [
    {
      "id": "string",
      "text": "string",
      "text_html": "string",
      "author": "string",
      "author_id": "string",
      "author_avatar_url": "https://example.com",
      "author_url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "post_id": "string",
      "thread_id": "string",
      "parent_id": "string",
      "is_reply": true,
      "reply_count": 1,
      "can_reply": true,
      "moderation_status": "published",
      "image_url": "https://example.com",
      "is_own": true
    }
  ]
}
```

## YouTube: Get a Comments item

`GET /accounts/{accountId}/youtube/comments/{itemId}`

A comment · quota: 1 unit (comments.list). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `read` · MCP tool: `youtube-comments-get` · Zernio: `GET /v1/inbox/comments/{postId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "text": "string",
  "text_html": "string",
  "author": "string",
  "author_id": "string",
  "author_avatar_url": "https://example.com",
  "author_url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "post_id": "string",
  "thread_id": "string",
  "parent_id": "string",
  "is_reply": true,
  "reply_count": 1,
  "can_reply": true,
  "moderation_status": "published",
  "image_url": "https://example.com",
  "is_own": true,
  "replies": [
    {
      "id": "string",
      "text": "string",
      "text_html": "string",
      "author": "string",
      "author_id": "string",
      "author_avatar_url": "https://example.com",
      "author_url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "post_id": "string",
      "thread_id": "string",
      "parent_id": "string",
      "is_reply": true,
      "reply_count": 1,
      "can_reply": true,
      "moderation_status": "published",
      "image_url": "https://example.com",
      "is_own": true
    }
  ]
}
```

## YouTube: Update a Comments item

`PATCH /accounts/{accountId}/youtube/comments/{itemId}`

Edit own comment · quota: 50 units (comments.update). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `youtube-comments-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `text` (string; required; ≤ 10000 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "text": "string",
  "text_html": "string",
  "author": "string",
  "author_id": "string",
  "author_avatar_url": "https://example.com",
  "author_url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "post_id": "string",
  "thread_id": "string",
  "parent_id": "string",
  "is_reply": true,
  "reply_count": 1,
  "can_reply": true,
  "moderation_status": "published",
  "image_url": "https://example.com",
  "is_own": true,
  "replies": [
    {
      "id": "string",
      "text": "string",
      "text_html": "string",
      "author": "string",
      "author_id": "string",
      "author_avatar_url": "https://example.com",
      "author_url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "post_id": "string",
      "thread_id": "string",
      "parent_id": "string",
      "is_reply": true,
      "reply_count": 1,
      "can_reply": true,
      "moderation_status": "published",
      "image_url": "https://example.com",
      "is_own": true
    }
  ]
}
```

## YouTube: Delete a Comments item

`DELETE /accounts/{accountId}/youtube/comments/{itemId}`

Delete own comment (use reject for others) · quota: 50 units (comments.delete). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `youtube-comments-delete` · Zernio: `DELETE /v1/inbox/comments/{postId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: Reply (Comments)

`POST /accounts/{accountId}/youtube/comments/{itemId}/reply`

Reply as the channel · quota: 50 units (comments.insert). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `youtube-comments-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `text` (string; required; ≤ 10000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comments/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Approve (Comments)

`POST /accounts/{accountId}/youtube/comments/{itemId}/approve`

Publish a held / likely-spam comment · quota: 50 units (comments.setModerationStatus). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `youtube-comments-approve`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comments/ITEM_ID/approve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Hold for review (Comments)

`POST /accounts/{accountId}/youtube/comments/{itemId}/hold`

Move to the held-for-review queue · quota: 50 units (comments.setModerationStatus). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `youtube-comments-hold`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comments/ITEM_ID/hold" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Hide (reject) (Comments)

`POST /accounts/{accountId}/youtube/comments/{itemId}/reject`

Reject = hide from the channel; cannot be republished. Optionally ban the author. · quota: 50 units (comments.setModerationStatus). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `youtube-comments-reject`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `ban_author` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comments/ITEM_ID/reject" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ban_author": false
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Hide & ban author (Comments)

`POST /accounts/{accountId}/youtube/comments/{itemId}/ban-author`

Reject and ban the author from commenting on the channel · quota: 50 units (comments.setModerationStatus). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `youtube-comments-ban-author`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comments/ITEM_ID/ban-author" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Replies

`GET /accounts/{accountId}/youtube/comment-replies`

Replies to a comment · quota: 1 unit (comments.list). Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.

Access: `read` · MCP tool: `youtube-comment-replies-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `parent_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comment-replies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "text_html": "string",
      "author": "string",
      "author_id": "string",
      "author_avatar_url": "https://example.com",
      "author_url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "post_id": "string",
      "thread_id": "string",
      "parent_id": "string",
      "is_reply": true,
      "reply_count": 1,
      "can_reply": true,
      "moderation_status": "published",
      "image_url": "https://example.com",
      "is_own": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Replies item

`POST /accounts/{accountId}/youtube/comment-replies`

Reply · quota: 50 units (comments.insert). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.

Access: `write` · MCP tool: `youtube-comment-replies-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `parent_id` (string; required)
- `text` (string; required; ≤ 10000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comment-replies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "parent_id": "string",
    "text": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "text": "string",
  "text_html": "string",
  "author": "string",
  "author_id": "string",
  "author_avatar_url": "https://example.com",
  "author_url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "post_id": "string",
  "thread_id": "string",
  "parent_id": "string",
  "is_reply": true,
  "reply_count": 1,
  "can_reply": true,
  "moderation_status": "published",
  "image_url": "https://example.com",
  "is_own": true
}
```

## YouTube: Update a Replies item

`PATCH /accounts/{accountId}/youtube/comment-replies/{itemId}`

Edit own comment · quota: 50 units (comments.update). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.

Access: `write` · MCP tool: `youtube-comment-replies-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `text` (string; required; ≤ 10000 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comment-replies/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "text": "string",
  "text_html": "string",
  "author": "string",
  "author_id": "string",
  "author_avatar_url": "https://example.com",
  "author_url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "post_id": "string",
  "thread_id": "string",
  "parent_id": "string",
  "is_reply": true,
  "reply_count": 1,
  "can_reply": true,
  "moderation_status": "published",
  "image_url": "https://example.com",
  "is_own": true
}
```

## YouTube: Delete a Replies item

`DELETE /accounts/{accountId}/youtube/comment-replies/{itemId}`

Delete own comment (use reject for others) · quota: 50 units (comments.delete). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.

Access: `write` · MCP tool: `youtube-comment-replies-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comment-replies/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: Approve (Replies)

`POST /accounts/{accountId}/youtube/comment-replies/{itemId}/approve`

Publish a held / likely-spam comment · quota: 50 units (comments.setModerationStatus). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.

Access: `write` · MCP tool: `youtube-comment-replies-approve`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comment-replies/ITEM_ID/approve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Hold for review (Replies)

`POST /accounts/{accountId}/youtube/comment-replies/{itemId}/hold`

Move to the held-for-review queue · quota: 50 units (comments.setModerationStatus). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.

Access: `write` · MCP tool: `youtube-comment-replies-hold`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comment-replies/ITEM_ID/hold" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Hide (reject) (Replies)

`POST /accounts/{accountId}/youtube/comment-replies/{itemId}/reject`

Reject = hide from the channel; cannot be republished. Optionally ban the author. · quota: 50 units (comments.setModerationStatus). Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.

Access: `write` · MCP tool: `youtube-comment-replies-reject`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `ban_author` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comment-replies/ITEM_ID/reject" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ban_author": false
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Hide & ban author (Replies)

`POST /accounts/{accountId}/youtube/comment-replies/{itemId}/ban-author`

Reject and ban the author from commenting on the channel · quota: 50 units (comments.setModerationStatus). Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.

Access: `write` · MCP tool: `youtube-comment-replies-ban-author`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comment-replies/ITEM_ID/ban-author" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Held for review

`GET /accounts/{accountId}/youtube/held-for-review`

Moderation queue · quota: 1 unit (commentThreads.list). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: /v1/accounts/{accountId}/focus/held-for-review.

Access: `read` · MCP tool: `youtube-held-for-review-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `queue` (string; one of heldForReview, likelySpam)
- `video_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/held-for-review" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "text_html": "string",
      "author": "string",
      "author_id": "string",
      "author_avatar_url": "https://example.com",
      "author_url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "post_id": "string",
      "thread_id": "string",
      "parent_id": "string",
      "is_reply": true,
      "reply_count": 1,
      "can_reply": true,
      "moderation_status": "published",
      "image_url": "https://example.com",
      "is_own": true,
      "replies": [
        {
          "id": "string",
          "text": "string",
          "text_html": "string",
          "author": "string",
          "author_id": "string",
          "author_avatar_url": "https://example.com"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Reply (Held for review)

`POST /accounts/{accountId}/youtube/held-for-review/{itemId}/reply`

Reply as the channel · quota: 50 units (comments.insert). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: /v1/accounts/{accountId}/focus/held-for-review.

Access: `write` · MCP tool: `youtube-held-for-review-reply` · Zernio: `POST /v1/inbox/comments/{postId}/{commentId}/moderation`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `text` (string; required; ≤ 10000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/held-for-review/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Approve (Held for review)

`POST /accounts/{accountId}/youtube/held-for-review/{itemId}/approve`

Publish a held / likely-spam comment · quota: 50 units (comments.setModerationStatus). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: /v1/accounts/{accountId}/focus/held-for-review.

Access: `write` · MCP tool: `youtube-held-for-review-approve`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/held-for-review/ITEM_ID/approve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Hold for review (Held for review)

`POST /accounts/{accountId}/youtube/held-for-review/{itemId}/hold`

Move to the held-for-review queue · quota: 50 units (comments.setModerationStatus). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: /v1/accounts/{accountId}/focus/held-for-review.

Access: `write` · MCP tool: `youtube-held-for-review-hold`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/held-for-review/ITEM_ID/hold" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Hide (reject) (Held for review)

`POST /accounts/{accountId}/youtube/held-for-review/{itemId}/reject`

Reject = hide from the channel; cannot be republished. Optionally ban the author. · quota: 50 units (comments.setModerationStatus). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: /v1/accounts/{accountId}/focus/held-for-review.

Access: `write` · MCP tool: `youtube-held-for-review-reject`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `ban_author` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/held-for-review/ITEM_ID/reject" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ban_author": false
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Hide & ban author (Held for review)

`POST /accounts/{accountId}/youtube/held-for-review/{itemId}/ban-author`

Reject and ban the author from commenting on the channel · quota: 50 units (comments.setModerationStatus). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: /v1/accounts/{accountId}/focus/held-for-review.

Access: `write` · MCP tool: `youtube-held-for-review-ban-author`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/held-for-review/ITEM_ID/ban-author" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Bulk moderate (Held for review)

`POST /accounts/{accountId}/youtube/held-for-review/bulk-moderate`

Approve/hold/reject up to 50 comments per call · quota: 50 units (comments.setModerationStatus). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: /v1/accounts/{accountId}/focus/held-for-review.

Access: `write` · MCP tool: `youtube-held-for-review-bulk-moderate`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `ids` (array of string; required; ≥ 1 items)
- `moderation_status` (string; required; one of published, heldForReview, rejected)
- `ban_author` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/held-for-review/bulk-moderate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "string"
    ],
    "moderation_status": "published",
    "ban_author": false
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Live broadcasts

`GET /accounts/{accountId}/youtube/live-broadcasts`

Broadcasts · quota: 1 unit (liveBroadcasts.list). Schedule, bind to a stream, test → go live → end, insert ad breaks. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.

Access: `read` · MCP tool: `youtube-live-broadcasts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–50)
- `cursor` (string)
- `status` (string; one of all, active, completed, upcoming)
- `type` (string; one of all, event, persistent)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-broadcasts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "scheduled_start_time": "2026-10-13T09:00:00.000Z",
      "scheduled_end_time": "2026-10-13T09:00:00.000Z",
      "actual_start_time": "2026-10-13T09:00:00.000Z",
      "actual_end_time": "2026-10-13T09:00:00.000Z",
      "privacy_status": "public",
      "self_declared_made_for_kids": true,
      "life_cycle_status": "complete",
      "recording_status": "string",
      "bound_stream_id": "string",
      "live_chat_id": "string",
      "enable_auto_start": true,
      "enable_auto_stop": true,
      "enable_dvr": true,
      "enable_embed": true,
      "record_from_start": true,
      "enable_closed_captions": true,
      "closed_captions_type": "closedCaptionsDisabled",
      "latency_preference": "normal",
      "projection": "rectangular",
      "enable_monitor_stream": true,
      "broadcast_stream_delay_ms": 0,
      "thumbnail_url": "https://example.com",
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Live broadcasts item

`POST /accounts/{accountId}/youtube/live-broadcasts`

Create / schedule · quota: 1 unit (liveBroadcasts.insert). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.

Access: `write` · MCP tool: `youtube-live-broadcasts-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `title` (string; required; ≤ 100 characters)
- `description` (string; ≤ 5000 characters)
- `scheduled_start_time` (string (date-time); required)
- `scheduled_end_time` (string (date-time) | null)
- `privacy_status` (string; one of public, unlisted, private)
- `self_declared_made_for_kids` (boolean)
- `enable_auto_start` (boolean)
- `enable_auto_stop` (boolean)
- `enable_dvr` (boolean)
- `enable_embed` (boolean)
- `record_from_start` (boolean)
- `enable_closed_captions` (boolean)
- `closed_captions_type` (string; one of closedCaptionsDisabled, closedCaptionsHttpPost, closedCaptionsEmbedded)
- `latency_preference` (string; one of normal, low, ultraLow)
- `projection` (string; one of rectangular, 360)
- `enable_monitor_stream` (boolean)
- `broadcast_stream_delay_ms` (integer)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-broadcasts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "scheduled_start_time": "2026-10-13T09:00:00.000Z",
    "scheduled_end_time": "2026-10-13T09:00:00.000Z",
    "privacy_status": "public"
  }'
```

Response 201:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "scheduled_start_time": "2026-10-13T09:00:00.000Z",
  "scheduled_end_time": "2026-10-13T09:00:00.000Z",
  "actual_start_time": "2026-10-13T09:00:00.000Z",
  "actual_end_time": "2026-10-13T09:00:00.000Z",
  "privacy_status": "public",
  "self_declared_made_for_kids": true,
  "life_cycle_status": "complete",
  "recording_status": "string",
  "bound_stream_id": "string",
  "live_chat_id": "string",
  "enable_auto_start": true,
  "enable_auto_stop": true,
  "enable_dvr": true,
  "enable_embed": true,
  "record_from_start": true,
  "enable_closed_captions": true,
  "closed_captions_type": "closedCaptionsDisabled",
  "latency_preference": "normal",
  "projection": "rectangular",
  "enable_monitor_stream": true,
  "broadcast_stream_delay_ms": 0,
  "thumbnail_url": "https://example.com",
  "url": "https://example.com"
}
```

## YouTube: Get a Live broadcasts item

`GET /accounts/{accountId}/youtube/live-broadcasts/{itemId}`

Broadcast · quota: 1 unit (liveBroadcasts.list). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.

Access: `read` · MCP tool: `youtube-live-broadcasts-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-broadcasts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "scheduled_start_time": "2026-10-13T09:00:00.000Z",
  "scheduled_end_time": "2026-10-13T09:00:00.000Z",
  "actual_start_time": "2026-10-13T09:00:00.000Z",
  "actual_end_time": "2026-10-13T09:00:00.000Z",
  "privacy_status": "public",
  "self_declared_made_for_kids": true,
  "life_cycle_status": "complete",
  "recording_status": "string",
  "bound_stream_id": "string",
  "live_chat_id": "string",
  "enable_auto_start": true,
  "enable_auto_stop": true,
  "enable_dvr": true,
  "enable_embed": true,
  "record_from_start": true,
  "enable_closed_captions": true,
  "closed_captions_type": "closedCaptionsDisabled",
  "latency_preference": "normal",
  "projection": "rectangular",
  "enable_monitor_stream": true,
  "broadcast_stream_delay_ms": 0,
  "thumbnail_url": "https://example.com",
  "url": "https://example.com"
}
```

## YouTube: Update a Live broadcasts item

`PATCH /accounts/{accountId}/youtube/live-broadcasts/{itemId}`

Edit · quota: 2 units (liveBroadcasts.list, liveBroadcasts.update). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.

Access: `write` · MCP tool: `youtube-live-broadcasts-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `title` (string; ≤ 100 characters)
- `description` (string; ≤ 5000 characters)
- `scheduled_start_time` (string (date-time))
- `scheduled_end_time` (string (date-time) | null)
- `privacy_status` (string; one of public, unlisted, private)
- `self_declared_made_for_kids` (boolean)
- `enable_auto_start` (boolean)
- `enable_auto_stop` (boolean)
- `enable_dvr` (boolean)
- `enable_embed` (boolean)
- `record_from_start` (boolean)
- `enable_closed_captions` (boolean)
- `closed_captions_type` (string; one of closedCaptionsDisabled, closedCaptionsHttpPost, closedCaptionsEmbedded)
- `latency_preference` (string; one of normal, low, ultraLow)
- `projection` (string; one of rectangular, 360)
- `enable_monitor_stream` (boolean)
- `broadcast_stream_delay_ms` (integer)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-broadcasts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "scheduled_start_time": "2026-10-13T09:00:00.000Z",
    "scheduled_end_time": "2026-10-13T09:00:00.000Z",
    "privacy_status": "public"
  }'
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "scheduled_start_time": "2026-10-13T09:00:00.000Z",
  "scheduled_end_time": "2026-10-13T09:00:00.000Z",
  "actual_start_time": "2026-10-13T09:00:00.000Z",
  "actual_end_time": "2026-10-13T09:00:00.000Z",
  "privacy_status": "public",
  "self_declared_made_for_kids": true,
  "life_cycle_status": "complete",
  "recording_status": "string",
  "bound_stream_id": "string",
  "live_chat_id": "string",
  "enable_auto_start": true,
  "enable_auto_stop": true,
  "enable_dvr": true,
  "enable_embed": true,
  "record_from_start": true,
  "enable_closed_captions": true,
  "closed_captions_type": "closedCaptionsDisabled",
  "latency_preference": "normal",
  "projection": "rectangular",
  "enable_monitor_stream": true,
  "broadcast_stream_delay_ms": 0,
  "thumbnail_url": "https://example.com",
  "url": "https://example.com"
}
```

## YouTube: Delete a Live broadcasts item

`DELETE /accounts/{accountId}/youtube/live-broadcasts/{itemId}`

Delete · quota: 1 unit (liveBroadcasts.delete). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.

Access: `write` · MCP tool: `youtube-live-broadcasts-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-broadcasts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: Bind stream (Live broadcasts)

`POST /accounts/{accountId}/youtube/live-broadcasts/{itemId}/bind`

Attach an ingestion stream · quota: 1 unit (liveBroadcasts.bind). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.

Access: `write` · MCP tool: `youtube-live-broadcasts-bind`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `stream_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-broadcasts/ITEM_ID/bind" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "stream_id": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Unbind stream (Live broadcasts)

`POST /accounts/{accountId}/youtube/live-broadcasts/{itemId}/unbind`

Detach the stream · quota: 1 unit (liveBroadcasts.bind). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.

Access: `write` · MCP tool: `youtube-live-broadcasts-unbind`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-broadcasts/ITEM_ID/unbind" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Start test (Live broadcasts)

`POST /accounts/{accountId}/youtube/live-broadcasts/{itemId}/test`

Transition to testing (monitor stream must be enabled) · quota: 1 unit (liveBroadcasts.transition). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.

Access: `write` · MCP tool: `youtube-live-broadcasts-test`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-broadcasts/ITEM_ID/test" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Go live (Live broadcasts)

`POST /accounts/{accountId}/youtube/live-broadcasts/{itemId}/go-live`

Transition to live · quota: 1 unit (liveBroadcasts.transition). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.

Access: `write` · MCP tool: `youtube-live-broadcasts-go-live`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-broadcasts/ITEM_ID/go-live" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: End broadcast (Live broadcasts)

`POST /accounts/{accountId}/youtube/live-broadcasts/{itemId}/end`

Transition to complete · quota: 1 unit (liveBroadcasts.transition). Schedule, bind to a stream, test → go live → end, insert ad breaks. Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.

Access: `write` · MCP tool: `youtube-live-broadcasts-end`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-broadcasts/ITEM_ID/end" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Insert ad break (Live broadcasts)

`POST /accounts/{accountId}/youtube/live-broadcasts/{itemId}/insert-cuepoint`

Cuepoint (monetised live streams) · quota: 1 unit (liveBroadcasts.cuepoint). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.

Access: `write` · MCP tool: `youtube-live-broadcasts-insert-cuepoint`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `duration_secs` (integer; ≥ 1)
- `insertion_offset_time_ms` (integer)
- `walltime_ms` (integer)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-broadcasts/ITEM_ID/insert-cuepoint" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "duration_secs": 30,
    "insertion_offset_time_ms": 0,
    "walltime_ms": 1
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Streams (ingest)

`GET /accounts/{accountId}/youtube/live-streams`

Streams · quota: 1 unit (liveStreams.list). RTMP/HLS/DASH/WebRTC ingestion points with stream keys and health. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveStreams Generic route: /v1/accounts/{accountId}/focus/live-streams.

Access: `read` · MCP tool: `youtube-live-streams-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–50)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-streams" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "ingestion_type": "rtmp",
      "resolution": "variable",
      "frame_rate": "variable",
      "is_reusable": true,
      "stream_name": "string",
      "ingestion_address": "https://example.com",
      "backup_ingestion_address": "https://example.com",
      "rtmps_ingestion_address": "https://example.com",
      "stream_status": "string",
      "health_status": "string",
      "health_issues": [
        {}
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Streams (ingest) item

`POST /accounts/{accountId}/youtube/live-streams`

Create stream · quota: 1 unit (liveStreams.insert). RTMP/HLS/DASH/WebRTC ingestion points with stream keys and health. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveStreams Generic route: /v1/accounts/{accountId}/focus/live-streams.

Access: `write` · MCP tool: `youtube-live-streams-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `title` (string; required)
- `description` (string)
- `ingestion_type` (string; one of rtmp, dash, webrtc, hls)
- `resolution` (string; one of variable, 240p, 360p, 480p, 720p, 1080p, 1440p, 2160p)
- `frame_rate` (string; one of variable, 30fps, 60fps)
- `is_reusable` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-streams" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "ingestion_type": "rtmp",
    "resolution": "variable",
    "frame_rate": "variable"
  }'
```

Response 201:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "ingestion_type": "rtmp",
  "resolution": "variable",
  "frame_rate": "variable",
  "is_reusable": true,
  "stream_name": "string",
  "ingestion_address": "https://example.com",
  "backup_ingestion_address": "https://example.com",
  "rtmps_ingestion_address": "https://example.com",
  "stream_status": "string",
  "health_status": "string",
  "health_issues": [
    {}
  ]
}
```

## YouTube: Get a Streams (ingest) item

`GET /accounts/{accountId}/youtube/live-streams/{itemId}`

Stream · quota: 1 unit (liveStreams.list). RTMP/HLS/DASH/WebRTC ingestion points with stream keys and health. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveStreams Generic route: /v1/accounts/{accountId}/focus/live-streams.

Access: `read` · MCP tool: `youtube-live-streams-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-streams/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "ingestion_type": "rtmp",
  "resolution": "variable",
  "frame_rate": "variable",
  "is_reusable": true,
  "stream_name": "string",
  "ingestion_address": "https://example.com",
  "backup_ingestion_address": "https://example.com",
  "rtmps_ingestion_address": "https://example.com",
  "stream_status": "string",
  "health_status": "string",
  "health_issues": [
    {}
  ]
}
```

## YouTube: Update a Streams (ingest) item

`PATCH /accounts/{accountId}/youtube/live-streams/{itemId}`

Edit stream · quota: 2 units (liveStreams.list, liveStreams.update). RTMP/HLS/DASH/WebRTC ingestion points with stream keys and health. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveStreams Generic route: /v1/accounts/{accountId}/focus/live-streams.

Access: `write` · MCP tool: `youtube-live-streams-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `title` (string)
- `description` (string)
- `resolution` (string; one of variable, 240p, 360p, 480p, 720p, 1080p, 1440p, 2160p)
- `frame_rate` (string; one of variable, 30fps, 60fps)
- `is_reusable` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-streams/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "resolution": "variable",
    "frame_rate": "variable",
    "is_reusable": true
  }'
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "ingestion_type": "rtmp",
  "resolution": "variable",
  "frame_rate": "variable",
  "is_reusable": true,
  "stream_name": "string",
  "ingestion_address": "https://example.com",
  "backup_ingestion_address": "https://example.com",
  "rtmps_ingestion_address": "https://example.com",
  "stream_status": "string",
  "health_status": "string",
  "health_issues": [
    {}
  ]
}
```

## YouTube: Delete a Streams (ingest) item

`DELETE /accounts/{accountId}/youtube/live-streams/{itemId}`

Delete stream · quota: 1 unit (liveStreams.delete). RTMP/HLS/DASH/WebRTC ingestion points with stream keys and health. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveStreams Generic route: /v1/accounts/{accountId}/focus/live-streams.

Access: `write` · MCP tool: `youtube-live-streams-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-streams/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: List Live chat

`GET /accounts/{accountId}/youtube/live-chat`

Chat messages (active broadcast by default) · quota: 5 units (liveChatMessages.list). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: /v1/accounts/{accountId}/focus/live-chat.

Access: `read` · MCP tool: `youtube-live-chat-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `broadcast_id` (string)
- `live_chat_id` (string)
- `cursor` (string)
- `limit` (integer; 200–2000)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-chat" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "type": "string",
      "text": "string",
      "published_at": "2026-10-13T09:00:00.000Z",
      "author": "string",
      "author_channel_id": "string",
      "author_avatar_url": "https://example.com",
      "author_is_owner": true,
      "author_is_moderator": true,
      "author_is_sponsor": true,
      "super_chat": {
        "amount_micros": 1,
        "currency": "USD",
        "display": "string",
        "comment": "string",
        "tier": 1
      },
      "poll": {
        "question": "string",
        "status": "string",
        "options": [
          {
            "text": null,
            "tally": null
          }
        ]
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Live chat item

`POST /accounts/{accountId}/youtube/live-chat`

Send message as the channel · quota: 20 units (liveChatMessages.insert). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: /v1/accounts/{accountId}/focus/live-chat.

Access: `write` · MCP tool: `youtube-live-chat-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `broadcast_id` (string)
- `live_chat_id` (string)
- `text` (string; required; ≤ 200 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-chat" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "broadcast_id": "string",
    "live_chat_id": "string",
    "text": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "type": "string",
  "text": "string",
  "published_at": "2026-10-13T09:00:00.000Z",
  "author": "string",
  "author_channel_id": "string",
  "author_avatar_url": "https://example.com",
  "author_is_owner": true,
  "author_is_moderator": true,
  "author_is_sponsor": true,
  "super_chat": {
    "amount_micros": 1,
    "currency": "USD",
    "display": "string",
    "comment": "string",
    "tier": 1
  },
  "poll": {
    "question": "string",
    "status": "string",
    "options": [
      {
        "text": "string",
        "tally": 1
      }
    ]
  }
}
```

## YouTube: Delete a Live chat item

`DELETE /accounts/{accountId}/youtube/live-chat/{itemId}`

Delete message · quota: 20 units (liveChatMessages.delete). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: /v1/accounts/{accountId}/focus/live-chat.

Access: `write` · MCP tool: `youtube-live-chat-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-chat/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: Start poll (Live chat)

`POST /accounts/{accountId}/youtube/live-chat/create-poll`

Post a poll in chat · quota: 20 units (liveChatMessages.insert). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: /v1/accounts/{accountId}/focus/live-chat.

Access: `write` · MCP tool: `youtube-live-chat-create-poll`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `broadcast_id` (string)
- `live_chat_id` (string)
- `question` (string; required; ≤ 100 characters)
- `options` (array of string; required; 2–4 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-chat/create-poll" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "broadcast_id": "string",
    "live_chat_id": "string",
    "question": "string",
    "options": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Close poll (Live chat)

`POST /accounts/{accountId}/youtube/live-chat/{itemId}/close-poll`

End an active poll · quota: 20 units (liveChatMessages.transition). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: /v1/accounts/{accountId}/focus/live-chat.

Access: `write` · MCP tool: `youtube-live-chat-close-poll`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-chat/ITEM_ID/close-poll" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Ban / timeout author (Live chat)

`POST /accounts/{accountId}/youtube/live-chat/{itemId}/ban-author`

Ban permanently or for N seconds · quota: 200 units (liveChatBans.insert). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: /v1/accounts/{accountId}/focus/live-chat.

Access: `write` · MCP tool: `youtube-live-chat-ban-author`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `broadcast_id` (string)
- `live_chat_id` (string)
- `author_channel_id` (string; required)
- `type` (string; one of permanent, temporary)
- `ban_duration_seconds` (integer; ≥ 1)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-chat/ITEM_ID/ban-author" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "broadcast_id": "string",
    "live_chat_id": "string",
    "author_channel_id": "string",
    "type": "permanent",
    "ban_duration_seconds": 1
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Make moderator (Live chat)

`POST /accounts/{accountId}/youtube/live-chat/{itemId}/make-moderator`

Promote the author to chat moderator · quota: 200 units (liveChatModerators.insert). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: /v1/accounts/{accountId}/focus/live-chat.

Access: `write` · MCP tool: `youtube-live-chat-make-moderator`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `broadcast_id` (string)
- `live_chat_id` (string)
- `author_channel_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-chat/ITEM_ID/make-moderator" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "broadcast_id": "string",
    "live_chat_id": "string",
    "author_channel_id": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Chat moderators

`GET /accounts/{accountId}/youtube/live-chat-moderators`

Moderators · quota: 50 units (liveChatModerators.list). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatModerators Generic route: /v1/accounts/{accountId}/focus/live-chat-moderators.

Access: `read` · MCP tool: `youtube-live-chat-moderators-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–50)
- `cursor` (string)
- `broadcast_id` (string)
- `live_chat_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-chat-moderators" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "channel_id": "string",
      "display_name": "string",
      "channel_url": "https://example.com",
      "profile_image_url": "https://example.com",
      "live_chat_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Chat moderators item

`POST /accounts/{accountId}/youtube/live-chat-moderators`

Add moderator · quota: 200 units (liveChatModerators.insert). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatModerators Generic route: /v1/accounts/{accountId}/focus/live-chat-moderators.

Access: `write` · MCP tool: `youtube-live-chat-moderators-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `broadcast_id` (string)
- `live_chat_id` (string)
- `channel_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-chat-moderators" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "broadcast_id": "string",
    "live_chat_id": "string",
    "channel_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "channel_id": "string",
  "display_name": "string",
  "channel_url": "https://example.com",
  "profile_image_url": "https://example.com",
  "live_chat_id": "string"
}
```

## YouTube: Delete a Chat moderators item

`DELETE /accounts/{accountId}/youtube/live-chat-moderators/{itemId}`

Remove moderator · quota: 200 units (liveChatModerators.delete). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatModerators Generic route: /v1/accounts/{accountId}/focus/live-chat-moderators.

Access: `write` · MCP tool: `youtube-live-chat-moderators-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-chat-moderators/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: Create a Chat bans item

`POST /accounts/{accountId}/youtube/live-chat-bans`

Ban / timeout · quota: 200 units (liveChatBans.insert). Ban or time out users. The API has no list endpoint — keep the returned ban id to lift it. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatBans Generic route: /v1/accounts/{accountId}/focus/live-chat-bans.

Access: `write` · MCP tool: `youtube-live-chat-bans-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `broadcast_id` (string)
- `live_chat_id` (string)
- `channel_id` (string; required)
- `type` (string; one of permanent, temporary)
- `ban_duration_seconds` (integer; ≥ 1)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-chat-bans" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "broadcast_id": "string",
    "live_chat_id": "string",
    "channel_id": "string",
    "type": "permanent",
    "ban_duration_seconds": 1
  }'
```

Response 201:

```json
{
  "id": "string",
  "channel_id": "string",
  "display_name": "string",
  "type": "permanent",
  "ban_duration_seconds": 1,
  "live_chat_id": "string"
}
```

## YouTube: Delete a Chat bans item

`DELETE /accounts/{accountId}/youtube/live-chat-bans/{itemId}`

Lift ban · quota: 200 units (liveChatBans.delete). Ban or time out users. The API has no list endpoint — keep the returned ban id to lift it. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatBans Generic route: /v1/accounts/{accountId}/focus/live-chat-bans.

Access: `write` · MCP tool: `youtube-live-chat-bans-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-chat-bans/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: List Super Chats

`GET /accounts/{accountId}/youtube/super-chats`

Super Chat events · quota: 1 unit (superChatEvents.list). Super Chat & Super Sticker purchases from the last 30 days. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/superChatEvents Generic route: /v1/accounts/{accountId}/focus/super-chats.

Access: `read` · MCP tool: `youtube-super-chats-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–50)
- `cursor` (string)
- `hl` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/super-chats" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "supporter_name": "string",
      "supporter_channel_id": "string",
      "supporter_avatar_url": "https://example.com",
      "comment": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "amount_micros": 1,
      "currency": "USD",
      "display_amount": "string",
      "message_type": 1,
      "is_super_sticker": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Get Revenue

`GET /accounts/{accountId}/youtube/revenue`

Revenue dashboard · quota: 6 analytics queries (analytics.reports.query). YPP channels: estimated revenue, ad revenue, Premium revenue, CPM, RPM-like playback CPM, ad impressions, by day/video/country/ad type/content type. Requires scopes: https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/metrics#Revenue-Metrics Generic route: /v1/accounts/{accountId}/focus/revenue.

Access: `read` · MCP tool: `youtube-revenue-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 28 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)
- `currency` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/revenue" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "since": "2026-10-13",
  "until": "2026-10-13",
  "sections": {
    "key": {
      "report": "string",
      "label": "string",
      "columns": [
        {
          "name": "string",
          "type": "dimension",
          "data_type": "string"
        }
      ],
      "rows": [
        [
          null
        ]
      ],
      "items": [
        {}
      ],
      "series": [
        {
          "date": "string",
          "metrics": {}
        }
      ]
    }
  },
  "errors": {
    "key": {
      "code": "string",
      "message": "string"
    }
  }
}
```

## YouTube: List Members

`GET /accounts/{accountId}/youtube/members`

Members · quota: 2 units (members.list). Channel members with level and tenure; mode=updates streams new/upgraded members. Access is allowlisted by YouTube. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtube.channel-memberships.creator. Network docs: https://developers.google.com/youtube/v3/docs/members Generic route: /v1/accounts/{accountId}/focus/members.

Access: `read` · MCP tool: `youtube-members-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–1000)
- `cursor` (string)
- `mode` (string; one of all_current, updates)
- `level_id` (string)
- `channel_ids` (string): Comma-separated, ≤100

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/members" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "channel_id": "string",
      "display_name": "string",
      "channel_url": "https://example.com",
      "profile_image_url": "https://example.com",
      "highest_level_id": "string",
      "highest_level_name": "string",
      "accessible_levels": [
        "string"
      ],
      "member_since": "2026-10-13T09:00:00.000Z",
      "total_months": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: List Membership levels

`GET /accounts/{accountId}/youtube/membership-levels`

Levels · quota: 1 unit (membershipsLevels.list). Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtube.channel-memberships.creator. Network docs: https://developers.google.com/youtube/v3/docs/membershipsLevels Generic route: /v1/accounts/{accountId}/focus/membership-levels.

Access: `read` · MCP tool: `youtube-membership-levels-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/membership-levels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "display_name": "string",
      "creator_channel_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Get Membership churn

`GET /accounts/{accountId}/youtube/membership-analytics`

Membership churn: cancellations · quota: 1 analytics query (analytics.reports.query). Cancellation survey reasons. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/membership-analytics.

Access: `read` · MCP tool: `youtube-membership-analytics-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 28 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/membership-analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "since": "2026-10-13",
  "until": "2026-10-13",
  "sections": {
    "key": {
      "report": "string",
      "label": "string",
      "columns": [
        {
          "name": "string",
          "type": "dimension",
          "data_type": "string"
        }
      ],
      "rows": [
        [
          null
        ]
      ],
      "items": [
        {}
      ],
      "series": [
        {
          "date": "string",
          "metrics": {}
        }
      ]
    }
  },
  "errors": {
    "key": {
      "code": "string",
      "message": "string"
    }
  }
}
```

## YouTube: Get Basic info

`GET /accounts/{accountId}/youtube/channel`

Channel · quota: 1 unit (channels.list). Description, keywords, country, default language, trailer, made-for-kids. Title/handle/avatar are Studio-only. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels/update Generic route: /v1/accounts/{accountId}/focus/channel.

Access: `read` · MCP tool: `youtube-channel-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "handle": "string",
  "custom_url": "https://example.com",
  "description": "string",
  "keywords": [
    "string"
  ],
  "country": "US",
  "default_language": "string",
  "unsubscribed_trailer": "string",
  "tracking_analytics_account_id": "string",
  "self_declared_made_for_kids": true,
  "made_for_kids": true,
  "thumbnail_url": "https://example.com",
  "banner_url": "https://example.com",
  "subscriber_count": 1,
  "hidden_subscriber_count": true,
  "video_count": 1,
  "view_count": 1,
  "uploads_playlist_id": "string",
  "privacy_status": "string",
  "long_uploads_status": "string",
  "published_at": "2026-10-13T09:00:00.000Z",
  "topic_categories": [
    "https://example.com"
  ],
  "url": "https://example.com"
}
```

## YouTube: Update Basic info

`PATCH /accounts/{accountId}/youtube/channel`

Update branding (+ status when made-for-kids changes) · quota: 51 units (channels.list, channels.update). Description, keywords, country, default language, trailer, made-for-kids. Title/handle/avatar are Studio-only. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels/update Generic route: /v1/accounts/{accountId}/focus/channel.

Access: `write` · MCP tool: `youtube-channel-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `description` (string; ≤ 1000 characters)
- `keywords` (array of string): Channel tags
- `country` (string)
- `default_language` (string)
- `unsubscribed_trailer` (string)
- `tracking_analytics_account_id` (string)
- `self_declared_made_for_kids` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "string",
    "keywords": [
      "string"
    ],
    "country": "US",
    "default_language": "string",
    "unsubscribed_trailer": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "handle": "string",
  "custom_url": "https://example.com",
  "description": "string",
  "keywords": [
    "string"
  ],
  "country": "US",
  "default_language": "string",
  "unsubscribed_trailer": "string",
  "tracking_analytics_account_id": "string",
  "self_declared_made_for_kids": true,
  "made_for_kids": true,
  "thumbnail_url": "https://example.com",
  "banner_url": "https://example.com",
  "subscriber_count": 1,
  "hidden_subscriber_count": true,
  "video_count": 1,
  "view_count": 1,
  "uploads_playlist_id": "string",
  "privacy_status": "string",
  "long_uploads_status": "string",
  "published_at": "2026-10-13T09:00:00.000Z",
  "topic_categories": [
    "https://example.com"
  ],
  "url": "https://example.com"
}
```

## YouTube: List Channel translations

`GET /accounts/{accountId}/youtube/channel-localizations`

Translations · quota: 1 unit (channels.list). Channel title/description per language (requires a default language). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels#localizations Generic route: /v1/accounts/{accountId}/focus/channel-localizations.

Access: `read` · MCP tool: `youtube-channel-localizations-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-localizations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "language": "en",
      "title": "string",
      "description": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Channel translations item

`POST /accounts/{accountId}/youtube/channel-localizations`

Add translation · quota: 52 units (channels.list, channels.update). Channel title/description per language (requires a default language). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels#localizations Generic route: /v1/accounts/{accountId}/focus/channel-localizations.

Access: `write` · MCP tool: `youtube-channel-localizations-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `language` (string; required)
- `title` (string; required)
- `description` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-localizations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "language": "en",
    "title": "string",
    "description": "string"
  }'
```

Response 201:

```json
{
  "language": "en",
  "title": "string",
  "description": "string"
}
```

## YouTube: Update a Channel translations item

`PATCH /accounts/{accountId}/youtube/channel-localizations/{itemId}`

Edit translation · quota: 52 units (channels.list, channels.update). Channel title/description per language (requires a default language). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels#localizations Generic route: /v1/accounts/{accountId}/focus/channel-localizations.

Access: `write` · MCP tool: `youtube-channel-localizations-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `title` (string)
- `description` (string)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-localizations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string"
  }'
```

Response 200:

```json
{
  "language": "en",
  "title": "string",
  "description": "string"
}
```

## YouTube: Delete a Channel translations item

`DELETE /accounts/{accountId}/youtube/channel-localizations/{itemId}`

Remove translation · quota: 52 units (channels.list, channels.update). Channel title/description per language (requires a default language). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels#localizations Generic route: /v1/accounts/{accountId}/focus/channel-localizations.

Access: `write` · MCP tool: `youtube-channel-localizations-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-localizations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: Get Banner

`GET /accounts/{accountId}/youtube/channel-banner`

Current banner · quota: 1 unit (channels.list). 16:9, ≥2048×1152 (2560×1440 recommended), ≤6 MB JPEG/PNG. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelBanners/insert Generic route: /v1/accounts/{accountId}/focus/channel-banner.

Access: `read` · MCP tool: `youtube-channel-banner-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-banner" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "banner_url": "https://example.com"
}
```

## YouTube: Update Banner

`PATCH /accounts/{accountId}/youtube/channel-banner`

Upload and apply banner · quota: 101 units (channelBanners.insert, channels.list, channels.update). 16:9, ≥2048×1152 (2560×1440 recommended), ≤6 MB JPEG/PNG. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelBanners/insert Generic route: /v1/accounts/{accountId}/focus/channel-banner.

Access: `write` · MCP tool: `youtube-channel-banner-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `media` (string; required)
- `apply` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-banner" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "media": "string",
    "apply": true
  }'
```

Response 200:

```json
{
  "banner_url": "https://example.com"
}
```

## YouTube: Get Video watermark

`GET /accounts/{accountId}/youtube/watermark`

Watermark settings form (not readable via API) · quota: none (no API call). Branding watermark shown on all videos (the API cannot read the current one). Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/watermarks Generic route: /v1/accounts/{accountId}/focus/watermark.

Access: `read` · MCP tool: `youtube-watermark-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/watermark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "media": "string",
  "timing_type": "offsetFromStart",
  "offset_ms": 0,
  "duration_ms": 0,
  "corner_position": "bottomRight"
}
```

## YouTube: Set watermark (Video watermark)

`POST /accounts/{accountId}/youtube/watermark/set`

Upload and apply · quota: 50 units (watermarks.set). Branding watermark shown on all videos (the API cannot read the current one). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/watermarks Generic route: /v1/accounts/{accountId}/focus/watermark.

Access: `write` · MCP tool: `youtube-watermark-set`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `media` (string; required)
- `timing_type` (string; one of offsetFromStart, offsetFromEnd)
- `offset_ms` (integer)
- `duration_ms` (integer)
- `corner_position` (string; one of topLeft, topRight, bottomLeft, bottomRight)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/watermark/set" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media": "string",
    "timing_type": "offsetFromStart",
    "offset_ms": 0,
    "duration_ms": 0,
    "corner_position": "topLeft"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: Remove watermark (Video watermark)

`POST /accounts/{accountId}/youtube/watermark/unset`

Unset · quota: 50 units (watermarks.unset). Branding watermark shown on all videos (the API cannot read the current one). Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/watermarks Generic route: /v1/accounts/{accountId}/focus/watermark.

Access: `write` · MCP tool: `youtube-watermark-unset`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/watermark/unset" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Home tab sections

`GET /accounts/{accountId}/youtube/channel-sections`

Sections · quota: 1 unit (channelSections.list). Shelves on the channel home tab: uploads, popular, playlists, channels, live, …. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelSections Generic route: /v1/accounts/{accountId}/focus/channel-sections.

Access: `read` · MCP tool: `youtube-channel-sections-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-sections" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "type": "allPlaylists",
      "title": "string",
      "position": 0,
      "playlists": [
        "string"
      ],
      "channels": [
        "string"
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Home tab sections item

`POST /accounts/{accountId}/youtube/channel-sections`

Add section · quota: 50 units (channelSections.insert). Shelves on the channel home tab: uploads, popular, playlists, channels, live, …. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelSections Generic route: /v1/accounts/{accountId}/focus/channel-sections.

Access: `write` · MCP tool: `youtube-channel-sections-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `type` (string; required; one of allPlaylists, completedEvents, liveEvents, multipleChannels, multiplePlaylists, popularUploads, recentUploads, singlePlaylist, subscriptions, upcomingEvents)
- `title` (string | null): Required for multiplePlaylists / multipleChannels
- `position` (integer)
- `playlists` (array of string): singlePlaylist (1) / multiplePlaylists
- `channels` (array of string): multipleChannels

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-sections" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "allPlaylists",
    "title": "string",
    "position": 0,
    "playlists": [
      "string"
    ],
    "channels": [
      "string"
    ]
  }'
```

Response 201:

```json
{
  "id": "string",
  "type": "allPlaylists",
  "title": "string",
  "position": 0,
  "playlists": [
    "string"
  ],
  "channels": [
    "string"
  ]
}
```

## YouTube: Update a Home tab sections item

`PATCH /accounts/{accountId}/youtube/channel-sections/{itemId}`

Edit / move section · quota: 51 units (channelSections.list, channelSections.update). Shelves on the channel home tab: uploads, popular, playlists, channels, live, …. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelSections Generic route: /v1/accounts/{accountId}/focus/channel-sections.

Access: `write` · MCP tool: `youtube-channel-sections-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `type` (string; one of allPlaylists, completedEvents, liveEvents, multipleChannels, multiplePlaylists, popularUploads, recentUploads, singlePlaylist, subscriptions, upcomingEvents)
- `title` (string | null): Required for multiplePlaylists / multipleChannels
- `position` (integer)
- `playlists` (array of string): singlePlaylist (1) / multiplePlaylists
- `channels` (array of string): multipleChannels

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-sections/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "allPlaylists",
    "title": "string",
    "position": 0,
    "playlists": [
      "string"
    ],
    "channels": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "id": "string",
  "type": "allPlaylists",
  "title": "string",
  "position": 0,
  "playlists": [
    "string"
  ],
  "channels": [
    "string"
  ]
}
```

## YouTube: Delete a Home tab sections item

`DELETE /accounts/{accountId}/youtube/channel-sections/{itemId}`

Remove section · quota: 50 units (channelSections.delete). Shelves on the channel home tab: uploads, popular, playlists, channels, live, …. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelSections Generic route: /v1/accounts/{accountId}/focus/channel-sections.

Access: `write` · MCP tool: `youtube-channel-sections-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-sections/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: List Subscriptions

`GET /accounts/{accountId}/youtube/subscriptions`

My subscriptions · quota: 1 unit (subscriptions.list). Channels this channel subscribes to; subscribe / unsubscribe. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/subscriptions Generic route: /v1/accounts/{accountId}/focus/subscriptions.

Access: `read` · MCP tool: `youtube-subscriptions-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–50)
- `cursor` (string)
- `order` (string; one of alphabetical, relevance, unread)
- `for_channel_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/subscriptions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "channel_id": "string",
      "title": "string",
      "description": "string",
      "thumbnail_url": "https://example.com",
      "subscribed_at": "2026-10-13T09:00:00.000Z",
      "subscriber_channel_id": "string",
      "subscriber_title": "string",
      "subscriber_thumbnail_url": "https://example.com",
      "total_item_count": 1,
      "new_item_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Create a Subscriptions item

`POST /accounts/{accountId}/youtube/subscriptions`

Subscribe · quota: 50 units (subscriptions.insert). Channels this channel subscribes to; subscribe / unsubscribe. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/subscriptions Generic route: /v1/accounts/{accountId}/focus/subscriptions.

Access: `write` · MCP tool: `youtube-subscriptions-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `channel_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/subscriptions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "channel_id": "string",
  "title": "string",
  "description": "string",
  "thumbnail_url": "https://example.com",
  "subscribed_at": "2026-10-13T09:00:00.000Z",
  "subscriber_channel_id": "string",
  "subscriber_title": "string",
  "subscriber_thumbnail_url": "https://example.com",
  "total_item_count": 1,
  "new_item_count": 1
}
```

## YouTube: Delete a Subscriptions item

`DELETE /accounts/{accountId}/youtube/subscriptions/{itemId}`

Unsubscribe · quota: 50 units (subscriptions.delete). Channels this channel subscribes to; subscribe / unsubscribe. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/subscriptions Generic route: /v1/accounts/{accountId}/focus/subscriptions.

Access: `write` · MCP tool: `youtube-subscriptions-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/subscriptions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## YouTube: List Subscribers

`GET /accounts/{accountId}/youtube/subscribers`

Subscribers · quota: 1 unit (subscriptions.list). Subscribers with public subscriptions (all or recent). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/subscriptions/list Generic route: /v1/accounts/{accountId}/focus/subscribers.

Access: `read` · MCP tool: `youtube-subscribers-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–50)
- `cursor` (string)
- `recent` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/subscribers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "channel_id": "string",
      "title": "string",
      "description": "string",
      "thumbnail_url": "https://example.com",
      "subscribed_at": "2026-10-13T09:00:00.000Z",
      "subscriber_channel_id": "string",
      "subscriber_title": "string",
      "subscriber_thumbnail_url": "https://example.com",
      "total_item_count": 1,
      "new_item_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: List Video categories

`GET /accounts/{accountId}/youtube/video-categories`

Categories for a region · quota: 1 unit (videoCategories.list). Cursor pagination: pass next_cursor back as cursor. Network docs: https://developers.google.com/youtube/v3/docs/videoCategories Generic route: /v1/accounts/{accountId}/focus/video-categories.

Access: `read` · MCP tool: `youtube-video-categories-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `region_code` (string)
- `hl` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/video-categories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "assignable": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: List Languages

`GET /accounts/{accountId}/youtube/languages`

i18n languages · quota: 1 unit (i18nLanguages.list). Cursor pagination: pass next_cursor back as cursor. Network docs: https://developers.google.com/youtube/v3/docs/i18nLanguages Generic route: /v1/accounts/{accountId}/focus/languages.

Access: `read` · MCP tool: `youtube-languages-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `hl` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/languages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "code": "string",
      "name": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: List Regions

`GET /accounts/{accountId}/youtube/regions`

i18n regions · quota: 1 unit (i18nRegions.list). Cursor pagination: pass next_cursor back as cursor. Network docs: https://developers.google.com/youtube/v3/docs/i18nRegions Generic route: /v1/accounts/{accountId}/focus/regions.

Access: `read` · MCP tool: `youtube-regions-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `hl` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/regions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "code": "string",
      "name": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: List Report abuse

`GET /accounts/{accountId}/youtube/abuse-reports`

Abuse report reasons · quota: 1 unit (videoAbuseReportReasons.list). Abuse report reasons; report a video. Cursor pagination: pass next_cursor back as cursor. Network docs: https://developers.google.com/youtube/v3/docs/videos/reportAbuse Generic route: /v1/accounts/{accountId}/focus/abuse-reports.

Access: `read` · MCP tool: `youtube-abuse-reports-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `hl` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/abuse-reports" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "label": "string",
      "secondary_reasons": [
        {
          "id": "string",
          "label": "string"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## YouTube: Report a video (Report abuse)

`POST /accounts/{accountId}/youtube/abuse-reports/report`

videos.reportAbuse · quota: 50 units (videos.reportAbuse). Abuse report reasons; report a video. Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/videos/reportAbuse Generic route: /v1/accounts/{accountId}/focus/abuse-reports.

Access: `write` · MCP tool: `youtube-abuse-reports-report`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `video_id` (string; required)
- `reason_id` (string; required)
- `secondary_reason_id` (string)
- `comments` (string)
- `language` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/abuse-reports/report" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_id": "string",
    "reason_id": "string",
    "secondary_reason_id": "string",
    "comments": "string",
    "language": "en"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## YouTube: List Managed channels

`GET /accounts/{accountId}/youtube/managed-channels`

Managed channels · quota: 1 unit (channels.list). YouTube CMS content owners: channels managed by this content owner. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels/list Generic route: /v1/accounts/{accountId}/focus/managed-channels.

Access: `read` · MCP tool: `youtube-managed-channels-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–50)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/managed-channels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "handle": "string",
      "custom_url": "https://example.com",
      "description": "string",
      "keywords": [
        "string"
      ],
      "country": "US",
      "default_language": "string",
      "unsubscribed_trailer": "string",
      "tracking_analytics_account_id": "string",
      "self_declared_made_for_kids": true,
      "made_for_kids": true,
      "thumbnail_url": "https://example.com",
      "banner_url": "https://example.com",
      "subscriber_count": 1,
      "hidden_subscriber_count": true,
      "video_count": 1,
      "view_count": 1,
      "uploads_playlist_id": "string",
      "privacy_status": "string",
      "long_uploads_status": "string",
      "published_at": "2026-10-13T09:00:00.000Z",
      "topic_categories": [
        "https://example.com"
      ],
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```


---

Source: https://socialit.com/docs/api-reference/focus-youtube/
