account | DynamicAccount | Yes | - | Select the X Ads account whose posts should be listed. |
tweet_type | enum (PUBLISHED, DRAFT, SCHEDULED) | No | PUBLISHED | Which posts to list: PUBLISHED (default), DRAFT, or SCHEDULED. Post IDs from this node can be promoted with x_ads_create_ad. |
timeline_type | enum (ALL, NULLCAST, ORGANIC) | No | ALL | Which posts to include: ALL (default here), NULLCAST (Promoted-only dark posts), or ORGANIC (posts that appear on the timeline). |
post_ids | string or array of string | No | - | Scope to specific post IDs (list or comma-separated string, up to 200). They must match the selected tweet_type. Take these from the id_str or tweet_id field, never a numeric id: X ids are 64-bit and any tool that stores them as a number rounds them into a post that does not exist. |
user_id | string | No | - | Only list posts by this X user id. Defaults to all promotable users. |
name | string | No | - | Scope to posts whose internal name matches this value. |
include_mentions_and_replies | boolean | No | False | Include posts that are mentions or replies. |
filters | array of FilterItem | No | - | Additional filters applied to the returned posts. The available fields to filter by are: - tweet_id: Filter by post ID - full_text: Filter by the post’s text - name: Filter by the post’s internal name Filters are combined using AND logic. If you want to use OR logic, use relevant operators like REGEXP_MATCH or IN_LIST. |
limit | integer | No | 100 | Maximum number of posts to return. Default: 100. |
