X (Twitter) supports text, media, and link post types. The twitter object enables polls, reply restrictions, and content disclosure flags.
Supported Post Types#
| Post Type | Description |
|---|
MEDIA | One or more images or a video |
STATUS | Text-only post, no media |
LINK | URL post with optional preview |
Network Options#
X-specific settings are passed in the twitter object on the post body.| Field | Type | Description |
|---|
poll | string[] | Poll options. Provide 2–4 choices, each 1–25 characters. |
pollDuration | integer | Duration of the poll in minutes. Must be between 5 (5 min) and 10080 (7 days). |
replySettings | FOLLOWING | MENTIONED_USERS | SUBSCRIBERS | VERIFIED | Restrict who can reply. Omit to allow everyone. |
superFollowersOnly | boolean | Limit post visibility to super followers only. |
madeWithAi | boolean | Disclose that the post was made with AI tools. |
paidPartnership | boolean | Mark the post as a paid partnership. |
Examples#
STATUS post#
MEDIA post#
Post with a poll#
Post with reply restrictions#
AI-generated content + paid partnership#
Notes#
X (Twitter) does not support STORY or REEL post types.
poll requires 2–4 options. Each must be 1–25 characters. Polls and media cannot be combined in the same post.
pollDuration must be between 5 (5 minutes) and 10080 (7 days). Omitting it while providing poll will cause a validation error.
replySettings is omitted by default, which allows everyone to reply.
madeWithAi and paidPartnership are optional disclosures required by X's platform policies when applicable.
X (Twitter) is not supported for insights via the API.
Use net: "twitter" on captions, media, and links when targeting X profiles specifically.
Modified at 2026-06-19 15:01:20
