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

• 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=desc

• dateRange=last_30d

• limit=10