Skip to content
Docs

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

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits170 endpointsMCP toolset focus_youtube

Channel dashboard

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

Try it with MCPAsk your agent to call youtube-channel-dashboard-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)
untilstring (date)

Returns object

channelobjectread-only
Show 6 child attributes
idstring
titlestring
thumbnail_urlstring (uri)
subscriber_countinteger | null
view_countinteger | null
video_countinteger | null
periodobjectread-only
Show 2 child attributes
sincestring
untilstring
totalsobjectread-only

YouTube Analytics totals for the period

latest_videosarray of objectread-only
Show 38 item attributes
idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤5000 bytes

≤ 5000 characters

tagsarray of string

≤500 characters in total

category_idstring

See video-categories

default_languagestring
default_audio_languagestring
privacy_statusstring

publicunlistedprivate

publish_atstring (date-time) | null

Scheduled release (video must be private and never published)

is_scheduledbooleanread-only
self_declared_made_for_kidsboolean

Made for kids (COPPA)

made_for_kidsbooleanread-only
contains_synthetic_mediaboolean

Altered or synthetic content

has_paid_product_placementboolean

Includes paid promotion

licensestring

youtubecreativeCommon

embeddableboolean
public_stats_viewableboolean
recording_datestring (date-time) | null
thumbnail_urlstring (uri)read-only
published_atstring (date-time)read-only
upload_statusstringread-only

uploadedprocessedfailedrejecteddeleted

failure_reasonstring | nullread-only
rejection_reasonstring | nullread-only
processing_statusstring | nullread-only
duration_secondsinteger | nullread-only
definitionstring | nullread-only
captionboolean | nullread-only
has_custom_thumbnailboolean | nullread-only
is_shortboolean | nullread-only

Heuristic: vertical/square and ≤180 s

is_livebooleanread-only
view_countinteger | nullread-only
like_countinteger | nullread-only
comment_countinteger | nullread-only
widthinteger | nullread-only
heightinteger | nullread-only
localizationsobjectread-only

BCP-47 language → { title, description }

urlstring (uri)read-only
studio_urlstring (uri)read-only
top_videosarray of objectread-only
Show 3 item attributes
videostring
viewsnumber
estimatedMinutesWatchednumber
analytics_errorstring | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/channel-dashboard
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-dashboard" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Quota

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

Try it with MCPAsk your agent to call youtube-quota-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

resets_atstringread-only

Midnight Pacific Time

bucketsarray of objectread-only
Show 4 item attributes
bucketstring
limitinteger
usedinteger | null
remaininginteger | null
costsarray of objectread-only
Show 3 item attributes
operationstring
unitsinteger
bucketstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/quota
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/quota" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Activities

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

Try it with MCPAsk your agent to call youtube-activities-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–50

cursorstring
published_afterstring (date-time)
published_beforestring (date-time)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringread-only
typestringread-only
titlestringread-only
published_atstring (date-time)read-only
video_idstring | nullread-only
playlist_idstring | nullread-only
thumbnail_urlstring (uri) | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/activities
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/activities" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Videos

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

Try it with MCPAsk your agent to call youtube-videos-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–50

cursorstring
filterstringdefault: "all"

allpublicunlistedprivatescheduledshortsvideosliveprocessingfailed

qstring

Search own videos (uses the 100/day search bucket)

orderstring

dateratingrelevancetitleviewCount

scan_pagesintegerdefault: 1

Scan several pages for sparse filters

1–10

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 38 item attributes
idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤5000 bytes

≤ 5000 characters

tagsarray of string

≤500 characters in total

category_idstring

See video-categories

default_languagestring
default_audio_languagestring
privacy_statusstring

publicunlistedprivate

publish_atstring (date-time) | null

Scheduled release (video must be private and never published)

is_scheduledbooleanread-only
self_declared_made_for_kidsboolean

Made for kids (COPPA)

made_for_kidsbooleanread-only
contains_synthetic_mediaboolean

Altered or synthetic content

has_paid_product_placementboolean

Includes paid promotion

licensestring

youtubecreativeCommon

embeddableboolean
public_stats_viewableboolean
recording_datestring (date-time) | null
thumbnail_urlstring (uri)read-only
published_atstring (date-time)read-only
upload_statusstringread-only

uploadedprocessedfailedrejecteddeleted

failure_reasonstring | nullread-only
rejection_reasonstring | nullread-only
processing_statusstring | nullread-only
duration_secondsinteger | nullread-only
definitionstring | nullread-only
captionboolean | nullread-only
has_custom_thumbnailboolean | nullread-only
is_shortboolean | nullread-only

Heuristic: vertical/square and ≤180 s

is_livebooleanread-only
view_countinteger | nullread-only
like_countinteger | nullread-only
comment_countinteger | nullread-only
widthinteger | nullread-only
heightinteger | nullread-only
localizationsobjectread-only

BCP-47 language → { title, description }

urlstring (uri)read-only
studio_urlstring (uri)read-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/videos
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-KeyZernio: POST /v1/posts/{postId}/update-metadataPOST /v1/posts/{postId}/editPOST /v1/posts/{postId}/unpublishPOST /v1/inbox/posts/{postId}/like

Try it with MCPAsk your agent to call youtube-videos-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

mediastringrequired

Video file (≤256 GB / 12 h)

titlestringrequired

≤ 100 characters

descriptionstring

≤ 5000 characters

privacy_statusstringrequireddefault: "private"

publicunlistedprivate

publish_atstring (date-time)

Schedule: uploads as private, released publicly at this time

self_declared_made_for_kidsbooleanrequired
tagsarray of string
category_idstringdefault: "22"
default_languagestring
default_audio_languagestring
localizationsobject

BCP-47 language → { title, description }

contains_synthetic_mediaboolean
has_paid_product_placementboolean
licensestring

youtubecreativeCommon

embeddablebooleandefault: true
public_stats_viewablebooleandefault: true
notify_subscribersbooleandefault: true
recording_datestring (date-time)
is_shortboolean

Override Shorts detection

add_shorts_hashtagbooleandefault: false
thumbnailstring
playlist_idsarray of string
captionsarray of object
Show 4 item attributes
mediastring
languagestring
namestring

≤ 150 characters

is_draftboolean
first_commentstring

≤ 10000 characters

Returns object

idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤5000 bytes

≤ 5000 characters

tagsarray of string

≤500 characters in total

category_idstring

See video-categories

default_languagestring
default_audio_languagestring
privacy_statusstring

publicunlistedprivate

publish_atstring (date-time) | null

Scheduled release (video must be private and never published)

is_scheduledbooleanread-only
self_declared_made_for_kidsboolean

Made for kids (COPPA)

made_for_kidsbooleanread-only
contains_synthetic_mediaboolean

Altered or synthetic content

has_paid_product_placementboolean

Includes paid promotion

licensestring

youtubecreativeCommon

embeddableboolean
public_stats_viewableboolean
recording_datestring (date-time) | null
thumbnail_urlstring (uri)read-only
published_atstring (date-time)read-only
upload_statusstringread-only

uploadedprocessedfailedrejecteddeleted

failure_reasonstring | nullread-only
rejection_reasonstring | nullread-only
processing_statusstring | nullread-only
duration_secondsinteger | nullread-only
definitionstring | nullread-only
captionboolean | nullread-only
has_custom_thumbnailboolean | nullread-only
is_shortboolean | nullread-only

Heuristic: vertical/square and ≤180 s

is_livebooleanread-only
view_countinteger | nullread-only
like_countinteger | nullread-only
comment_countinteger | nullread-only
widthinteger | nullread-only
heightinteger | nullread-only
localizationsobjectread-only

BCP-47 language → { title, description }

urlstring (uri)read-only
studio_urlstring (uri)read-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/videos
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

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

Try it with MCPAsk your agent to call youtube-videos-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤5000 bytes

≤ 5000 characters

tagsarray of string

≤500 characters in total

category_idstring

See video-categories

default_languagestring
default_audio_languagestring
privacy_statusstring

publicunlistedprivate

publish_atstring (date-time) | null

Scheduled release (video must be private and never published)

is_scheduledbooleanread-only
self_declared_made_for_kidsboolean

Made for kids (COPPA)

made_for_kidsbooleanread-only
contains_synthetic_mediaboolean

Altered or synthetic content

has_paid_product_placementboolean

Includes paid promotion

licensestring

youtubecreativeCommon

embeddableboolean
public_stats_viewableboolean
recording_datestring (date-time) | null
thumbnail_urlstring (uri)read-only
published_atstring (date-time)read-only
upload_statusstringread-only

uploadedprocessedfailedrejecteddeleted

failure_reasonstring | nullread-only
rejection_reasonstring | nullread-only
processing_statusstring | nullread-only
duration_secondsinteger | nullread-only
definitionstring | nullread-only
captionboolean | nullread-only
has_custom_thumbnailboolean | nullread-only
is_shortboolean | nullread-only

Heuristic: vertical/square and ≤180 s

is_livebooleanread-only
view_countinteger | nullread-only
like_countinteger | nullread-only
comment_countinteger | nullread-only
widthinteger | nullread-only
heightinteger | nullread-only
localizationsobjectread-only

BCP-47 language → { title, description }

urlstring (uri)read-only
studio_urlstring (uri)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/videos/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call youtube-videos-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring

≤ 100 characters

descriptionstring

≤ 5000 characters

tagsarray of string
category_idstring
default_languagestring
default_audio_languagestring
privacy_statusstring

publicunlistedprivate

publish_atstring (date-time) | null
self_declared_made_for_kidsboolean
contains_synthetic_mediaboolean
has_paid_product_placementboolean
licensestring

youtubecreativeCommon

embeddableboolean
public_stats_viewableboolean
recording_datestring (date-time) | null
localizationsobject

BCP-47 language → { title, description }

brand_partnerobject
Show 2 child attributes
channel_idstring

pattern ^UC

channel_handlestring

pattern ^@

thumbnailstring

New custom thumbnail (JPEG/PNG ≤50 MB)

playlist_idstring

Also add to this playlist

Returns object

idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤5000 bytes

≤ 5000 characters

tagsarray of string

≤500 characters in total

category_idstring

See video-categories

default_languagestring
default_audio_languagestring
privacy_statusstring

publicunlistedprivate

publish_atstring (date-time) | null

Scheduled release (video must be private and never published)

is_scheduledbooleanread-only
self_declared_made_for_kidsboolean

Made for kids (COPPA)

made_for_kidsbooleanread-only
contains_synthetic_mediaboolean

Altered or synthetic content

has_paid_product_placementboolean

Includes paid promotion

licensestring

youtubecreativeCommon

