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-insightsAvailable 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
- Parse the user's request to determine which parameters to include
- Only include parameters that are explicitly requested or contextually relevant
- Build the query string with only the needed parameters
- Execute the curl command
- 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=descdateRange=last_30dlimit=10