Get Audience - Markifact

Fetches the connected TikTok account’s audience: follower countries, genders, ages, and cities (available once the account has 100 or more followers), or follower active times by hour of day for picking posting times.


App	TikTok Organic
Operation ID	`tiktok_get_audience`
Type	Action
Connection	`tiktok` (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`breakdown`	string or SelectableOption	Yes	-	Which audience breakdown to fetch for the connected account. Available options: ‘countries’, ‘genders’, ‘ages’, ‘cities’ (follower demographics as fractions; TikTok only reports these once the account has 100 or more followers), and ‘active_times’ (when followers are online: activity count per hour of day 0-23, summed over the date range; use it to pick posting times).
`date_range`	DateRange	No	-	Only used for ‘active_times’. Defaults to the last 30 days. Demographic breakdowns are current snapshots and ignore it.

DateRange

Field	Type	Required	Default	Description
`start`	string	No	-	The start date of the date range to query, format: YYYY-MM-DD or dynamic node reference like {{nodeId__data.start_date}}. Required when preset is ‘FIXED’ or ‘CUSTOM’.
`end`	string	No	-	The end date of the date range to query, format: YYYY-MM-DD or dynamic node reference like {{nodeId__data.end_date}}. Required when preset is ‘FIXED’ or ‘CUSTOM’.
`preset`	string	No	-	Predefined date ranges or input modes: - Use ‘FIXED’ or leave empty when you want to specify exact dates (YYYY-MM-DD format) in start/end fields - Use ‘CUSTOM’ when you want to use dynamic values from other nodes ({{nodeId__data.start_date}} format) in start/end fields - Use other presets (TODAY, YESTERDAY, LAST_7_DAYS, etc.) for predefined date ranges (start/end will be ignored) LAST_N_MONTHS and LAST_N_WEEKS are complete calendar periods ending with last month or last week, so they exclude the current month or week; for a rolling window up to yesterday use LAST_N_DAYS (for example LAST_90_DAYS) or a FIXED range. When using ‘FIXED’ or ‘CUSTOM’, both start and end fields are required.
`compare`	CompareOptions	No	-	Optional comparison date range settings. ALWAYS use this field for comparisons; DO NOT create additional requests or nodes, as the backend returns current, comparison, and delta metrics in a single call. If one period has no data at all, only the period with data is returned and no delta row; treat the missing period as zero.

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

CompareOptions

Field	Type	Required	Default	Description
`start`	string	No	-	The start date of the comparison range, format: YYYY-MM-DD. Optional if preset is provided.
`end`	string	No	-	The end date of the comparison range, format: YYYY-MM-DD. Optional if preset is provided.
`preset`	string	No	-	Predefined comparison ranges. When provided, start and end will be ignored.
`comparison_format`	string	No	`rows`	Comparison output layout: ‘rows’ returns separate rows for current, comparison, and delta along with date ranges; ‘columns’ returns a single row with delta values only as additional _pct or _change columns depending on comparison_value_type.
`comparison_value_type`	string	No	`percentage`	Value type: ‘percentage’ or ‘absolute’

Output

Type: List[Dict] One row per breakdown entry with TikTok’s own field names; demographics use fractions, active_times uses activity counts per hour (0-23). Fields: dynamic (depend on the inputs) Example:

[
  {
    "country": "AE",
    "percentage": 0.32
  },
  {
    "country": "US",
    "percentage": 0.054
  }
]