TikTok Ads

Break TikTok results down by audience

Breaks spend, impressions, CTR, conversions and CPA down by age, gender, placement, device OS or language for a window. Use when: the user asks who their TikTok ads are reaching, or whether a placement or age band is worth keeping. Scope it with campaign_id or adgroup_id. Do not read this as a targeting instruction. TikTok decided where the budget went, and a band with a high CPA is often one the algorithm bought cheaply on purpose; excluding it commonly just raises the price of everything that remains. Recommend an exclusion only when a band has meaningful spend and no conversions at all over a long enough window. Do not use age or gender data to make claims about individuals, and do not target sensitive categories — TikTok restricts them and so does Adako. Returns one table per requested breakdown, each ranked by spend, with each band's share of total spend so a 2% slice is not mistaken for a finding. If a breakdown comes back empty, TikTok does not report that dimension for this objective; say so rather than inferring anything.

post/api/v1/tools/tiktok_get_audience_insights/execute

Request

  • Base URL: https://adako.ai
  • URL: https://adako.ai/api/v1/tools/tiktok_get_audience_insights/execute
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional 8-128 character key. A successful envelope is cached for 24 hours; replaying the key with the same arguments returns it again with Idempotent-Replayed: true, and replaying it with different arguments answers 409.

Request body

Response

The tool ran. A write returns proposal_id and approve_url while the change waits for approval.

successunknown required
toolstring required
dataobject required

Machine-readable result.

markdownstring required

The same result written for a person or a model.

proposal_idstring

Present for writes. Nothing changes on the ad platform until it is approved.

approve_urlstring

Where a person approves the proposal.

request_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.