`tiktok_ads_get_activities`

Get TikTok Ads Change History

Tiktok

Description

What changed in a TikTok advertiser, and when: status toggles, budgets, bids, schedules, targeting, creatives and review outcomes of campaigns, ad groups and ads (Smart+ included), with before/after values and who made each change.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiktok_ads_get_activities",
    "arguments": {}
  }
}

hopkin tiktok activities get

Flag	Type	Required	Description
`--advertiser-id`	`string`	Required	TikTok advertiser ID.
`--start-date`	`string`	Optional	Start of the window, YYYY-MM-DD (UTC). Defaults to 7 days before end_date.
`--end-date`	`string`	Optional	End of the window, YYYY-MM-DD (UTC), inclusive. Defaults to today.
`--entity-type`	`string`	Optional	Only changes to this kind of entity.
`--entity-ids`	`array`	Optional	Only changes to these campaign / ad group / ad IDs.
`--limit`	`integer`	Optional	Changes per page (1-200, default 50).
`--cursor`	`string`	Optional	nextCursor from the previous response. Pass it with otherwise identical parameters for the next page.
`--refresh`	`boolean`	Optional	Fetch TikTok's change log now before answering. Normally not needed: it is fetched when the last sync is over 15 minutes old.
`--connection-id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

{
  "mcpServers": {
    "tiktok-ads": {
      "url": "https://tiktok.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`advertiser_id`	`string`	Required	TikTok advertiser ID.pattern: ^\d{1,25}$
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (8)

Name	Type	Required	Description
`start_date`	`string`	Optional	Start of the window, YYYY-MM-DD (UTC). Defaults to 7 days before end_date.pattern: ^\d{4}-\d{2}-\d{2}$
`end_date`	`string`	Optional	End of the window, YYYY-MM-DD (UTC), inclusive. Defaults to today.pattern: ^\d{4}-\d{2}-\d{2}$
`entity_type`	`string`	Optional	Only changes to this kind of entity. `ADVERTISER` `CAMPAIGN` `ADGROUP` `AD` `INSTANT_FORM`
`entity_ids`	`array`	Optional	Only changes to these campaign / ad group / ad IDs.
`limit`	`integer`	Optional	Changes per page (1-200, default 50).min: 1, max: 200
`cursor`	`string`	Optional	nextCursor from the previous response. Pass it with otherwise identical parameters for the next page.
`refresh`	`boolean`	Optional	Fetch TikTok's change log now before answering. Normally not needed: it is fetched when the last sync is over 15 minutes old.
`connection_id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

Description

Usage

Parameters

Related Tools