EmbedSocial

Get a single social-feed media item by its media_id for the authenticated EmbedSocial user. Returns the same response as GET /v2/api/social-feed/media/{mediaId}. Required: media_id (the id of the media, as returned by social_feed_hashtag_album_get_media in the data[].media_id field). The EmbedSocial MCP proxy injects api_key automatically — do not send it from the client. Tool expects valid stringified JSON object with 2 properties. Property names with description, type and required status: media_id: (description: The id of the social-feed media item, e.g. 11222333445567 (returned as data[].media_id from social_feed_hashtag_album_get_media)., type: string, required: true), api_key: (description: EmbedSocial user API key (injected by the Symfony MCP proxy as api_key in tools/call arguments), type: string, required: true) ALL parameters marked as required must be provided

Fetch hashtag-album media (also known as widget media or album media) for the authenticated EmbedSocial user. Returns the same response as GET /v2/api/social-feed/hashtag-album/media. Required: album_ref (hashtag album / widget ref, e.g. 1979b2dae50abb12b6956659bbbe69c46a05a925). Optional: page (default 1), per_page (default 100, max 200), begin_time (ISO 8601), end_time (ISO 8601), filter_keyword (URL-encode special chars like ',', '+', '-', '#'). The EmbedSocial MCP proxy injects api_key automatically — do not send it from the client. Tool expects valid stringified JSON object with 7 properties. Property names with description, type and required status: album_ref: (description: , type: string, required: true), page: (description: , type: string, required: false), per_page: (description: , type: string, required: false), begin_time: (description: , type: string, required: false), end_time: (description: , type: string, required: false), filter_keyword: (description: , type: string, required: false), api_key: (description: EmbedSocial user API key (injected by the Symfony MCP proxy as api_key in tools/call arguments), type: string, required: true) ALL parameters marked as required must be provided

Query social-feed post items (UGC posts) for the authenticated EmbedSocial user, with filters and cursor pagination. Returns the same response as POST /v2/api/social-feed/items/query: { data: [...], nextPageToken, previousPageToken, totalCount }. Each item includes rating (integer 1-5 star rating; null for items without one, such as regular posts). Results are always posts (itemType is fixed server-side). All parameters are optional. IMPORTANT: if periodStart/periodEnd are omitted the API only returns the last 7 days — pass an early periodStart (e.g. 2015-01-01) to search all time. - searchString: keyword search in the post content - page (default 1), pageSize (default 10, max 100) - searchAfter / searchBefore: cursor tokens from a previous response (nextPageToken / previousPageToken) - periodStart / periodEnd: Y-m-d - sourceType: JSON array as a string, e.g. ["instagram","tiktok"] - sourceSubtype: JSON array as a string, e.g. ["hashtag"] - sourceOriginalId: JSON array of source original ids, as a string - orderBy: JSON object as a string with exactly ONE field of originalCreatedOn|likes|comments|shares|globalModerationStatus mapped to asc|desc, e.g. {"originalCreatedOn":"desc"} - minAiScore: integer 0-100 - rightsApproveStatus: Pending|Approved|Declined|Unrequested The EmbedSocial MCP proxy injects api_key automatically — do not send it from the client. Tool expects valid stringified JSON object with 14 properties. Property names with description, type and required status: api_key: (description: EmbedSocial user API key (injected by the Symfony MCP proxy as api_key in tools/call arguments), type: string, required: true), searchString: (description: , type: string, required: false), page: (description: , type: string, required: false), pageSize: (description: , type: string, required: false), searchAfter: (description: , type: string, required: false), searchBefore: (description: , type: string, required: false), periodStart: (description: , type: string, required: false), periodEnd: (description: , type: string, required: false), sourceType: (description: , type: string, required: false), sourceSubtype: (description: , type: string, required: false), sourceOriginalId: (description: , type: string, required: false), orderBy: (description: , type: string, required: false), minAiScore: (description: , type: string, required: false), rightsApproveStatus: (description: , type: string, required: false) ALL parameters marked as required must be provided

List the Social Feed widgets owned by the authenticated EmbedSocial user. Returns the same response as GET /v2/api/social-feed/widgets: widget names with their widgetRef (or albumRef for legacy widgets), widget type, and connected-source metadata where available, sorted by date. Optional: widgetType — manually_configured or ai_generated. If omitted, all widgets are returned, including legacy widgets. Legacy widgets are left out when widgetType is ai_generated. Use this tool to find a widget before calling social_feed_hashtag_album_get_media (pass the ref as album_ref) or widget_analytics_get_metrics (pass it as widgetRef). This operation is read-only. Authentication is handled by the connected account; callers must not supply an API key. Tool expects valid stringified JSON object with 2 properties. Property names with description, type and required status: widgetType: (description: , type: string, required: false), api_key: (description: EmbedSocial user API key (injected by the Symfony MCP proxy as api_key in tools/call arguments), type: string, required: true) ALL parameters marked as required must be provided

Fetch widget analytics (post/icon/lightbox/CTA click occurrences, periodic and total) for a widget owned by the authenticated EmbedSocial user. Returns the same response as GET /v2/api/widget-analytics. Optional: widgetRef (the widget data-ref; if omitted the API may aggregate across the account), period (e.g. last_7_days, last_30_days, last_90_days, custom), from (ISO date, required when period=custom), to (ISO date, required when period=custom). The EmbedSocial MCP proxy injects api_key automatically — do not send it from the client. Tool expects valid stringified JSON object with 5 properties. Property names with description, type and required status: widgetRef: (description: , type: string, required: false), period: (description: , type: string, required: false), from: (description: , type: string, required: false), to: (description: , type: string, required: false), api_key: (description: EmbedSocial user API key (injected by the Symfony MCP proxy as api_key in tools/call arguments), type: string, required: true) ALL parameters marked as required must be provided