get_tiktok_videos
Retrieve a list of TikTok videos from your Metricool account by specifying a date range and blog ID to analyze video data effectively.
Instructions
Get the list of Tiktok Videos from your Metricool account.
Args: init date: Init date of the period to get the data. The format is YYYY-MM-DD end date: End date of the period to get the data. The format is YYYY-MM-DD blog id: Blog id of the Metricool brand account.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| blog_id | Yes | ||
| end_date | Yes | ||
| init_date | Yes |
Implementation Reference
- src/mcp_metricool/tools/tools.py:126-144 (handler)The handler function for the 'get_tiktok_videos' tool. It fetches TikTok video data from the Metricool API within a specified date range for a given blog_id. Includes the @mcp.tool() decorator for registration and docstring for schema.
@mcp.tool() async def get_tiktok_videos(init_date: str, end_date: str, blog_id: int) -> str | dict[str, Any]: """ Get the list of Tiktok Videos from your Metricool account. Args: init date: Init date of the period to get the data. The format is YYYY-MM-DD end date: End date of the period to get the data. The format is YYYY-MM-DD blog id: Blog id of the Metricool brand account. """ url = f"{METRICOOL_BASE_URL}/v2/analytics/posts/tiktok?from={init_date}T00%3A00%3A00&to={end_date}T23%3A59%3A59&blogId={blog_id}&userId={METRICOOL_USER_ID}&integrationSource=MCP" response = await make_get_request(url) if not response: return ("Failed to get Tiktok Videos") return response