account | DynamicAccount | Yes | - | Select the X Ads account that owns the entity. |
entity_type | enum (CAMPAIGN, LINE_ITEM, PROMOTED_TWEET, TARGETING_CRITERIA, PROMOTED_ACCOUNT) | Yes | - | The kind of entity to retrieve change history for: CAMPAIGN, LINE_ITEM (ad group), PROMOTED_TWEET (ad), TARGETING_CRITERIA, or PROMOTED_ACCOUNT. |
entity_id | string or SelectItem | Yes | - | The specific entity’s ID. X returns change history per entity rather than for the whole account. |
time_range | string or SelectableOption | No | {'value': 'last_7_days', 'label': 'Last 7 days'} | Period to retrieve history for: ‘last_30_days’, ‘last_14_days’, ‘last_7_days’ (default), ‘today’, or ‘yesterday’. |
limit | integer | No | 100 | Maximum number of history records to return. Default: 100. |