{"openapi":"3.1.0","info":{"title":"Content Studio Analytics (BYOK) API","version":"0.1.0","description":"Content Studio Analytics (BYOK) lets an AI assistant read your own Content Studio Analytics data through the Content Studio Analytics API with a key you supply (ContentStudio API key). Read-only: 8 tools (get_facebook_summary, get_instagram_summary, get_youtube_summary, get_facebook_audience_growth, get_facebook_top_posts, get_instagram_top_posts, get_youtube_views_trend, get_youtube_top_posts)....\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-contentstudio-analytics.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-contentstudio-analytics/docs"},"termsOfService":"https://connectorbay.com/byok-contentstudio-analytics/terms"},"servers":[{"url":"https://byok-contentstudio-analytics.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-contentstudio-analytics/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_facebook_summary":{"post":{"operationId":"get_facebook_summary","summary":"Get a Facebook page summary for a period: fans, follows, impressions, engagements, posts and reactions, with previous pe","description":"Get a Facebook page summary for a period: fans, follows, impressions, engagements, posts and reactions, with previous period, difference and percentage change. Use for \"How did my Facebook page perform in September according to ContentStudio\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace_id":{"description":"Workspace ID (from list_workspaces of the contentstudio-workspace connector).","maxLength":64,"title":"Workspace Id","type":"string"},"platform_id":{"description":"ID of the connected social account to report on (from list_social_accounts of the contentstudio-workspace connector).","maxLength":64,"title":"Platform Id","type":"string"},"start_date":{"description":"First day of the period, YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"}},"required":["workspace_id","platform_id","start_date","end_date"],"title":"get_facebook_summaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_instagram_summary":{"post":{"operationId":"get_instagram_summary","summary":"Get an Instagram account summary for a period: followers, profile views and reach, posts, reactions, saves and engagemen","description":"Get an Instagram account summary for a period: followers, profile views and reach, posts, reactions, saves and engagement rate, with previous period, difference and percentage change. Use for \"How did my Instagram account perform last month according to ContentStudio\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace_id":{"description":"Workspace ID (from list_workspaces of the contentstudio-workspace connector).","maxLength":64,"title":"Workspace Id","type":"string"},"platform_id":{"description":"ID of the connected social account to report on (from list_social_accounts of the contentstudio-workspace connector).","maxLength":64,"title":"Platform Id","type":"string"},"start_date":{"description":"First day of the period, YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"}},"required":["workspace_id","platform_id","start_date","end_date"],"title":"get_instagram_summaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_youtube_summary":{"post":{"operationId":"get_youtube_summary","summary":"Get a YouTube channel summary for a period: subscribers, videos, views, watch time, likes, comments, shares and engageme","description":"Get a YouTube channel summary for a period: subscribers, videos, views, watch time, likes, comments, shares and engagement, with previous period, difference and percentage change. Use for \"How did my YouTube channel perform last month according to ContentStudio\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace_id":{"description":"Workspace ID (from list_workspaces of the contentstudio-workspace connector).","maxLength":64,"title":"Workspace Id","type":"string"},"platform_id":{"description":"ID of the connected social account to report on (from list_social_accounts of the contentstudio-workspace connector).","maxLength":64,"title":"Platform Id","type":"string"},"start_date":{"description":"First day of the period, YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"}},"required":["workspace_id","platform_id","start_date","end_date"],"title":"get_youtube_summaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_facebook_audience_growth":{"post":{"operationId":"get_facebook_audience_growth","summary":"Get the follower growth of a Facebook page over a period. The provider documents no response fields, so the full answer ","description":"Get the follower growth of a Facebook page over a period. The provider documents no response fields, so the full answer is returned. Use for \"How did my Facebook audience grow in ContentStudio\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace_id":{"description":"Workspace ID (from list_workspaces of the contentstudio-workspace connector).","maxLength":64,"title":"Workspace Id","type":"string"},"platform_id":{"description":"ID of the connected social account to report on (from list_social_accounts of the contentstudio-workspace connector).","maxLength":64,"title":"Platform Id","type":"string"},"start_date":{"description":"First day of the period, YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"}},"required":["workspace_id","platform_id","start_date","end_date"],"title":"get_facebook_audience_growthArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_facebook_top_posts":{"post":{"operationId":"get_facebook_top_posts","summary":"Get a Facebook page's top posts in a period ranked by a metric. The provider documents no response fields, so the full a","description":"Get a Facebook page's top posts in a period ranked by a metric. The provider documents no response fields, so the full answer is returned. Use for \"What were my best Facebook posts last month in ContentStudio\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace_id":{"description":"Workspace ID (from list_workspaces of the contentstudio-workspace connector).","maxLength":64,"title":"Workspace Id","type":"string"},"platform_id":{"description":"ID of the connected social account to report on (from list_social_accounts of the contentstudio-workspace connector).","maxLength":64,"title":"Platform Id","type":"string"},"start_date":{"description":"First day of the period, YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many posts to return.","title":"Limit"},"order_by":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Metric to rank posts by, for example engagement or impressions.","title":"Order By"}},"required":["workspace_id","platform_id","start_date","end_date"],"title":"get_facebook_top_postsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_instagram_top_posts":{"post":{"operationId":"get_instagram_top_posts","summary":"Get an Instagram account's top posts in a period ranked by a metric. The provider documents no response fields, so the f","description":"Get an Instagram account's top posts in a period ranked by a metric. The provider documents no response fields, so the full answer is returned. Use for \"What were my best Instagram posts last month in ContentStudio\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace_id":{"description":"Workspace ID (from list_workspaces of the contentstudio-workspace connector).","maxLength":64,"title":"Workspace Id","type":"string"},"platform_id":{"description":"ID of the connected social account to report on (from list_social_accounts of the contentstudio-workspace connector).","maxLength":64,"title":"Platform Id","type":"string"},"start_date":{"description":"First day of the period, YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many posts to return.","title":"Limit"},"order_by":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Metric to rank posts by, for example engagement or impressions.","title":"Order By"}},"required":["workspace_id","platform_id","start_date","end_date"],"title":"get_instagram_top_postsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_youtube_views_trend":{"post":{"operationId":"get_youtube_views_trend","summary":"Get views of a YouTube channel over a period as a trend. The provider documents no response fields, so the full answer i","description":"Get views of a YouTube channel over a period as a trend. The provider documents no response fields, so the full answer is returned. Use for \"How did views on my YouTube channel trend in ContentStudio\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace_id":{"description":"Workspace ID (from list_workspaces of the contentstudio-workspace connector).","maxLength":64,"title":"Workspace Id","type":"string"},"platform_id":{"description":"ID of the connected social account to report on (from list_social_accounts of the contentstudio-workspace connector).","maxLength":64,"title":"Platform Id","type":"string"},"start_date":{"description":"First day of the period, YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"}},"required":["workspace_id","platform_id","start_date","end_date"],"title":"get_youtube_views_trendArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_youtube_top_posts":{"post":{"operationId":"get_youtube_top_posts","summary":"Get a YouTube channel's top videos in a period. The provider documents no response fields, so the full answer is returne","description":"Get a YouTube channel's top videos in a period. The provider documents no response fields, so the full answer is returned. Use for \"Which of my YouTube videos did best last month in ContentStudio\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace_id":{"description":"Workspace ID (from list_workspaces of the contentstudio-workspace connector).","maxLength":64,"title":"Workspace Id","type":"string"},"platform_id":{"description":"ID of the connected social account to report on (from list_social_accounts of the contentstudio-workspace connector).","maxLength":64,"title":"Platform Id","type":"string"},"start_date":{"description":"First day of the period, YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"}},"required":["workspace_id","platform_id","start_date","end_date"],"title":"get_youtube_top_postsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}