tiktok_create_lookalike_audience

Create a TikTok lookalike audience from a source audience of this advertiser: at least 100 people and not itself a lookalike.

View as Markdown

Create a TikTok lookalike audience from a source audience of this advertiser: at least 100 people and not itself a lookalike. TikTok builds it within 48 hours. Include it with audience_ids or exclude it with excluded_audience_ids on an ad group. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

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

Parameters

Parameters
Name	Type	Required	Notes
`advertiserId`	string	Required	Exact TikTok numeric ID as a string, never a rounded JavaScript number.
`name`	string	Required	Exact audience name, 128 characters at most.
`sourceAudienceId`	string	Required	Source audience ID in this advertiser (customer file or rule audience).
`includeSource`	boolean	Required	Whether the lookalike also contains the source audience.
`mobileOs`	string	Required	Devices of the lookalike. One of: `ALL`, `ANDROID`, `IOS`.
`placements`	array	Required	Native placements, for example ["TikTok"]; TikTok also documents Pangle.
`locationIds`	array	Required	Lookalike country codes, for example ["FR"].
`audienceSize`	string	Required	Similarity against reach. One of: `NARROW`, `BALANCED`, `BROAD`.
`confirm`	boolean	Optional	Apply only when true. Default is a local preview without any TikTok call. Never retry an uncertain POST automatically.

Calling it

json · Through run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "tiktok_create_lookalike_audience",
    "args": {
      "advertiserId": "<string>",
      "name": "<string>",
      "sourceAudienceId": "<string>",
      "includeSource": "<boolean>",
      "mobileOs": "ALL",
      "placements": "<array>",
      "locationIds": "<array>",
      "audienceSize": "NARROW"
    }
  }
}

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.