Skip to content
Get MCP AdsGet MCP Ads, home
Start free
View as Markdown

tiktok_get_spark_organic_joins

Join accessible Spark Ads fields with paid page/post reporting and optional organic identity/post endpoints when permissions allow.

Join accessible Spark Ads fields with paid page/post reporting and optional organic identity/post endpoints when permissions allow. Read-only only.

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

NameTypeRequiredNotes
advertiserIdstringRequiredTikTok advertiser ID.
adIdsarrayOptionalOptional ad IDs to inspect.
adgroupIdstringOptionalOptional ad group ID filter.
includeOrganicEndpointsbooleanOptionalTry identity/post metadata endpoints when Spark IDs are discovered. Default: true.
includeExperimentalEndpointsbooleanOptionalAlso try undocumented/unstable Organic API endpoint candidates that may return 404. Disabled by default to keep warnings actionable. Default: false.
startDatestringOptionalStart date YYYY-MM-DD for page_id reporting. Defaults to 14 days ago.
endDatestringOptionalEnd date YYYY-MM-DD for page_id reporting. Defaults to today.
limitintegerOptionalDefault: 100.

Calling itLink to this section

jsonThrough run_tool, since it is not announced
{
  "name": "run_tool",
  "arguments": {
    "name": "tiktok_get_spark_organic_joins",
    "args": {
      "advertiserId": "<string>"
    }
  }
}
Esc

Type to search