analytics

Fetch post performance analytics

POST

https://mcp.socialneuron.com/v1

/tools/fetch_analytics

Fetch post performance analytics › Request Body

platform

string · enum

Filter analytics to a specific platform.

Enum values:

youtube

tiktok

instagram

twitter

facebook

threads

bluesky

days

number · min: 1 · max: 365

Lookback window in days (1-365). Default 30. Use 7 for weekly review, 30 for monthly summary, 90 for quarterly trends.

content_id

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

Filter to a specific content_history ID to see performance of one piece of content.

project_id

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

Project ID. Defaults to the active project context.

limit

number · min: 1 · max: 100

Maximum number of posts to return. Defaults to 20.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Fetch post performance analytics › 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_analytics

curl https://mcp.socialneuron.com/v1/tools/fetch_analytics \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "platform": "youtube",
  "days": 1,
  "content_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "limit": 1,
  "response_format": "text"
}'

Example Request Body

{
  "platform": "youtube",
  "days": 1,
  "content_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "limit": 1,
  "response_format": "text"
}

json

Example Responses

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

json

application/json

Refresh analytics data from connected platforms

POST

https://mcp.socialneuron.com/v1

/tools/refresh_platform_analytics

Refresh analytics data from connected platforms › Request Body

project_id

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

Project ID. Defaults to the active project context.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Refresh analytics data from connected platforms › 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

apps

Social Neuron REST API

analytics

Fetch post performance analytics

POST

https://mcp.socialneuron.com/v1

/tools/fetch_analytics

Fetch post performance analytics › Request Body

platform

string · enum

Filter analytics to a specific platform.

Enum values:

youtube

tiktok

instagram

twitter

facebook

threads

bluesky

days

number · min: 1 · max: 365

Lookback window in days (1-365). Default 30. Use 7 for weekly review, 30 for monthly summary, 90 for quarterly trends.

content_id

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

Filter to a specific content_history ID to see performance of one piece of content.

project_id

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

Project ID. Defaults to the active project context.

limit

number · min: 1 · max: 100

Maximum number of posts to return. Defaults to 20.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Fetch post performance analytics › 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_analytics

curl https://mcp.socialneuron.com/v1/tools/fetch_analytics \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "platform": "youtube",
  "days": 1,
  "content_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "limit": 1,
  "response_format": "text"
}'

Example Request Body

{
  "platform": "youtube",
  "days": 1,
  "content_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "limit": 1,
  "response_format": "text"
}

json

Example Responses

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

json

application/json

Refresh analytics data from connected platforms

POST

https://mcp.socialneuron.com/v1

/tools/refresh_platform_analytics

Refresh analytics data from connected platforms › Request Body

project_id

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

Project ID. Defaults to the active project context.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Refresh analytics data from connected platforms › 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

apps