tiktok_get_adgroups

Read full native ad group configuration including targeting, custom/lookalike audience references and exclusions, geo, language, age/gender, placements…

Read full native ad group configuration including targeting, custom/lookalike audience references and exclusions, geo, language, age/gender, placements, interests/behaviors, budget and schedule. Set smartPlus:true for upgraded Smart+ targeting_spec. Missing fields are unknown, not unrestricted targeting. Paginated.

Source: TikTok Ads
Kind: Read
Discovery: Reachable through search_tools and run_tool
Account parameter: advertiserId
Endpoint: https://mcp.getmcpads.com/tiktok-ads/mcp

ParametersLink to this section

Name	Type	Required	Notes
`advertiserId`	string	Required	Exact TikTok numeric ID, as a string.
`campaignId`	string	Optional	Exact TikTok numeric ID, as a string.
`adgroupIds`	array	Optional	Restrict TikTok results to these ad group IDs.
`smartPlus`	boolean	Optional	Use true for upgraded Smart+ ad groups: reads their native targeting_spec and exact placements via smart_plus/adgroup/get. No fallback to classic settings. Default: `false`.
`page`	integer	Optional	Page number to request, starting at 1. Default: `1`.
`limit`	integer	Optional	Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: `100`.

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "tiktok_get_adgroups",
    "args": {
      "advertiserId": "<string>"
    }
  }
}