Competitor intel

3 read5 write

Tracked competitor accounts, trend detection and swipe files.

Detailed reference

get_competitor_trendsreadcompetitor_intel.view

Posts that hit your custom trend rules - viral outliers, anomalies.

Parameters

days

integer

Window in days. Defaults to 7.

Returns

Per post: tracker_id, post_url, metric_score, rule_matched, posted_at.

Example question

"Which competitor posts went viral this week?"

list_competitor_trackersreadcompetitor_intel.view

Competitor IG/TikTok accounts you are actively tracking.

Parameters

limit

integer

Defaults to 25.

Returns

Per tracker: id, platform, account_handle, frequency, last_synced_at, posts_tracked.

Example question

"Who am I tracking for competitive research?"

list_swipe_filesreadcompetitor_intel.view

Your swipe files plus any shared with you by your team (RBAC ACL respected).

Parameters

limit

integer

Defaults to 25.

Returns

Per file: id, name, owner_id, item_count, visibility, updated_at.

Example question

"Show me my hooks swipe file."

add_to_swipe_filewritecompetitor_intel.save

Add a competitor post to one of your existing swipe files.

Parameters

swipe_file_id *	string	Target swipe file UUID.
post_id *	string	Competitor post UUID.

Returns

New swipe file item with id and saved_at.

Example question

"Save this post to my CTA swipe file."

create_competitor_trackerwrite
Start tracking a set of Instagram competitors (<=50).
delete_competitor_trackerwrite
Stop a competitor tracker.
track_competitor_brandwrite
Start tracking a Foreplay brand for daily ad-library polling.
untrack_competitor_brandwrite
Stop tracking a Foreplay brand.