youtube-analytics

Fetch YouTube channel analytics data

POST

https://mcp.socialneuron.com/v1

/tools/fetch_youtube_analytics

Fetch YouTube channel analytics data › Request Body

action

string · enum · required

Type of analytics to fetch: "channel" for overview, "daily" for day-by-day, "video" for a specific video, "topVideos" for best performers.

Enum values:

channel

daily

video

topVideos

start_date

string · pattern: ^\d{4}-\d{2}-\d{2}$ · required

Start date in YYYY-MM-DD format.

end_date

string · pattern: ^\d{4}-\d{2}-\d{2}$ · required

End date in YYYY-MM-DD format.

video_id

string

YouTube video ID. Required when action is "video".

max_results

number · min: 1 · max: 50

Max videos to return for "topVideos" action. Defaults to 10.

connected_account_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Exact YouTube connected-account ID from list_connections. Optional when exactly one active YouTube account is bound to the resolved project — auto-resolved. Required (with a clear list of candidates) when the project has multiple YouTube accounts.

project_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Exact brand/project ID. Defaults only when the authenticated user has one project.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Fetch YouTube channel analytics data › Responses

Tool executed. isError:true in the body indicates a tool-level error.

MCP CallToolResult. `content` carries text/structured blocks; `structuredContent` is present when the tool declares structured output.

ToolResult

object[]

object

isError

boolean

POST/tools/fetch_youtube_analytics

curl https://mcp.socialneuron.com/v1/tools/fetch_youtube_analytics \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "action": "channel",
  "start_date": "start_date",
  "end_date": "end_date",
  "video_id": "video_id",
  "max_results": 1,
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}'

Example Request Body

{
  "action": "channel",
  "start_date": "start_date",
  "end_date": "end_date",
  "video_id": "video_id",
  "max_results": 1,
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}

json

Example Responses

{
  "content": [
    {
      "type": "type",
      "text": "text"
    }
  ],
  "structuredContent": {},
  "isError": true
}

json

application/json

usage

Social Neuron REST API

youtube-analytics

Fetch YouTube channel analytics data

POST

https://mcp.socialneuron.com/v1

/tools/fetch_youtube_analytics

Fetch YouTube channel analytics data › Request Body

action

string · enum · required

Type of analytics to fetch: "channel" for overview, "daily" for day-by-day, "video" for a specific video, "topVideos" for best performers.

Enum values:

channel

daily

video

topVideos

start_date

string · pattern: ^\d{4}-\d{2}-\d{2}$ · required

Start date in YYYY-MM-DD format.

end_date

string · pattern: ^\d{4}-\d{2}-\d{2}$ · required

End date in YYYY-MM-DD format.

video_id

string

YouTube video ID. Required when action is "video".

max_results

number · min: 1 · max: 50

Max videos to return for "topVideos" action. Defaults to 10.

connected_account_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

project_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Exact brand/project ID. Defaults only when the authenticated user has one project.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Fetch YouTube channel analytics data › Responses

Tool executed. isError:true in the body indicates a tool-level error.

MCP CallToolResult. `content` carries text/structured blocks; `structuredContent` is present when the tool declares structured output.

ToolResult

object[]

object

isError

boolean

POST/tools/fetch_youtube_analytics

curl https://mcp.socialneuron.com/v1/tools/fetch_youtube_analytics \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "action": "channel",
  "start_date": "start_date",
  "end_date": "end_date",
  "video_id": "video_id",
  "max_results": 1,
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}'

Example Request Body

{
  "action": "channel",
  "start_date": "start_date",
  "end_date": "end_date",
  "video_id": "video_id",
  "max_results": 1,
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}

json

Example Responses

{
  "content": [
    {
      "type": "type",
      "text": "text"
    }
  ],
  "structuredContent": {},
  "isError": true
}

json

application/json

usage