View as Markdown
TikTok Ads Manager icon

TikTok Ads Manager ACTION

Get Spark Ad Video Info

Get information about one or more TikTok posts published via a linked identity, for use as Spark Ad creatives. Returns video duration, dimensions, cover image, authorization status, and visibility. Requires an identity (identity_type + identity_id) — use /identity/get/ to find identities linked to your ad account. Pass either item_id (single post) or item_ids (up to 20 posts). Pass the returned item_id to Create or Update Ad as tiktok_item_id to create a Spark Ad. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's TikTok Ads Manager account once, then configure and run Get Spark Ad Video Info from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "tiktok_ads_manager-manage-spark-ad",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    tiktok_ads_manager: { authProvisionId: "apn_xxxxxxx" },
    advertiserId: "Advertiser ID",
    identityType: "Identity Type",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Get Spark Ad Video Info inputs
Property Type Description
advertiserId Advertiser ID string
Your TikTok Ads Manager advertiser ID. Find it in the Ads Manager URL after aadvid= (e.g., aadvid=7123456789012345678). Also visible under Account Info in Business Center.
Required
identityType Identity Type string
The type of identity that published the TikTok post. AUTH_CODE = Authorized Post User. TT_USER = TikTok Business Account User. BC_AUTH_TT = TikTok account authorized via Business Center.
Required
identityId Identity ID string
The ID of the identity. Use /identity/get/ to retrieve identities linked to your ad account.
Required
identityAuthorizedBcId Identity Authorized BC ID string
Required when identity_type is BC_AUTH_TT. ID of the Business Center associated with the TikTok account.
Optional
itemId Post ID string
ID of a single TikTok post to look up. Use either this or item_ids (not both). Use /identity/video/get/ to find post IDs for an identity.
Optional
itemIds Post IDs string[]
IDs of multiple TikTok posts to look up (max 20). Use either this or item_id (not both).
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
tiktok_ads_manager-manage-spark-ad
Version
0.0.2
App
TikTok Ads Manager
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes