`tiktok_ads_list_ad_groups`

List TikTok Ad Groups

Tiktok

Description

List TikTok ad groups for an advertiser. Shows name, status, targeting, and budget.

Read-onlyIdempotentOpen-world

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

hopkin tiktok ad-groups list

Flag	Type	Required	Description
`--limit`	`integer`	Optional	Maximum number of results to return (1–100). Default: 20.
`--cursor`	`string`	Optional	Opaque pagination cursor from a previous response.
`--refresh`	`boolean`	Optional	Force a fresh fetch bypassing the cache.
`--advertiser-id`	`string`	Required	TikTok advertiser ID.
`--adgroup-id`	`string`	Optional	Fetch a single ad group by ID.
`--adgroup-ids`	`array`	Optional	Fetch specific ad groups by IDs.
`--campaign-ids`	`array`	Optional	Filter by parent campaign IDs.
`--status`	`array`	Optional	Filter by primary status.
`--search`	`string`	Optional	Search ad groups by name (case-insensitive).

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

Name	Type	Required	Description
`advertiser_id`	`string`	Required	TikTok advertiser ID.minLength: 1
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (8)

Name	Type	Required	Description
`limit`	`integer`	Optional	Maximum number of results to return (1–100). Default: 20.min: 1, max: 100
`cursor`	`string`	Optional	Opaque pagination cursor from a previous response.
`refresh`	`boolean`	Optional	Force a fresh fetch bypassing the cache.
`adgroup_id`	`string`	Optional	Fetch a single ad group by ID.
`adgroup_ids`	`array`	Optional	Fetch specific ad groups by IDs.
`campaign_ids`	`array`	Optional	Filter by parent campaign IDs.
`status`	`array`	Optional	Filter by primary status.
`search`	`string`	Optional	Search ad groups by name (case-insensitive).