creative-insights-api

📁 motion-creative/agent-skills 📅 Jan 23, 2026
10
总安装量
9
周安装量
#29215
全站排名
安装命令
npx skills add https://github.com/motion-creative/agent-skills --skill creative-insights-api

Agent 安装分布

claude-code 8
opencode 6
github-copilot 5
gemini-cli 4
antigravity 4

Skill 文档

Creative Insights API

When asked for Motion analytics or creative insights, construct a curl request to the Creative Insights API.

Environment Variables

The following environment variables must be set:

Variable Description
MOTION_API_TOKEN Bearer token for API authentication

Base URL

https://builder-be.staging.motionapp.com/api/creative-insights

Available Query Parameters

Parameter Type Description
format 'image' | 'video' Filter by creative format
grouping string How to group the results
sortKey string Field to sort by (e.g., thumbstop, retention, spend)
sortDirection 'asc' | 'desc' Sort order
dateRange string Preset date range (e.g., last_7d, last_30d, last_90d)
startDate string Custom start date (ISO format)
endDate string Custom end date (ISO format)
limit number Maximum number of results to return
creativeAssetIds string | Filter by specific creative asset IDs (can pass multiple)

Instructions

  1. Parse the user’s request to determine which parameters to include
  2. Only include parameters that are explicitly requested or contextually relevant
  3. Build the query string with only the needed parameters
  4. Execute the curl command
  5. Display the results in a formatted table

Example Request

curl -H "Authorization: Bearer $MOTION_API_TOKEN" "https://builder-be.staging.motionapp.com/api/creative-insights?format=video&sortKey=thumbstop&sortDirection=desc&dateRange=last_30d&limit=10"

Default Behavior

If the user doesn’t specify parameters, use these sensible defaults:

  • sortDirection=desc
  • dateRange=last_30d
  • limit=10