creative-insights_skill

Overview

This skill calls the Motion Creative Insights API to fetch performance and creative analytics for image and video assets. It builds a minimal, secure curl request based on user-specified parameters, executes the request, and returns results in a readable table. Sensible defaults are applied when parameters are not provided.

How this skill works

The skill parses the user request to determine which query parameters to include (format, grouping, sortKey, sortDirection, dateRange, startDate, endDate, limit, creativeAssetIds). It constructs a query string with only the requested parameters, injects the MOTION_API_TOKEN for Bearer authentication, runs curl against the Creative Insights endpoint, and formats the JSON response into a simple table for quick inspection. Defaults (sortDirection=desc, dateRange=last_30d, limit=10) are used if the user is not specific.

When to use it

• Compare creative performance across image and video formats over a recent date range.
• Identify top-performing assets by thumbstop, retention, or spend.
• Group results by campaign, creative variant, or other supported grouping keys.
• Fetch specific creative metrics for a list of creativeAssetIds.
• Quickly generate a table of insights for reporting or optimization decisions.

Best practices

• Always set MOTION_API_TOKEN in the environment before running requests.
• Request only the parameters you need to avoid excessive response size.
• Use dateRange presets for common lookbacks (last_7d, last_30d, last_90d) or start/end for custom windows.
• Limit results when exploring (limit=10 or 25) before increasing for bulk exports.
• Sort by meaningful metric (thumbstop, retention, spend) and use desc for top results.

Example use cases

• Get top 10 video creatives by thumbstop in the last 30 days to guide creative refreshes.
• Compare retention between image and video formats over the last 7 days for channel optimization.
• Pull metrics for specific creativeAssetIds to validate A/B test performance.
• Group creatives by campaign to identify which campaigns drive the best creative engagement.