ZuckerBot › Tool reference › Creative analysis

Get Creative Attributes

zuckerbot_get_creative_attributes

Read the stored creative attribute tags for up to 50 Meta ads in the canonical creative_attributes.v1 shape: the 17 extracted attributes (hook type, visual style, CTA type, copy tone, booleans and more), the extraction lifecycle (tag_status, error class, attempt metadata, legacy_row flag), taxonomy/prompt/model versions, asset/input fingerprints and the campaign objective family. A pure read of already-stored rows — it never triggers extraction and never spends anything. Use after zuckerbot_audit_account reports creative analysis complete, or before zuckerbot_creative_analysis to inspect individual ads.

Parameters

Name	Type		Description
`business_id`	string	optional	Optional business ID override for the authenticated API key
`ad_ids`	array	required	Meta ad ids to read (max 50 per request)
`include_raw`	boolean	optional	Include the raw legacy fields (model_used, confidence_score, tag_error, tagged_by) per item

Example call

{
  "tool": "zuckerbot_get_creative_attributes",
  "arguments": {
    "ad_ids": []
  }
}

You never invoke this directly — describe what you want in plain English inside Claude, Cursor, ChatGPT or any MCP client with ZuckerBot connected, and the agent selects zuckerbot_get_creative_attributes and fills the arguments for you.

Related tools — Creative analysis

Connect ZuckerBot to your AI agent in about two minutes: get started free, browse the full tool reference, or grab the lifetime deal.