embeddableboolean
public_stats_viewableboolean
recording_datestring (date-time) | null
thumbnail_urlstring (uri)read-only
published_atstring (date-time)read-only
upload_statusstringread-only

uploadedprocessedfailedrejecteddeleted

failure_reasonstring | nullread-only
rejection_reasonstring | nullread-only
processing_statusstring | nullread-only
duration_secondsinteger | nullread-only
definitionstring | nullread-only
captionboolean | nullread-only
has_custom_thumbnailboolean | nullread-only
is_shortboolean | nullread-only

Heuristic: vertical/square and ≤180 s

is_livebooleanread-only
view_countinteger | nullread-only
like_countinteger | nullread-only
comment_countinteger | nullread-only
widthinteger | nullread-only
heightinteger | nullread-only
localizationsobjectread-only

BCP-47 language → { title, description }

urlstring (uri)read-only
studio_urlstring (uri)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/videos/{itemId}
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

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: writeZernio: DELETE /v1/inbox/posts/{postId}/like

Try it with MCPAsk your agent to call youtube-videos-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/videos/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-videos-rate (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

ratingstringrequired

likedislikenone

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/videos/{itemId}/rate
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-videos-rating (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/videos/{itemId}/rating
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-videos-set-thumbnail (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

mediastringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/videos/{itemId}/set-thumbnail
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-videos-add-to-playlist (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

playlist_idstringrequired
positioninteger
notestring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/videos/{itemId}/add-to-playlist
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-videos-set-visibility (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

privacy_statusstringrequired

publicunlistedprivate

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/videos/{itemId}/set-visibility
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-videos-publish-now (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/videos/{itemId}/publish-now
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-videos-schedule (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

publish_atstring (date-time)required

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/videos/{itemId}/schedule
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-videos-processing-status (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/videos/{itemId}/processing-status
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

Shorts

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

Try it with MCPAsk your agent to call youtube-shorts-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–50

cursorstring
scan_pagesintegerdefault: 3

1–10

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 38 item attributes
idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤5000 bytes

≤ 5000 characters

tagsarray of string

≤500 characters in total

category_idstring

See video-categories

default_languagestring
default_audio_languagestring
privacy_statusstring

publicunlistedprivate

publish_atstring (date-time) | null

Scheduled release (video must be private and never published)

is_scheduledbooleanread-only
self_declared_made_for_kidsboolean

Made for kids (COPPA)

made_for_kidsbooleanread-only
contains_synthetic_mediaboolean

Altered or synthetic content

has_paid_product_placementboolean

Includes paid promotion

licensestring

youtubecreativeCommon

embeddableboolean
public_stats_viewableboolean
recording_datestring (date-time) | null
thumbnail_urlstring (uri)read-only
published_atstring (date-time)read-only
upload_statusstringread-only

uploadedprocessedfailedrejecteddeleted

failure_reasonstring | nullread-only
rejection_reasonstring | nullread-only
processing_statusstring | nullread-only
duration_secondsinteger | nullread-only
definitionstring | nullread-only
captionboolean | nullread-only
has_custom_thumbnailboolean | nullread-only
is_shortboolean | nullread-only

Heuristic: vertical/square and ≤180 s

is_livebooleanread-only
view_countinteger | nullread-only
like_countinteger | nullread-only
comment_countinteger | nullread-only
widthinteger | nullread-only
heightinteger | nullread-only
localizationsobjectread-only

BCP-47 language → { title, description }

urlstring (uri)read-only
studio_urlstring (uri)read-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/shorts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/shorts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-shorts-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

mediastringrequired

Video file (≤256 GB / 12 h)

titlestringrequired

≤ 100 characters

descriptionstring

≤ 5000 characters

privacy_statusstringrequireddefault: "private"

publicunlistedprivate

publish_atstring (date-time)

Schedule: uploads as private, released publicly at this time

self_declared_made_for_kidsbooleanrequired
tagsarray of string
category_idstringdefault: "22"
default_languagestring
default_audio_languagestring
localizationsobject

BCP-47 language → { title, description }

contains_synthetic_mediaboolean
has_paid_product_placementboolean
licensestring

youtubecreativeCommon

embeddablebooleandefault: true
public_stats_viewablebooleandefault: true
notify_subscribersbooleandefault: true
recording_datestring (date-time)
is_shortboolean

Override Shorts detection

add_shorts_hashtagbooleandefault: false
thumbnailstring
playlist_idsarray of string
captionsarray of object
Show 4 item attributes
mediastring
languagestring
namestring

≤ 150 characters

is_draftboolean
first_commentstring

≤ 10000 characters

Returns object

idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤5000 bytes

≤ 5000 characters

tagsarray of string

≤500 characters in total

category_idstring

See video-categories

default_languagestring
default_audio_languagestring
privacy_statusstring

publicunlistedprivate

publish_atstring (date-time) | null

Scheduled release (video must be private and never published)

is_scheduledbooleanread-only
self_declared_made_for_kidsboolean

Made for kids (COPPA)

made_for_kidsbooleanread-only
contains_synthetic_mediaboolean

Altered or synthetic content

has_paid_product_placementboolean

Includes paid promotion

licensestring

youtubecreativeCommon

embeddableboolean
public_stats_viewableboolean
recording_datestring (date-time) | null
thumbnail_urlstring (uri)read-only
published_atstring (date-time)read-only
upload_statusstringread-only

uploadedprocessedfailedrejecteddeleted

failure_reasonstring | nullread-only
rejection_reasonstring | nullread-only
processing_statusstring | nullread-only
duration_secondsinteger | nullread-only
definitionstring | nullread-only
captionboolean | nullread-only
has_custom_thumbnailboolean | nullread-only
is_shortboolean | nullread-only

Heuristic: vertical/square and ≤180 s

is_livebooleanread-only
view_countinteger | nullread-only
like_countinteger | nullread-only
comment_countinteger | nullread-only
widthinteger | nullread-only
heightinteger | nullread-only
localizationsobjectread-only

BCP-47 language → { title, description }

urlstring (uri)read-only
studio_urlstring (uri)read-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/shorts
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

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

Try it with MCPAsk your agent to call youtube-shorts-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤5000 bytes

≤ 5000 characters

tagsarray of string

≤500 characters in total

category_idstring

See video-categories

default_languagestring
default_audio_languagestring
privacy_statusstring

publicunlistedprivate

publish_atstring (date-time) | null

Scheduled release (video must be private and never published)

is_scheduledbooleanread-only
self_declared_made_for_kidsboolean

Made for kids (COPPA)

made_for_kidsbooleanread-only
contains_synthetic_mediaboolean

Altered or synthetic content

has_paid_product_placementboolean

Includes paid promotion

licensestring

youtubecreativeCommon

embeddableboolean
public_stats_viewableboolean
recording_datestring (date-time) | null
thumbnail_urlstring (uri)read-only
published_atstring (date-time)read-only
upload_statusstringread-only

uploadedprocessedfailedrejecteddeleted

failure_reasonstring | nullread-only
rejection_reasonstring | nullread-only
processing_statusstring | nullread-only
duration_secondsinteger | nullread-only
definitionstring | nullread-only
captionboolean | nullread-only
has_custom_thumbnailboolean | nullread-only
is_shortboolean | nullread-only

Heuristic: vertical/square and ≤180 s

is_livebooleanread-only
view_countinteger | nullread-only
like_countinteger | nullread-only
comment_countinteger | nullread-only
widthinteger | nullread-only
heightinteger | nullread-only
localizationsobjectread-only

BCP-47 language → { title, description }

urlstring (uri)read-only
studio_urlstring (uri)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/shorts/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/shorts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call youtube-shorts-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring

≤ 100 characters

descriptionstring

≤ 5000 characters

tagsarray of string
category_idstring
default_languagestring
default_audio_languagestring
privacy_statusstring

publicunlistedprivate

publish_atstring (date-time) | null
self_declared_made_for_kidsboolean
contains_synthetic_mediaboolean
has_paid_product_placementboolean
licensestring

youtubecreativeCommon

embeddableboolean
public_stats_viewableboolean
recording_datestring (date-time) | null
localizationsobject

BCP-47 language → { title, description }

brand_partnerobject
Show 2 child attributes
channel_idstring

pattern ^UC

channel_handlestring

pattern ^@

thumbnailstring

New custom thumbnail (JPEG/PNG ≤50 MB)

playlist_idstring

Also add to this playlist

Returns object

idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤5000 bytes

≤ 5000 characters

tagsarray of string

≤500 characters in total

category_idstring

See video-categories

default_languagestring
default_audio_languagestring
privacy_statusstring

publicunlistedprivate

publish_atstring (date-time) | null

Scheduled release (video must be private and never published)

is_scheduledbooleanread-only
self_declared_made_for_kidsboolean

Made for kids (COPPA)

made_for_kidsbooleanread-only
contains_synthetic_mediaboolean

Altered or synthetic content

has_paid_product_placementboolean

Includes paid promotion

licensestring

youtubecreativeCommon

embeddableboolean
public_stats_viewableboolean
recording_datestring (date-time) | null
thumbnail_urlstring (uri)read-only
published_atstring (date-time)read-only
upload_statusstringread-only

uploadedprocessedfailedrejecteddeleted

failure_reasonstring | nullread-only
rejection_reasonstring | nullread-only
processing_statusstring | nullread-only
duration_secondsinteger | nullread-only
definitionstring | nullread-only
captionboolean | nullread-only
has_custom_thumbnailboolean | nullread-only
is_shortboolean | nullread-only

Heuristic: vertical/square and ≤180 s

is_livebooleanread-only
view_countinteger | nullread-only
like_countinteger | nullread-only
comment_countinteger | nullread-only
widthinteger | nullread-only
heightinteger | nullread-only
localizationsobjectread-only

BCP-47 language → { title, description }

urlstring (uri)read-only
studio_urlstring (uri)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/shorts/{itemId}
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

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

Try it with MCPAsk your agent to call youtube-shorts-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/shorts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/shorts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-shorts-rate (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

ratingstringrequired

likedislikenone

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/shorts/{itemId}/rate
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-shorts-add-to-playlist (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

playlist_idstringrequired
positioninteger
notestring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/shorts/{itemId}/add-to-playlist
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-shorts-set-visibility (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

privacy_statusstringrequired

publicunlistedprivate

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/shorts/{itemId}/set-visibility
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-shorts-schedule (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

publish_atstring (date-time)required

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/shorts/{itemId}/schedule
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

Scheduled

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

Try it with MCPAsk your agent to call youtube-scheduled-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring
scan_pagesintegerdefault: 4

1–10

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 38 item attributes
idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤5000 bytes

≤ 5000 characters

tagsarray of string

≤500 characters in total

category_idstring

See video-categories

default_languagestring
default_audio_languagestring
privacy_statusstring

publicunlistedprivate

publish_atstring (date-time) | null

Scheduled release (video must be private and never published)

is_scheduledbooleanread-only
self_declared_made_for_kidsboolean

Made for kids (COPPA)

made_for_kidsbooleanread-only
contains_synthetic_mediaboolean

Altered or synthetic content

has_paid_product_placementboolean

Includes paid promotion

licensestring

youtubecreativeCommon

embeddableboolean
public_stats_viewableboolean
recording_datestring (date-time) | null
thumbnail_urlstring (uri)read-only
published_atstring (date-time)read-only
upload_statusstringread-only

uploadedprocessedfailedrejecteddeleted

failure_reasonstring | nullread-only
rejection_reasonstring | nullread-only
processing_statusstring | nullread-only
duration_secondsinteger | nullread-only
definitionstring | nullread-only
captionboolean | nullread-only
has_custom_thumbnailboolean | nullread-only
is_shortboolean | nullread-only

Heuristic: vertical/square and ≤180 s

is_livebooleanread-only
view_countinteger | nullread-only
like_countinteger | nullread-only
comment_countinteger | nullread-only
widthinteger | nullread-only
heightinteger | nullread-only
localizationsobjectread-only

BCP-47 language → { title, description }

urlstring (uri)read-only
studio_urlstring (uri)read-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/scheduled
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/scheduled" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call youtube-scheduled-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤5000 bytes

≤ 5000 characters

tagsarray of string

≤500 characters in total

category_idstring

See video-categories

default_languagestring
default_audio_languagestring
privacy_statusstring

publicunlistedprivate

publish_atstring (date-time) | null

Scheduled release (video must be private and never published)

is_scheduledbooleanread-only
self_declared_made_for_kidsboolean

Made for kids (COPPA)

made_for_kidsbooleanread-only
contains_synthetic_mediaboolean

Altered or synthetic content

has_paid_product_placementboolean

Includes paid promotion

licensestring

youtubecreativeCommon

embeddableboolean
public_stats_viewableboolean
recording_datestring (date-time) | null
thumbnail_urlstring (uri)read-only
published_atstring (date-time)read-only
upload_statusstringread-only

uploadedprocessedfailedrejecteddeleted

failure_reasonstring | nullread-only
rejection_reasonstring | nullread-only
processing_statusstring | nullread-only
duration_secondsinteger | nullread-only
definitionstring | nullread-only
captionboolean | nullread-only
has_custom_thumbnailboolean | nullread-only
is_shortboolean | nullread-only

Heuristic: vertical/square and ≤180 s

is_livebooleanread-only
view_countinteger | nullread-only
like_countinteger | nullread-only
comment_countinteger | nullread-only
widthinteger | nullread-only
heightinteger | nullread-only
localizationsobjectread-only

BCP-47 language → { title, description }

urlstring (uri)read-only
studio_urlstring (uri)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/scheduled/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/scheduled/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call youtube-scheduled-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring

≤ 100 characters

descriptionstring

≤ 5000 characters

tagsarray of string
category_idstring
default_languagestring
default_audio_languagestring
privacy_statusstring

publicunlistedprivate

publish_atstring (date-time) | null
self_declared_made_for_kidsboolean
contains_synthetic_mediaboolean
has_paid_product_placementboolean
licensestring

youtubecreativeCommon

embeddableboolean
public_stats_viewableboolean
recording_datestring (date-time) | null
localizationsobject

BCP-47 language → { title, description }

brand_partnerobject
Show 2 child attributes
channel_idstring

pattern ^UC

channel_handlestring

pattern ^@

thumbnailstring

New custom thumbnail (JPEG/PNG ≤50 MB)

playlist_idstring

Also add to this playlist

Returns object

idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤5000 bytes

≤ 5000 characters

tagsarray of string

≤500 characters in total

category_idstring

See video-categories

default_languagestring
default_audio_languagestring
privacy_statusstring

publicunlistedprivate

publish_atstring (date-time) | null

Scheduled release (video must be private and never published)

is_scheduledbooleanread-only
self_declared_made_for_kidsboolean

Made for kids (COPPA)

made_for_kidsbooleanread-only
contains_synthetic_mediaboolean

Altered or synthetic content

has_paid_product_placementboolean

Includes paid promotion

licensestring

youtubecreativeCommon

embeddableboolean
public_stats_viewableboolean
recording_datestring (date-time) | null
thumbnail_urlstring (uri)read-only
published_atstring (date-time)read-only
upload_statusstringread-only

uploadedprocessedfailedrejecteddeleted

failure_reasonstring | nullread-only
rejection_reasonstring | nullread-only
processing_statusstring | nullread-only
duration_secondsinteger | nullread-only
definitionstring | nullread-only
captionboolean | nullread-only
has_custom_thumbnailboolean | nullread-only
is_shortboolean | nullread-only

Heuristic: vertical/square and ≤180 s

is_livebooleanread-only
view_countinteger | nullread-only
like_countinteger | nullread-only
comment_countinteger | nullread-only
widthinteger | nullread-only
heightinteger | nullread-only
localizationsobjectread-only

BCP-47 language → { title, description }

urlstring (uri)read-only
studio_urlstring (uri)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/scheduled/{itemId}
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

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

Try it with MCPAsk your agent to call youtube-scheduled-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/scheduled/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/scheduled/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-scheduled-publish-now (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/scheduled/{itemId}/publish-now
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-scheduled-unschedule (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/scheduled/{itemId}/unschedule
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

Video localizations

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

Try it with MCPAsk your agent to call youtube-video-localizations-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

video_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstringread-only

~

video_idstringrequired
languagestringrequired
titlestringrequired

≤ 100 characters

descriptionstring

≤ 5000 characters

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/video-localizations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/video-localizations?video_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-video-localizations-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

video_idstringrequired
languagestringrequired
titlestringrequired

≤ 100 characters

descriptionstring
default_languagestring

Set the video default language if missing

Returns object

idstringread-only

~

video_idstringrequired
languagestringrequired
titlestringrequired

≤ 100 characters

descriptionstring

≤ 5000 characters

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/video-localizations
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

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

Try it with MCPAsk your agent to call youtube-video-localizations-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring

≤ 100 characters

descriptionstring

Returns object

idstringread-only

~

video_idstringrequired
languagestringrequired
titlestringrequired

≤ 100 characters

descriptionstring

≤ 5000 characters

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/video-localizations/{itemId}
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

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

Try it with MCPAsk your agent to call youtube-video-localizations-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/video-localizations/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/video-localizations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Captions

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: readZernio: GET /v1/accounts/{accountId}/youtube-captions

Try it with MCPAsk your agent to call youtube-captions-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

video_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstringread-only
video_idstringrequired
languagestringrequired
namestring

≤ 150 characters

track_kindstringread-only

standardasrforced

audio_track_typestring | nullread-only
is_draftboolean
is_ccboolean | nullread-only
is_auto_syncedboolean | nullread-only
statusstringread-only

servingsyncingfailed

failure_reasonstring | nullread-only
last_updatedstring (date-time)read-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/captions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/captions?video_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-captions-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

video_idstringrequired
languagestringrequired
namestring

≤ 150 characters

is_draftbooleandefault: false
mediastring
textstring

Or paste the caption file content

Returns object

idstringread-only
video_idstringrequired
languagestringrequired
namestring

≤ 150 characters

track_kindstringread-only

standardasrforced

audio_track_typestring | nullread-only
is_draftboolean
is_ccboolean | nullread-only
is_auto_syncedboolean | nullread-only
statusstringread-only

servingsyncingfailed

failure_reasonstring | nullread-only
last_updatedstring (date-time)read-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/captions
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

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

Try it with MCPAsk your agent to call youtube-captions-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

is_draftboolean
mediastring
textstring

Returns object

idstringread-only
video_idstringrequired
languagestringrequired
namestring

≤ 150 characters

track_kindstringread-only

standardasrforced

audio_track_typestring | nullread-only
is_draftboolean
is_ccboolean | nullread-only
is_auto_syncedboolean | nullread-only
statusstringread-only

servingsyncingfailed

failure_reasonstring | nullread-only
last_updatedstring (date-time)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/captions/{itemId}
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

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

Try it with MCPAsk your agent to call youtube-captions-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/captions/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/captions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-captions-download (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

tfmtstring

sbvsccsrtttmlvtt

tlangstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/captions/{itemId}/download
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-captions-transcript (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

video_idstringrequired
languagestring
formatstringdefault: "json"

jsonsrtvtt

track_idstring
tlangstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/captions/transcript
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

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

Try it with MCPAsk your agent to call youtube-search-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–50

cursorstring
qstring
for_minebooleandefault: true
channel_idstring
typestringdefault: "video"

videochannelplaylist

orderstring

dateratingrelevancetitlevideoCountviewCount

event_typestring

completedliveupcoming

published_afterstring (date-time)
published_beforestring (date-time)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstringread-only
kindstringread-only
titlestringread-only
descriptionstringread-only
published_atstring (date-time)read-only
channel_idstringread-only
channel_titlestringread-only
thumbnail_urlstring (uri)read-only
live_broadcast_contentstringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/search
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/search" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Playlists

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: readZernio: GET /v1/accounts/{accountId}/youtube-playlists

Try it with MCPAsk your agent to call youtube-playlists-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–50

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstringread-only
titlestringrequired

≤ 150 characters

descriptionstring

≤ 5000 characters

privacy_statusstring

publicunlistedprivate

item_countinteger | nullread-only
default_languagestring | null
localizationsobject

BCP-47 language → { title, description }

thumbnail_urlstring (uri) | nullread-only
published_atstring (date-time)read-only
podcast_statusstring | nullread-only
is_defaultbooleanread-only

Socialit default playlist (UI prefill only)

urlstring (uri)read-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/playlists
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

YouTube: Create a Playlists item

POST/accounts/{accountId}/youtube/playlists

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/youtube-playlists

Try it with MCPAsk your agent to call youtube-playlists-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

titlestringrequired

≤ 150 characters

descriptionstring

≤ 5000 characters

privacy_statusstringdefault: "private"

publicunlistedprivate

default_languagestring
localizationsobject

BCP-47 language → { title, description }

Returns object

idstringread-only
titlestringrequired

≤ 150 characters

descriptionstring

≤ 5000 characters

privacy_statusstring

publicunlistedprivate

item_countinteger | nullread-only
default_languagestring | null
localizationsobject

BCP-47 language → { title, description }

thumbnail_urlstring (uri) | nullread-only
published_atstring (date-time)read-only
podcast_statusstring | nullread-only
is_defaultbooleanread-only

Socialit default playlist (UI prefill only)

urlstring (uri)read-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/playlists
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

YouTube: Get a Playlists item

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

Access: read

Try it with MCPAsk your agent to call youtube-playlists-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
titlestringrequired

≤ 150 characters

descriptionstring

≤ 5000 characters

privacy_statusstring

publicunlistedprivate

item_countinteger | nullread-only
default_languagestring | null
localizationsobject

BCP-47 language → { title, description }

thumbnail_urlstring (uri) | nullread-only
published_atstring (date-time)read-only
podcast_statusstring | nullread-only
is_defaultbooleanread-only

Socialit default playlist (UI prefill only)

urlstring (uri)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/playlists/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

YouTube: Update a Playlists item

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

Access: writeZernio: PUT /v1/accounts/{accountId}/youtube-playlists

Try it with MCPAsk your agent to call youtube-playlists-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring

≤ 150 characters

descriptionstring

≤ 5000 characters

privacy_statusstringdefault: "private"

publicunlistedprivate

default_languagestring
localizationsobject

BCP-47 language → { title, description }

Returns object

idstringread-only
titlestringrequired

≤ 150 characters

descriptionstring

≤ 5000 characters

privacy_statusstring

publicunlistedprivate

item_countinteger | nullread-only
default_languagestring | null
localizationsobject

BCP-47 language → { title, description }

thumbnail_urlstring (uri) | nullread-only
published_atstring (date-time)read-only
podcast_statusstring | nullread-only
is_defaultbooleanread-only

Socialit default playlist (UI prefill only)

urlstring (uri)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/playlists/{itemId}
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

YouTube: Delete a Playlists item

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

Access: write

Try it with MCPAsk your agent to call youtube-playlists-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/playlists/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-playlists-set-default (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/playlists/{itemId}/set-default
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

YouTube: Add video (Playlists)

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

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-playlists-add-video (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

video_idstringrequired
positioninteger
notestring

≤ 280 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/playlists/{itemId}/add-video
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

Playlist items

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

Try it with MCPAsk your agent to call youtube-playlist-items-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–50

cursorstring
playlist_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 13 item attributes
idstringread-only
playlist_idstringrequired
video_idstringrequired
titlestringread-only
positioninteger
notestring | null

≤ 280 characters

start_atstring | null
end_atstring | null
thumbnail_urlstring (uri) | nullread-only
video_published_atstring (date-time) | nullread-only
added_atstring (date-time)read-only
privacy_statusstring | nullread-only
video_owner_channel_titlestring | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/playlist-items
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlist-items" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-playlist-items-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

playlist_idstringrequired
video_idstringrequired
positioninteger
notestring

≤ 280 characters

Returns object

idstringread-only
playlist_idstringrequired
video_idstringrequired
titlestringread-only
positioninteger
notestring | null

≤ 280 characters

start_atstring | null
end_atstring | null
thumbnail_urlstring (uri) | nullread-only
video_published_atstring (date-time) | nullread-only
added_atstring (date-time)read-only
privacy_statusstring | nullread-only
video_owner_channel_titlestring | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/playlist-items
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

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

Try it with MCPAsk your agent to call youtube-playlist-items-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

positioninteger
notestring

≤ 280 characters

playlist_idstring
video_idstring

Returns object

idstringread-only
playlist_idstringrequired
video_idstringrequired
titlestringread-only
positioninteger
notestring | null

≤ 280 characters

start_atstring | null
end_atstring | null
thumbnail_urlstring (uri) | nullread-only
video_published_atstring (date-time) | nullread-only
added_atstring (date-time)read-only
privacy_statusstring | nullread-only
video_owner_channel_titlestring | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/playlist-items/{itemId}
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

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

Try it with MCPAsk your agent to call youtube-playlist-items-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/playlist-items/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlist-items/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-playlist-items-move (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

positionintegerrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/playlist-items/{itemId}/move
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

Playlist images

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

Try it with MCPAsk your agent to call youtube-playlist-images-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–50

cursorstring
playlist_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstringread-only
playlist_idstringrequired
typestringdefault: "hero"
widthinteger | nullread-only
heightinteger | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/playlist-images
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlist-images" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-playlist-images-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

playlist_idstringrequired
mediastringrequired
typestringdefault: "hero"

Returns object

idstringread-only
playlist_idstringrequired
typestringdefault: "hero"
widthinteger | nullread-only
heightinteger | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/playlist-images
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

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

Try it with MCPAsk your agent to call youtube-playlist-images-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

playlist_idstringrequired
mediastringrequired
typestring

Returns object

idstringread-only
playlist_idstringrequired
typestringdefault: "hero"
widthinteger | nullread-only
heightinteger | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/playlist-images/{itemId}
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

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

Try it with MCPAsk your agent to call youtube-playlist-images-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/playlist-images/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/playlist-images/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Analytics overview

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: readZernio: GET /v1/analytics/youtube/channel-insights

Try it with MCPAsk your agent to call youtube-analytics-overview-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (default: 28 days ago)

untilstring (date)

YYYY-MM-DD (default: today)

granularitystringdefault: "day"

daymonth

video_idstring

Returns object

sincestringread-only
untilstringread-only
totalsobjectread-only

Normalized metrics

seriesarray of objectread-only
Show 2 item attributes
datestring
metricsobject
youtube_totalsobjectread-only

YouTube-named totals

youtube_seriesarray of objectread-only
Show 2 item attributes
datestring
metricsobject
content_typesarray of objectread-only
insightsobjectread-only

Zernio channel-insights shape

errorsobjectread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-overview
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-overview" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Analytics reach

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

Try it with MCPAsk your agent to call youtube-analytics-reach-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (default: 28 days ago)

untilstring (date)

YYYY-MM-DD (default: today)

video_idstring

Filter to one video

playlist_idstring
group_idstring

Analytics group

countrystring

ISO 3166-1 alpha-2

creator_content_typestring

SHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY

include_impressionsbooleandefault: false

Read channel_reach_basic_a1 bulk reports

Returns object

sincestring (date)read-only
untilstring (date)read-only
sectionsobjectread-only
errorsobjectread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-reach
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-reach" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Analytics engagement

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

Try it with MCPAsk your agent to call youtube-analytics-engagement-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (default: 28 days ago)

untilstring (date)

YYYY-MM-DD (default: today)

video_idstring

Filter to one video

playlist_idstring
group_idstring

Analytics group

countrystring

ISO 3166-1 alpha-2

creator_content_typestring

SHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY

Returns object

sincestring (date)read-only
untilstring (date)read-only
sectionsobjectread-only
errorsobjectread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-engagement
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-engagement" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Analytics audience

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: readZernio: GET /v1/analytics/youtube/demographics

Try it with MCPAsk your agent to call youtube-analytics-audience-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (default: 28 days ago)

untilstring (date)

YYYY-MM-DD (default: today)

video_idstring

Filter to one video

playlist_idstring
group_idstring

Analytics group

countrystring

ISO 3166-1 alpha-2

creator_content_typestring

SHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY

Returns object

sincestring (date)read-only
untilstring (date)read-only
sectionsobjectread-only
errorsobjectread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-audience
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-audience" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Analytics demographics

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: readZernio: GET /v1/analytics/youtube/demographics

Try it with MCPAsk your agent to call youtube-analytics-demographics-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (default: 28 days ago)

untilstring (date)

YYYY-MM-DD (default: today)

video_idstring
breakdownstringdefault: "age,gender,country"

Returns object

demographicsobjectread-only
Show 3 child attributes
agearray of object
Show 2 item attributes
dimensionstring
valuenumber
genderarray of object
Show 2 item attributes
dimensionstring
valuenumber
countryarray of object
Show 2 item attributes
dimensionstring
valuenumber

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-demographics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-demographics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Analytics geography

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

Try it with MCPAsk your agent to call youtube-analytics-geography-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (default: 28 days ago)

untilstring (date)

YYYY-MM-DD (default: today)

video_idstring

Filter to one video

playlist_idstring
group_idstring

Analytics group

countrystring

ISO 3166-1 alpha-2

creator_content_typestring

SHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY

Returns object

sincestring (date)read-only
untilstring (date)read-only
sectionsobjectread-only
errorsobjectread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-geography
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-geography" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Analytics devices

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

Try it with MCPAsk your agent to call youtube-analytics-devices-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (default: 28 days ago)

untilstring (date)

YYYY-MM-DD (default: today)

video_idstring

Filter to one video

playlist_idstring
group_idstring

Analytics group

countrystring

ISO 3166-1 alpha-2

creator_content_typestring

SHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY

Returns object

sincestring (date)read-only
untilstring (date)read-only
sectionsobjectread-only
errorsobjectread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-devices
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-devices" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Analytics content types

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

Try it with MCPAsk your agent to call youtube-analytics-content-types-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (default: 28 days ago)

untilstring (date)

YYYY-MM-DD (default: today)

video_idstring

Filter to one video

playlist_idstring
group_idstring

Analytics group

countrystring

ISO 3166-1 alpha-2

creator_content_typestring

SHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY

Returns object

sincestring (date)read-only
untilstring (date)read-only
sectionsobjectread-only
errorsobjectread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-content-types
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-content-types" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Analytics video

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: readZernio: GET /v1/analytics/youtube/daily-views

Try it with MCPAsk your agent to call youtube-analytics-video-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (default: 28 days ago)

untilstring (date)

YYYY-MM-DD (default: today)

video_idstring

Returns object

video_idstringread-only
dailyobjectread-only
sectionsobjectread-only
errorsobjectread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-video
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-video" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Analytics retention

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: readZernio: GET /v1/analytics/youtube/video-retention

Try it with MCPAsk your agent to call youtube-analytics-retention-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (default: 28 days ago)

untilstring (date)

YYYY-MM-DD (default: today)

video_idstring
audience_typestring

ORGANICAD_INSTREAMAD_INDISPLAY

Returns object

videoIdstringread-only
titlestring | nullread-only
durationSecondsinteger | nullread-only
retentionCurvearray of objectread-only
Show 6 item attributes
elapsedVideoTimeRationumber
audienceWatchRationumber | null
relativeRetentionPerformancenumber | null
startedWatchingnumber | null
stoppedWatchingnumber | null
totalSegmentImpressionsnumber | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-retention
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-retention" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Analytics playlists

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

Try it with MCPAsk your agent to call youtube-analytics-playlists-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (default: 28 days ago)

untilstring (date)

YYYY-MM-DD (default: today)

video_idstring

Filter to one video

playlist_idstring
group_idstring

Analytics group

countrystring

ISO 3166-1 alpha-2

creator_content_typestring

SHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY

Returns object

sincestring (date)read-only
untilstring (date)read-only
sectionsobjectread-only
errorsobjectread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-playlists
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-playlists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Analytics live

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

Try it with MCPAsk your agent to call youtube-analytics-live-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (default: 28 days ago)

untilstring (date)

YYYY-MM-DD (default: today)

video_idstring

Filter to one video

playlist_idstring
group_idstring

Analytics group

countrystring

ISO 3166-1 alpha-2

creator_content_typestring

SHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY

Returns object

sincestring (date)read-only
untilstring (date)read-only
sectionsobjectread-only
errorsobjectread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-live
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-live" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Analytics report

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

Try it with MCPAsk your agent to call youtube-analytics-report-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (default: 28 days ago)

untilstring (date)

YYYY-MM-DD (default: today)

video_idstring

Filter to one video

playlist_idstring
group_idstring

Analytics group

countrystring

ISO 3166-1 alpha-2

creator_content_typestring

SHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY

reportstringdefault: "daily"

overviewdailymonthlyengaged-viewsengagementwatch-timesubscriberssubscribers-by-videotop-videostraffic-sourcestraffic-sources-dailytraffic-source-detailsearch-termsexternal-sitesplayback-locationsplayback-location-detaildevicesoperating-systemsdevice-oscountriesprovincescitiessubscribed-statussharing-services+30 more

metricsstring

custom: comma-separated metrics

dimensionsstring
filtersstring

dim==value;dim2==a,b

sortstring
max_resultsinteger

1–250

currencystring

ISO 4217 for revenue reports

source_typestring

traffic-source-detail: insightTrafficSourceType

report_type_idstring

bulk: Reporting API report type

create_jobboolean

Returns object

reportstringread-only
labelstringread-only
sincestringread-only
untilstringread-only
columnsarray of objectread-only
Show 3 item attributes
namestring
typestring
data_typestring | null
rowsarray of array of anyread-only
itemsarray of objectread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-report
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-report" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Analytics groups

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

Try it with MCPAsk your agent to call youtube-analytics-groups-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstringread-only
titlestringrequired
item_typestringrequired

youtube#videoyoutube#playlistyoutube#channelyoutubePartner#asset

item_countinteger | nullread-only
published_atstring (date-time)read-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-groups
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-groups" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-analytics-groups-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

titlestringrequired
item_typestringdefault: "youtube#video"

youtube#videoyoutube#playlistyoutube#channelyoutubePartner#asset

Returns object

idstringread-only
titlestringrequired
item_typestringrequired

youtube#videoyoutube#playlistyoutube#channelyoutubePartner#asset

item_countinteger | nullread-only
published_atstring (date-time)read-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/analytics-groups
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

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

Try it with MCPAsk your agent to call youtube-analytics-groups-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
titlestringrequired
item_typestringrequired

youtube#videoyoutube#playlistyoutube#channelyoutubePartner#asset

item_countinteger | nullread-only
published_atstring (date-time)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-groups/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-groups/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call youtube-analytics-groups-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestringrequired

Returns object

idstringread-only
titlestringrequired
item_typestringrequired

youtube#videoyoutube#playlistyoutube#channelyoutubePartner#asset

item_countinteger | nullread-only
published_atstring (date-time)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/analytics-groups/{itemId}
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

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

Try it with MCPAsk your agent to call youtube-analytics-groups-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/analytics-groups/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-groups/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-analytics-groups-add-item (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

resource_idstringrequired
kindstringdefault: "youtube#video"

youtube#videoyoutube#playlistyoutube#channelyoutubePartner#asset

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/analytics-groups/{itemId}/add-item
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

Analytics group items

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

Try it with MCPAsk your agent to call youtube-analytics-group-items-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

group_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstringread-only
group_idstringrequired
kindstring

youtube#videoyoutube#playlistyoutube#channelyoutubePartner#asset

resource_idstringrequired
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/analytics-group-items
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/analytics-group-items?group_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-analytics-group-items-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

group_idstringrequired
resource_idstringrequired
kindstringdefault: "youtube#video"

youtube#videoyoutube#playlistyoutube#channelyoutubePartner#asset

Returns object

idstringread-only
group_idstringrequired
kindstring

youtube#videoyoutube#playlistyoutube#channelyoutubePartner#asset

resource_idstringrequired

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/analytics-group-items
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

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

Try it with MCPAsk your agent to call youtube-analytics-group-items-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/analytics-group-items/{itemId}
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

Report types

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

Try it with MCPAsk your agent to call youtube-report-types-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

include_system_managedboolean
cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstringread-only
namestringread-only
system_managedbooleanread-only
deprecate_timestring (date-time) | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/report-types
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/report-types" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Reporting jobs

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

Try it with MCPAsk your agent to call youtube-reporting-jobs-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

include_system_managedboolean
cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
report_type_idstringrequired
namestring
create_timestring (date-time)read-only
expire_timestring (date-time) | nullread-only
system_managedbooleanread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/reporting-jobs
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/reporting-jobs" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-reporting-jobs-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

report_type_idstringrequired

e.g. channel_reach_basic_a1, channel_basic_a3

namestring

Returns object

idstringread-only
report_type_idstringrequired
namestring
create_timestring (date-time)read-only
expire_timestring (date-time) | nullread-only
system_managedbooleanread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/reporting-jobs
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

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

Try it with MCPAsk your agent to call youtube-reporting-jobs-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/reporting-jobs/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/reporting-jobs/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-reporting-jobs-reports (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/reporting-jobs/{itemId}/reports
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

Reporting reports

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

Try it with MCPAsk your agent to call youtube-reporting-reports-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

job_idstringrequired
created_afterstring (date-time)
sincestring (date)
untilstring (date)
cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
job_idstringread-only
start_timestring (date-time)read-only
end_timestring (date-time)read-only
create_timestring (date-time)read-only
download_urlstring (uri)read-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/reporting-reports
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/reporting-reports?job_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-reporting-reports-download (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

job_idstringrequired
parsebooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/reporting-reports/{itemId}/download
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

Comments

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: readZernio: GET /v1/inbox/comments

Try it with MCPAsk your agent to call youtube-comments-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

cursorstring
video_idstring
moderation_statusstringdefault: "published"

publishedheldForReviewlikelySpam

orderstringdefault: "time"

timerelevance

search_termsstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 20 item attributes
idstringread-only
textstringrequired

≤ 10000 characters

text_htmlstring | nullread-only
authorstringread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
author_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
updated_atstring (date-time) | nullread-only
like_countintegerread-only
post_idstring | nullread-only

Video id

thread_idstring | nullread-only
parent_idstring | nullread-only
is_replybooleanread-only
reply_countintegerread-only
can_replyboolean | nullread-only
moderation_statusstringread-only

publishedheldForReviewlikelySpamrejected

image_urlstring (uri) | nullread-only
is_ownbooleanread-only
repliesarray of objectread-only
Show 19 item attributes
idstringread-only
textstring

≤ 10000 characters

text_htmlstring | nullread-only
authorstringread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
author_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
updated_atstring (date-time) | nullread-only
like_countintegerread-only
post_idstring | nullread-only

Video id

thread_idstring | nullread-only
parent_idstring | nullread-only
is_replybooleanread-only
reply_countintegerread-only
can_replyboolean | nullread-only
moderation_statusstringread-only

publishedheldForReviewlikelySpamrejected

image_urlstring (uri) | nullread-only
is_ownbooleanread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/comments
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}POST /v1/inbox/comments/{postId}/{commentId}/moderation

Try it with MCPAsk your agent to call youtube-comments-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

video_idstringrequired
textstringrequired

≤ 10000 characters

Returns object

idstringread-only
textstringrequired

≤ 10000 characters

text_htmlstring | nullread-only
authorstringread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
author_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
updated_atstring (date-time) | nullread-only
like_countintegerread-only
post_idstring | nullread-only

Video id

thread_idstring | nullread-only
parent_idstring | nullread-only
is_replybooleanread-only
reply_countintegerread-only
can_replyboolean | nullread-only
moderation_statusstringread-only

publishedheldForReviewlikelySpamrejected

image_urlstring (uri) | nullread-only
is_ownbooleanread-only
repliesarray of objectread-only
Show 19 item attributes
idstringread-only
textstring

≤ 10000 characters

text_htmlstring | nullread-only
authorstringread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
author_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
updated_atstring (date-time) | nullread-only
like_countintegerread-only
post_idstring | nullread-only

Video id

thread_idstring | nullread-only
parent_idstring | nullread-only
is_replybooleanread-only
reply_countintegerread-only
can_replyboolean | nullread-only
moderation_statusstringread-only

publishedheldForReviewlikelySpamrejected

image_urlstring (uri) | nullread-only
is_ownbooleanread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/comments
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

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: readZernio: GET /v1/inbox/comments/{postId}

Try it with MCPAsk your agent to call youtube-comments-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
textstringrequired

≤ 10000 characters

text_htmlstring | nullread-only
authorstringread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
author_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
updated_atstring (date-time) | nullread-only
like_countintegerread-only
post_idstring | nullread-only

Video id

thread_idstring | nullread-only
parent_idstring | nullread-only
is_replybooleanread-only
reply_countintegerread-only
can_replyboolean | nullread-only
moderation_statusstringread-only

publishedheldForReviewlikelySpamrejected

image_urlstring (uri) | nullread-only
is_ownbooleanread-only
repliesarray of objectread-only
Show 19 item attributes
idstringread-only
textstring

≤ 10000 characters

text_htmlstring | nullread-only
authorstringread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
author_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
updated_atstring (date-time) | nullread-only
like_countintegerread-only
post_idstring | nullread-only

Video id

thread_idstring | nullread-only
parent_idstring | nullread-only
is_replybooleanread-only
reply_countintegerread-only
can_replyboolean | nullread-only
moderation_statusstringread-only

publishedheldForReviewlikelySpamrejected

image_urlstring (uri) | nullread-only
is_ownbooleanread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/comments/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call youtube-comments-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

textstringrequired

≤ 10000 characters

Returns object

idstringread-only
textstringrequired

≤ 10000 characters

text_htmlstring | nullread-only
authorstringread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
author_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
updated_atstring (date-time) | nullread-only
like_countintegerread-only
post_idstring | nullread-only

Video id

thread_idstring | nullread-only
parent_idstring | nullread-only
is_replybooleanread-only
reply_countintegerread-only
can_replyboolean | nullread-only
moderation_statusstringread-only

publishedheldForReviewlikelySpamrejected

image_urlstring (uri) | nullread-only
is_ownbooleanread-only
repliesarray of objectread-only
Show 19 item attributes
idstringread-only
textstring

≤ 10000 characters

text_htmlstring | nullread-only
authorstringread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
author_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
updated_atstring (date-time) | nullread-only
like_countintegerread-only
post_idstring | nullread-only

Video id

thread_idstring | nullread-only
parent_idstring | nullread-only
is_replybooleanread-only
reply_countintegerread-only
can_replyboolean | nullread-only
moderation_statusstringread-only

publishedheldForReviewlikelySpamrejected

image_urlstring (uri) | nullread-only
is_ownbooleanread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/comments/{itemId}
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

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: writeZernio: DELETE /v1/inbox/comments/{postId}

Try it with MCPAsk your agent to call youtube-comments-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/comments/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-comments-reply (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

textstringrequired

≤ 10000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/comments/{itemId}/reply
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-comments-approve (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/comments/{itemId}/approve
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-comments-hold (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/comments/{itemId}/hold
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

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

Try it with MCPAsk your agent to call youtube-comments-reject (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

ban_authorbooleandefault: false

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/comments/{itemId}/reject
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

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

Try it with MCPAsk your agent to call youtube-comments-ban-author (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/comments/{itemId}/ban-author
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

Comment replies

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

Try it with MCPAsk your agent to call youtube-comment-replies-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

cursorstring
parent_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 19 item attributes
idstringread-only
textstringrequired

≤ 10000 characters

text_htmlstring | nullread-only
authorstringread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
author_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
updated_atstring (date-time) | nullread-only
like_countintegerread-only
post_idstring | nullread-only

Video id

thread_idstring | nullread-only
parent_idstringrequired
is_replybooleanread-only
reply_countintegerread-only
can_replyboolean | nullread-only
moderation_statusstringread-only

publishedheldForReviewlikelySpamrejected

image_urlstring (uri) | nullread-only
is_ownbooleanread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/comment-replies
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comment-replies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-comment-replies-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

parent_idstringrequired
textstringrequired

≤ 10000 characters

Returns object

idstringread-only
textstringrequired

≤ 10000 characters

text_htmlstring | nullread-only
authorstringread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
author_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
updated_atstring (date-time) | nullread-only
like_countintegerread-only
post_idstring | nullread-only

Video id

thread_idstring | nullread-only
parent_idstringrequired
is_replybooleanread-only
reply_countintegerread-only
can_replyboolean | nullread-only
moderation_statusstringread-only

publishedheldForReviewlikelySpamrejected

image_urlstring (uri) | nullread-only
is_ownbooleanread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/comment-replies
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

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

Try it with MCPAsk your agent to call youtube-comment-replies-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

textstringrequired

≤ 10000 characters

Returns object

idstringread-only
textstringrequired

≤ 10000 characters

text_htmlstring | nullread-only
authorstringread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
author_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
updated_atstring (date-time) | nullread-only
like_countintegerread-only
post_idstring | nullread-only

Video id

thread_idstring | nullread-only
parent_idstringrequired
is_replybooleanread-only
reply_countintegerread-only
can_replyboolean | nullread-only
moderation_statusstringread-only

publishedheldForReviewlikelySpamrejected

image_urlstring (uri) | nullread-only
is_ownbooleanread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/comment-replies/{itemId}
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

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

Try it with MCPAsk your agent to call youtube-comment-replies-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/comment-replies/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/comment-replies/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-comment-replies-approve (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/comment-replies/{itemId}/approve
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-comment-replies-hold (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/comment-replies/{itemId}/hold
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

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

Try it with MCPAsk your agent to call youtube-comment-replies-reject (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

ban_authorbooleandefault: false

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/comment-replies/{itemId}/reject
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

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

Try it with MCPAsk your agent to call youtube-comment-replies-ban-author (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/comment-replies/{itemId}/ban-author
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

Held for review

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

Try it with MCPAsk your agent to call youtube-held-for-review-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

cursorstring
queuestringdefault: "heldForReview"

heldForReviewlikelySpam

video_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 20 item attributes
idstringread-only
textstringrequired

≤ 10000 characters

text_htmlstring | nullread-only
authorstringread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
author_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
updated_atstring (date-time) | nullread-only
like_countintegerread-only
post_idstring | nullread-only

Video id

thread_idstring | nullread-only
parent_idstring | nullread-only
is_replybooleanread-only
reply_countintegerread-only
can_replyboolean | nullread-only
moderation_statusstringread-only

publishedheldForReviewlikelySpamrejected

image_urlstring (uri) | nullread-only
is_ownbooleanread-only
repliesarray of objectread-only
Show 19 item attributes
idstringread-only
textstring

≤ 10000 characters

text_htmlstring | nullread-only
authorstringread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
author_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
updated_atstring (date-time) | nullread-only
like_countintegerread-only
post_idstring | nullread-only

Video id

thread_idstring | nullread-only
parent_idstring | nullread-only
is_replybooleanread-only
reply_countintegerread-only
can_replyboolean | nullread-only
moderation_statusstringread-only

publishedheldForReviewlikelySpamrejected

image_urlstring (uri) | nullread-only
is_ownbooleanread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/held-for-review
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/held-for-review" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}/{commentId}/moderation

Try it with MCPAsk your agent to call youtube-held-for-review-reply (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

textstringrequired

≤ 10000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/held-for-review/{itemId}/reply
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-held-for-review-approve (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/held-for-review/{itemId}/approve
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-held-for-review-hold (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/held-for-review/{itemId}/hold
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

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

Try it with MCPAsk your agent to call youtube-held-for-review-reject (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

ban_authorbooleandefault: false

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/held-for-review/{itemId}/reject
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

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

Try it with MCPAsk your agent to call youtube-held-for-review-ban-author (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/held-for-review/{itemId}/ban-author
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-held-for-review-bulk-moderate (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

idsarray of stringrequired

≥ 1 items

moderation_statusstringrequired

publishedheldForReviewrejected

ban_authorbooleandefault: false

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/held-for-review/bulk-moderate
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

Live broadcasts

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

Try it with MCPAsk your agent to call youtube-live-broadcasts-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–50

cursorstring
statusstring

allactivecompletedupcoming

typestringdefault: "all"

alleventpersistent

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 26 item attributes
idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤ 5000 characters

scheduled_start_timestring (date-time)required
scheduled_end_timestring (date-time) | null
actual_start_timestring (date-time) | nullread-only
actual_end_timestring (date-time) | nullread-only
privacy_statusstring

publicunlistedprivate

self_declared_made_for_kidsboolean
life_cycle_statusstringread-only

completecreatedliveliveStartingreadyrevokedtestStartingtesting

recording_statusstring | nullread-only
bound_stream_idstring | nullread-only
live_chat_idstring | nullread-only
enable_auto_startboolean
enable_auto_stopboolean
enable_dvrboolean
enable_embedboolean
record_from_startboolean
enable_closed_captionsboolean
closed_captions_typestring

closedCaptionsDisabledclosedCaptionsHttpPostclosedCaptionsEmbedded

latency_preferencestring

normallowultraLow

projectionstring

rectangular360

enable_monitor_streamboolean
broadcast_stream_delay_msinteger
thumbnail_urlstring (uri) | nullread-only
urlstring (uri)read-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/live-broadcasts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-broadcasts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-live-broadcasts-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

titlestringrequired

≤ 100 characters

descriptionstring

≤ 5000 characters

scheduled_start_timestring (date-time)required
scheduled_end_timestring (date-time) | null
privacy_statusstring

publicunlistedprivate

self_declared_made_for_kidsboolean
enable_auto_startboolean
enable_auto_stopboolean
enable_dvrboolean
enable_embedboolean
record_from_startboolean
enable_closed_captionsboolean
closed_captions_typestring

closedCaptionsDisabledclosedCaptionsHttpPostclosedCaptionsEmbedded

latency_preferencestring

normallowultraLow

projectionstring

rectangular360

enable_monitor_streamboolean
broadcast_stream_delay_msinteger

Returns object

idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤ 5000 characters

scheduled_start_timestring (date-time)required
scheduled_end_timestring (date-time) | null
actual_start_timestring (date-time) | nullread-only
actual_end_timestring (date-time) | nullread-only
privacy_statusstring

publicunlistedprivate

self_declared_made_for_kidsboolean
life_cycle_statusstringread-only

completecreatedliveliveStartingreadyrevokedtestStartingtesting

recording_statusstring | nullread-only
bound_stream_idstring | nullread-only
live_chat_idstring | nullread-only
enable_auto_startboolean
enable_auto_stopboolean
enable_dvrboolean
enable_embedboolean
record_from_startboolean
enable_closed_captionsboolean
closed_captions_typestring

closedCaptionsDisabledclosedCaptionsHttpPostclosedCaptionsEmbedded

latency_preferencestring

normallowultraLow

projectionstring

rectangular360

enable_monitor_streamboolean
broadcast_stream_delay_msinteger
thumbnail_urlstring (uri) | nullread-only
urlstring (uri)read-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/live-broadcasts
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

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

Try it with MCPAsk your agent to call youtube-live-broadcasts-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤ 5000 characters

scheduled_start_timestring (date-time)required
scheduled_end_timestring (date-time) | null
actual_start_timestring (date-time) | nullread-only
actual_end_timestring (date-time) | nullread-only
privacy_statusstring

publicunlistedprivate

self_declared_made_for_kidsboolean
life_cycle_statusstringread-only

completecreatedliveliveStartingreadyrevokedtestStartingtesting

recording_statusstring | nullread-only
bound_stream_idstring | nullread-only
live_chat_idstring | nullread-only
enable_auto_startboolean
enable_auto_stopboolean
enable_dvrboolean
enable_embedboolean
record_from_startboolean
enable_closed_captionsboolean
closed_captions_typestring

closedCaptionsDisabledclosedCaptionsHttpPostclosedCaptionsEmbedded

latency_preferencestring

normallowultraLow

projectionstring

rectangular360

enable_monitor_streamboolean
broadcast_stream_delay_msinteger
thumbnail_urlstring (uri) | nullread-only
urlstring (uri)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/live-broadcasts/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-broadcasts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call youtube-live-broadcasts-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring

≤ 100 characters

descriptionstring

≤ 5000 characters

scheduled_start_timestring (date-time)
scheduled_end_timestring (date-time) | null
privacy_statusstring

publicunlistedprivate

self_declared_made_for_kidsboolean
enable_auto_startboolean
enable_auto_stopboolean
enable_dvrboolean
enable_embedboolean
record_from_startboolean
enable_closed_captionsboolean
closed_captions_typestring

closedCaptionsDisabledclosedCaptionsHttpPostclosedCaptionsEmbedded

latency_preferencestring

normallowultraLow

projectionstring

rectangular360

enable_monitor_streamboolean
broadcast_stream_delay_msinteger

Returns object

idstringread-only
titlestringrequired

≤ 100 characters

descriptionstring

≤ 5000 characters

scheduled_start_timestring (date-time)required
scheduled_end_timestring (date-time) | null
actual_start_timestring (date-time) | nullread-only
actual_end_timestring (date-time) | nullread-only
privacy_statusstring

publicunlistedprivate

self_declared_made_for_kidsboolean
life_cycle_statusstringread-only

completecreatedliveliveStartingreadyrevokedtestStartingtesting

recording_statusstring | nullread-only
bound_stream_idstring | nullread-only
live_chat_idstring | nullread-only
enable_auto_startboolean
enable_auto_stopboolean
enable_dvrboolean
enable_embedboolean
record_from_startboolean
enable_closed_captionsboolean
closed_captions_typestring

closedCaptionsDisabledclosedCaptionsHttpPostclosedCaptionsEmbedded

latency_preferencestring

normallowultraLow

projectionstring

rectangular360

enable_monitor_streamboolean
broadcast_stream_delay_msinteger
thumbnail_urlstring (uri) | nullread-only
urlstring (uri)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/live-broadcasts/{itemId}
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

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

Try it with MCPAsk your agent to call youtube-live-broadcasts-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/live-broadcasts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-broadcasts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-live-broadcasts-bind (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

stream_idstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/live-broadcasts/{itemId}/bind
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-live-broadcasts-unbind (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/live-broadcasts/{itemId}/unbind
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-live-broadcasts-test (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/live-broadcasts/{itemId}/test
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-live-broadcasts-go-live (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/live-broadcasts/{itemId}/go-live
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

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

Try it with MCPAsk your agent to call youtube-live-broadcasts-end (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/live-broadcasts/{itemId}/end
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-live-broadcasts-insert-cuepoint (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

duration_secsintegerdefault: 30

≥ 1

insertion_offset_time_msinteger
walltime_msinteger

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/live-broadcasts/{itemId}/insert-cuepoint
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

Live streams

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

Try it with MCPAsk your agent to call youtube-live-streams-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–50

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 14 item attributes
idstringread-only
titlestringrequired

≤ 128 characters

descriptionstring

≤ 10000 characters

ingestion_typestring

rtmpdashwebrtchls

resolutionstring

variable240p360p480p720p1080p1440p2160p

frame_ratestring

variable30fps60fps

is_reusablebooleandefault: true
stream_namestring | nullread-only

Stream key — keep secret

ingestion_addressstring (uri) | nullread-only
backup_ingestion_addressstring (uri) | nullread-only
rtmps_ingestion_addressstring (uri) | nullread-only
stream_statusstring | nullread-only
health_statusstring | nullread-only
health_issuesarray of objectread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/live-streams
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-streams" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-live-streams-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

titlestringrequired
descriptionstring
ingestion_typestring

rtmpdashwebrtchls

resolutionstring

variable240p360p480p720p1080p1440p2160p

frame_ratestring

variable30fps60fps

is_reusableboolean

Returns object

idstringread-only
titlestringrequired

≤ 128 characters

descriptionstring

≤ 10000 characters

ingestion_typestring

rtmpdashwebrtchls

resolutionstring

variable240p360p480p720p1080p1440p2160p

frame_ratestring

variable30fps60fps

is_reusablebooleandefault: true
stream_namestring | nullread-only

Stream key — keep secret

ingestion_addressstring (uri) | nullread-only
backup_ingestion_addressstring (uri) | nullread-only
rtmps_ingestion_addressstring (uri) | nullread-only
stream_statusstring | nullread-only
health_statusstring | nullread-only
health_issuesarray of objectread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/live-streams
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

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

Try it with MCPAsk your agent to call youtube-live-streams-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
titlestringrequired

≤ 128 characters

descriptionstring

≤ 10000 characters

ingestion_typestring

rtmpdashwebrtchls

resolutionstring

variable240p360p480p720p1080p1440p2160p

frame_ratestring

variable30fps60fps

is_reusablebooleandefault: true
stream_namestring | nullread-only

Stream key — keep secret

ingestion_addressstring (uri) | nullread-only
backup_ingestion_addressstring (uri) | nullread-only
rtmps_ingestion_addressstring (uri) | nullread-only
stream_statusstring | nullread-only
health_statusstring | nullread-only
health_issuesarray of objectread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/live-streams/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-streams/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call youtube-live-streams-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring
descriptionstring
resolutionstring

variable240p360p480p720p1080p1440p2160p

frame_ratestring

variable30fps60fps

is_reusableboolean

Returns object

idstringread-only
titlestringrequired

≤ 128 characters

descriptionstring

≤ 10000 characters

ingestion_typestring

rtmpdashwebrtchls

resolutionstring

variable240p360p480p720p1080p1440p2160p

frame_ratestring

variable30fps60fps

is_reusablebooleandefault: true
stream_namestring | nullread-only

Stream key — keep secret

ingestion_addressstring (uri) | nullread-only
backup_ingestion_addressstring (uri) | nullread-only
rtmps_ingestion_addressstring (uri) | nullread-only
stream_statusstring | nullread-only
health_statusstring | nullread-only
health_issuesarray of objectread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/live-streams/{itemId}
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

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

Try it with MCPAsk your agent to call youtube-live-streams-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/live-streams/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-streams/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Live chat

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

Try it with MCPAsk your agent to call youtube-live-chat-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

broadcast_idstring
live_chat_idstring
cursorstring
limitintegerdefault: 500

200–2000

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstringread-only
typestringread-only
textstringrequired

≤ 200 characters

published_atstring (date-time)read-only
authorstringread-only
author_channel_idstringread-only
author_avatar_urlstring (uri) | nullread-only
author_is_ownerboolean | nullread-only
author_is_moderatorboolean | nullread-only
author_is_sponsorboolean | nullread-only
super_chatobject | nullread-only
Show 5 child attributes
amount_microsinteger
currencystring
displaystring
commentstring | null
tierinteger | null
pollobject | nullread-only
Show 3 child attributes
questionstring
statusstring
optionsarray of object
Show 2 item attributes
textstring
tallyinteger | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/live-chat
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-chat" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-live-chat-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

broadcast_idstring
live_chat_idstring
textstringrequired

≤ 200 characters

Returns object

idstringread-only
typestringread-only
textstringrequired

≤ 200 characters

published_atstring (date-time)read-only
authorstringread-only
author_channel_idstringread-only
author_avatar_urlstring (uri) | nullread-only
author_is_ownerboolean | nullread-only
author_is_moderatorboolean | nullread-only
author_is_sponsorboolean | nullread-only
super_chatobject | nullread-only
Show 5 child attributes
amount_microsinteger
currencystring
displaystring
commentstring | null
tierinteger | null
pollobject | nullread-only
Show 3 child attributes
questionstring
statusstring
optionsarray of object
Show 2 item attributes
textstring
tallyinteger | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/live-chat
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

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

Try it with MCPAsk your agent to call youtube-live-chat-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/live-chat/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-chat/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-live-chat-create-poll (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

broadcast_idstring
live_chat_idstring
questionstringrequired

≤ 100 characters

optionsarray of stringrequired

2–4 items

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/live-chat/create-poll
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-live-chat-close-poll (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/live-chat/{itemId}/close-poll
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

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

Try it with MCPAsk your agent to call youtube-live-chat-ban-author (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

broadcast_idstring
live_chat_idstring
author_channel_idstringrequired
typestringdefault: "permanent"

permanenttemporary

ban_duration_secondsinteger

≥ 1

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/live-chat/{itemId}/ban-author
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-live-chat-make-moderator (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

broadcast_idstring
live_chat_idstring
author_channel_idstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/live-chat/{itemId}/make-moderator
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

Live chat moderators

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

Try it with MCPAsk your agent to call youtube-live-chat-moderators-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–50

cursorstring
broadcast_idstring
live_chat_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
channel_idstringrequired
display_namestring | nullread-only
channel_urlstring (uri) | nullread-only
profile_image_urlstring (uri) | nullread-only
live_chat_idstringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/live-chat-moderators
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/live-chat-moderators" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-live-chat-moderators-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

broadcast_idstring
live_chat_idstring
channel_idstringrequired

Returns object

idstringread-only
channel_idstringrequired
display_namestring | nullread-only
channel_urlstring (uri) | nullread-only
profile_image_urlstring (uri) | nullread-only
live_chat_idstringread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/live-chat-moderators
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

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

Try it with MCPAsk your agent to call youtube-live-chat-moderators-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/live-chat-moderators/{itemId}
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

Live chat bans

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-live-chat-bans-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

broadcast_idstring
live_chat_idstring
channel_idstringrequired
typestringdefault: "permanent"

permanenttemporary

ban_duration_secondsinteger

≥ 1

Returns object

idstringread-only
channel_idstringrequired
display_namestring | nullread-only
typestringrequired

permanenttemporary

ban_duration_secondsinteger | null

≥ 1

live_chat_idstringread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/live-chat-bans
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

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

Try it with MCPAsk your agent to call youtube-live-chat-bans-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/live-chat-bans/{itemId}
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

Super chats

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

Try it with MCPAsk your agent to call youtube-super-chats-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–50

cursorstring
hlstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
idstringread-only
supporter_namestringread-only
supporter_channel_idstringread-only
supporter_avatar_urlstring (uri) | nullread-only
commentstring | nullread-only
created_atstring (date-time)read-only
amount_microsintegerread-only
currencystringread-only
display_amountstringread-only
message_typeinteger | nullread-only
is_super_stickerbooleanread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/super-chats
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/super-chats" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Revenue

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

Try it with MCPAsk your agent to call youtube-revenue-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (default: 28 days ago)

untilstring (date)

YYYY-MM-DD (default: today)

currencystringdefault: "USD"

Returns object

sincestring (date)read-only
untilstring (date)read-only
sectionsobjectread-only
errorsobjectread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/revenue
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/revenue" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Members

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

Try it with MCPAsk your agent to call youtube-members-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–1000

cursorstring
modestringdefault: "all_current"

all_currentupdates

level_idstring
channel_idsstring

Comma-separated, ≤100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
channel_idstringread-only
display_namestringread-only
channel_urlstring (uri)read-only
profile_image_urlstring (uri) | nullread-only
highest_level_idstring | nullread-only
highest_level_namestring | nullread-only
accessible_levelsarray of stringread-only
member_sincestring (date-time) | nullread-only
total_monthsinteger | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/members
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/members" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Membership levels

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

Try it with MCPAsk your agent to call youtube-membership-levels-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
idstringread-only
display_namestringread-only
creator_channel_idstringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/membership-levels
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/membership-levels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Membership analytics

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

Try it with MCPAsk your agent to call youtube-membership-analytics-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD (default: 28 days ago)

untilstring (date)

YYYY-MM-DD (default: today)

Returns object

sincestring (date)read-only
untilstring (date)read-only
sectionsobjectread-only
errorsobjectread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/membership-analytics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/membership-analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Channel

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

Try it with MCPAsk your agent to call youtube-channel-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

idstringread-only
titlestringread-only

Not editable via the API

handlestring | nullread-only
custom_urlstring | nullread-only
descriptionstring

≤ 1000 characters

keywordsarray of string

Channel tags

countrystring | null

ISO 3166-1 alpha-2

default_languagestring | null
unsubscribed_trailerstring | null

Video id shown to non-subscribers (public/unlisted, owned)

tracking_analytics_account_idstring | null

Google Analytics property id

self_declared_made_for_kidsboolean | null

Channel-level made for kids

made_for_kidsboolean | nullread-only
thumbnail_urlstring (uri) | nullread-only
banner_urlstring (uri) | nullread-only
subscriber_countinteger | nullread-only
hidden_subscriber_countboolean | nullread-only
video_countinteger | nullread-only
view_countinteger | nullread-only
uploads_playlist_idstring | nullread-only
privacy_statusstring | nullread-only
long_uploads_statusstring | nullread-only
published_atstring (date-time)read-only
topic_categoriesarray of string (uri)read-only
urlstring (uri)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/channel
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call youtube-channel-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

descriptionstring

≤ 1000 characters

keywordsarray of string

Channel tags

countrystring
default_languagestring
unsubscribed_trailerstring
tracking_analytics_account_idstring
self_declared_made_for_kidsboolean

Returns object

idstringread-only
titlestringread-only

Not editable via the API

handlestring | nullread-only
custom_urlstring | nullread-only
descriptionstring

≤ 1000 characters

keywordsarray of string

Channel tags

countrystring | null

ISO 3166-1 alpha-2

default_languagestring | null
unsubscribed_trailerstring | null

Video id shown to non-subscribers (public/unlisted, owned)

tracking_analytics_account_idstring | null

Google Analytics property id

self_declared_made_for_kidsboolean | null

Channel-level made for kids

made_for_kidsboolean | nullread-only
thumbnail_urlstring (uri) | nullread-only
banner_urlstring (uri) | nullread-only
subscriber_countinteger | nullread-only
hidden_subscriber_countboolean | nullread-only
video_countinteger | nullread-only
view_countinteger | nullread-only
uploads_playlist_idstring | nullread-only
privacy_statusstring | nullread-only
long_uploads_statusstring | nullread-only
published_atstring (date-time)read-only
topic_categoriesarray of string (uri)read-only
urlstring (uri)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/channel
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

Channel localizations

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

Try it with MCPAsk your agent to call youtube-channel-localizations-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
languagestringrequired
titlestringrequired
descriptionstring

≤ 1000 characters

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/channel-localizations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-localizations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-channel-localizations-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

languagestringrequired
titlestringrequired
descriptionstring

Returns object

languagestringrequired
titlestringrequired
descriptionstring

≤ 1000 characters

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/channel-localizations
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

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

Try it with MCPAsk your agent to call youtube-channel-localizations-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring
descriptionstring

Returns object

languagestringrequired
titlestringrequired
descriptionstring

≤ 1000 characters

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/channel-localizations/{itemId}
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

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

Try it with MCPAsk your agent to call youtube-channel-localizations-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/channel-localizations/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-localizations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Channel banner

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

Try it with MCPAsk your agent to call youtube-channel-banner-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

banner_urlstring (uri) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/channel-banner
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-banner" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call youtube-channel-banner-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

mediastringrequired
applybooleandefault: true

Returns object

banner_urlstring (uri) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/channel-banner
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

Watermark

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

Try it with MCPAsk your agent to call youtube-watermark-get (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

mediastring

JPEG/PNG ≤10 MB, square (~150×150)

timing_typestringdefault: "offsetFromStart"

offsetFromStartoffsetFromEnd

offset_msintegerdefault: 0
duration_msinteger | null
corner_positionstringdefault: "bottomRight"

topLefttopRightbottomLeftbottomRight

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/watermark
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/watermark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-watermark-set (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

mediastringrequired
timing_typestring

offsetFromStartoffsetFromEnd

offset_msinteger
duration_msinteger
corner_positionstring

topLefttopRightbottomLeftbottomRight

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/watermark/set
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

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

Try it with MCPAsk your agent to call youtube-watermark-unset (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/watermark/unset
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

Channel sections

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

Try it with MCPAsk your agent to call youtube-channel-sections-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
typestringrequired

allPlaylistscompletedEventsliveEventsmultipleChannelsmultiplePlaylistspopularUploadsrecentUploadssinglePlaylistsubscriptionsupcomingEvents

titlestring | null

Required for multiplePlaylists / multipleChannels

positioninteger
playlistsarray of string

singlePlaylist (1) / multiplePlaylists

channelsarray of string

multipleChannels

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/channel-sections
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-sections" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-channel-sections-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

typestringrequired

allPlaylistscompletedEventsliveEventsmultipleChannelsmultiplePlaylistspopularUploadsrecentUploadssinglePlaylistsubscriptionsupcomingEvents

titlestring | null

Required for multiplePlaylists / multipleChannels

positioninteger
playlistsarray of string

singlePlaylist (1) / multiplePlaylists

channelsarray of string

multipleChannels

Returns object

idstringread-only
typestringrequired

allPlaylistscompletedEventsliveEventsmultipleChannelsmultiplePlaylistspopularUploadsrecentUploadssinglePlaylistsubscriptionsupcomingEvents

titlestring | null

Required for multiplePlaylists / multipleChannels

positioninteger
playlistsarray of string

singlePlaylist (1) / multiplePlaylists

channelsarray of string

multipleChannels

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/channel-sections
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

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

Try it with MCPAsk your agent to call youtube-channel-sections-update (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

typestring

allPlaylistscompletedEventsliveEventsmultipleChannelsmultiplePlaylistspopularUploadsrecentUploadssinglePlaylistsubscriptionsupcomingEvents

titlestring | null

Required for multiplePlaylists / multipleChannels

positioninteger
playlistsarray of string

singlePlaylist (1) / multiplePlaylists

channelsarray of string

multipleChannels

Returns object

idstringread-only
typestringrequired

allPlaylistscompletedEventsliveEventsmultipleChannelsmultiplePlaylistspopularUploadsrecentUploadssinglePlaylistsubscriptionsupcomingEvents

titlestring | null

Required for multiplePlaylists / multipleChannels

positioninteger
playlistsarray of string

singlePlaylist (1) / multiplePlaylists

channelsarray of string

multipleChannels

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube/channel-sections/{itemId}
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

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

Try it with MCPAsk your agent to call youtube-channel-sections-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/channel-sections/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/channel-sections/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Subscriptions

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

Try it with MCPAsk your agent to call youtube-subscriptions-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–50

cursorstring
orderstring

alphabeticalrelevanceunread

for_channel_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
idstringread-only
channel_idstringrequired
titlestringread-only
descriptionstring | nullread-only
thumbnail_urlstring (uri) | nullread-only
subscribed_atstring (date-time)read-only
subscriber_channel_idstring | nullread-only
subscriber_titlestring | nullread-only
subscriber_thumbnail_urlstring (uri) | nullread-only
total_item_countinteger | nullread-only
new_item_countinteger | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/subscriptions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/subscriptions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call youtube-subscriptions-create (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

channel_idstringrequired

Returns object

idstringread-only
channel_idstringrequired
titlestringread-only
descriptionstring | nullread-only
thumbnail_urlstring (uri) | nullread-only
subscribed_atstring (date-time)read-only
subscriber_channel_idstring | nullread-only
subscriber_titlestring | nullread-only
subscriber_thumbnail_urlstring (uri) | nullread-only
total_item_countinteger | nullread-only
new_item_countinteger | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/subscriptions
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

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

Try it with MCPAsk your agent to call youtube-subscriptions-delete (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/youtube/subscriptions/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/subscriptions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Subscribers

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

Try it with MCPAsk your agent to call youtube-subscribers-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–50

cursorstring
recentbooleandefault: false

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
idstringread-only
channel_idstringrequired
titlestringread-only
descriptionstring | nullread-only
thumbnail_urlstring (uri) | nullread-only
subscribed_atstring (date-time)read-only
subscriber_channel_idstring | nullread-only
subscriber_titlestring | nullread-only
subscriber_thumbnail_urlstring (uri) | nullread-only
total_item_countinteger | nullread-only
new_item_countinteger | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/subscribers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/subscribers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Video categories

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

Try it with MCPAsk your agent to call youtube-video-categories-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

region_codestringdefault: "US"
hlstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
idstringread-only
titlestringread-only
assignablebooleanread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/video-categories
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/video-categories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Languages

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

Try it with MCPAsk your agent to call youtube-languages-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

hlstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
idstringread-only
codestringread-only
namestringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/languages
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/languages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Regions

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

Try it with MCPAsk your agent to call youtube-regions-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

hlstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
idstringread-only
codestringread-only
namestringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/regions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/regions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Abuse reports

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

Try it with MCPAsk your agent to call youtube-abuse-reports-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

hlstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
idstringread-only
labelstringread-only
secondary_reasonsarray of objectread-only
Show 2 item attributes
idstring
labelstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/abuse-reports
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/abuse-reports" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call youtube-abuse-reports-report (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

video_idstringrequired
reason_idstringrequired
secondary_reason_idstring
commentsstring
languagestring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube/abuse-reports/report
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

Managed channels

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

Try it with MCPAsk your agent to call youtube-managed-channels-list (toolset focus_youtube)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–50

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 24 item attributes
idstringread-only
titlestringread-only

Not editable via the API

handlestring | nullread-only
custom_urlstring | nullread-only
descriptionstring

≤ 1000 characters

keywordsarray of string

Channel tags

countrystring | null

ISO 3166-1 alpha-2

default_languagestring | null
unsubscribed_trailerstring | null

Video id shown to non-subscribers (public/unlisted, owned)

tracking_analytics_account_idstring | null

Google Analytics property id

self_declared_made_for_kidsboolean | null

Channel-level made for kids

made_for_kidsboolean | nullread-only
thumbnail_urlstring (uri) | nullread-only
banner_urlstring (uri) | nullread-only
subscriber_countinteger | nullread-only
hidden_subscriber_countboolean | nullread-only
video_countinteger | nullread-only
view_countinteger | nullread-only
uploads_playlist_idstring | nullread-only
privacy_statusstring | nullread-only
long_uploads_statusstring | nullread-only
published_atstring (date-time)read-only
topic_categoriesarray of string (uri)read-only
urlstring (uri)read-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube/managed-channels
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube/managed-channels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200