Skip to navigation
Spyglass APISocial media account

Get an account's creative insights

Return clustered creative themes for an account. MEDIA_MIX returns a breakdown by media type; the other types return weekly buckets plus ranked totals, highest first.

maxDaysBack filters both the weekly bucket series and ranked totals to creatives that started within the requested window.

Limited to 120 requests per minute per user. Costs $0.0005 per cluster returned, charged against your plan’s monthly credits. The count field is what you were charged for.

Authentication

AuthorizationBearer

An API key from Settings → API, prefixed sg_live_.

Path parameters

idstringRequired

Brand or creator id returned by POST /brands or POST /creators.

Query parameters

typeenumRequired
Allowed values:
maxDaysBackintegerOptional1-90
limitintegerOptional1-500Defaults to 100

Response

Creative insights for the account.
object
OR
object

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
404
Not Found Error
405
Method Not Allowed Error
429
Too Many Requests Error
500
Internal Server Error