Skip to content

Commit 59ebd8e

Browse files
committed
Update formatting
1 parent 711e2be commit 59ebd8e

File tree

1 file changed

+33
-39
lines changed

1 file changed

+33
-39
lines changed

developer-guidelines.mdx

Lines changed: 33 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -59,66 +59,60 @@ Before building, ask yourself these questions. If you answer **"no"** to any of
5959

6060
## Common Scenarios: Allowed or Not?
6161

62-
Real-world examples to help you understand what's permitted. These cover automated accounts, integrations, and apps of all types.
62+
Real-world examples to help you understand what's permitted. **These rules apply to all apps**—whether you're building a bot, mobile app, web integration, browser extension, analytics dashboard, or any other tool that uses the X API.
6363

6464
<Tabs>
6565
<Tab title="Content & Posting">
6666
| Scenario | Allowed? | Why |
6767
|----------|:--------:|-----|
68-
| Bot posts scheduled content (news, weather, quotes) | <Icon icon="circle-check" color="#22c55e" /> | Informational, no unsolicited mentions |
69-
| Bot posts RSS feed updates automatically | <Icon icon="circle-check" color="#22c55e" /> | Helpful broadcasting |
70-
| Bot posts earthquake/disaster alerts | <Icon icon="circle-check" color="#22c55e" /> | Public safety value |
71-
| Bot posts sports scores or game updates | <Icon icon="circle-check" color="#22c55e" /> | Informational |
72-
| Bot posts stock/crypto prices on schedule | <Icon icon="circle-check" color="#22c55e" /> | Informational, no manipulation |
73-
| Bot posts identical content across multiple accounts | <Icon icon="circle-xmark" color="#ef4444" /> | Spam / platform manipulation |
74-
| Bot posts to trending topics to gain visibility | <Icon icon="circle-xmark" color="#ef4444" /> | Trend manipulation |
75-
| Multiple city-specific weather bots (e.g., @WeatherNYC, @WeatherLA) | <Icon icon="circle-check" color="#22c55e" /> | Allowed—non-duplicative, location-specific content |
68+
| Automated account posts scheduled content (news, weather, quotes) | <Icon icon="circle-check" color="#22c55e" /> | Informational, no unsolicited mentions |
69+
| App posts RSS feed updates on behalf of user | <Icon icon="circle-check" color="#22c55e" /> | Helpful broadcasting |
70+
| Alert service posts earthquake/disaster notifications | <Icon icon="circle-check" color="#22c55e" /> | Public safety value |
71+
| Sports app posts game updates to user's timeline | <Icon icon="circle-check" color="#22c55e" /> | Informational |
72+
| App posts stock/crypto prices on schedule | <Icon icon="circle-check" color="#22c55e" /> | Informational, no manipulation |
73+
| App posts identical content across multiple accounts | <Icon icon="circle-xmark" color="#ef4444" /> | Spam / platform manipulation |
74+
| App posts to trending topics to gain visibility | <Icon icon="circle-xmark" color="#ef4444" /> | Trend manipulation |
75+
| Multiple city-specific alert accounts (e.g., @WeatherNYC, @WeatherLA) | <Icon icon="circle-check" color="#22c55e" /> | Allowed—non-duplicative, location-specific content |
7676
</Tab>
7777
<Tab title="Replies & Mentions">
7878
| Scenario | Allowed? | Why |
7979
|----------|:--------:|-----|
80-
| Bot responds to @mentions asking for help | <Icon icon="circle-check" color="#22c55e" /> | User-initiated request |
81-
| Bot replies to anyone mentioning a keyword | <Icon icon="circle-xmark" color="#ef4444" /> | Unsolicited interaction |
82-
| Bot auto-replies to users who reply to your tweet | <Icon icon="circle-check" color="#22c55e" />* | User engaged first—limit 1 reply per interaction |
83-
| AI-powered bot generates and posts replies | <Icon icon="triangle-exclamation" color="#f59e0b" /> | Requires **prior approval** from X |
84-
| Bot replies with "follow me for more!" to random users | <Icon icon="circle-xmark" color="#ef4444" /> | Spam, unsolicited |
85-
| Thread unroller bot that responds when asked | <Icon icon="circle-check" color="#22c55e" /> | User-initiated utility |
86-
87-
<Note>*Conditional—see [Gray Areas](#gray-areas-explained) section below.</Note>
80+
| App responds to @mentions asking for help | <Icon icon="circle-check" color="#22c55e" /> | User-initiated request |
81+
| App auto-replies to anyone mentioning a keyword | <Icon icon="circle-xmark" color="#ef4444" /> | Unsolicited interaction |
82+
| App auto-replies to users who reply to your post | <Icon icon="circle-check" color="#22c55e" /> | User engaged first—limit 1 reply. [Conditions apply](#gray-areas-explained) |
83+
| AI-powered app generates and posts replies | <Icon icon="triangle-exclamation" color="#f59e0b" /> | Requires **prior approval** from X |
84+
| App replies with "follow me for more!" to random users | <Icon icon="circle-xmark" color="#ef4444" /> | Spam, unsolicited |
85+
| Utility app that unrolls threads when mentioned | <Icon icon="circle-check" color="#22c55e" /> | User-initiated utility |
8886
</Tab>
8987
<Tab title="Direct Messages">
9088
| Scenario | Allowed? | Why |
9189
|----------|:--------:|-----|
92-
| Bot responds to DMs with helpful info | <Icon icon="circle-check" color="#22c55e" /> | User-initiated |
93-
| Bot sends affiliate links when user DMs first | <Icon icon="circle-check" color="#22c55e" />* | User-initiated—must disclose affiliate relationship |
94-
| Bot auto-DMs new followers with welcome message | <Icon icon="circle-xmark" color="#ef4444" /> | Unsolicited, even to followers |
95-
| Bot bulk-DMs users about a product launch | <Icon icon="circle-xmark" color="#ef4444" /> | Spam |
96-
| Support bot asks "How can I help?" after user DMs | <Icon icon="circle-check" color="#22c55e" /> | User-initiated conversation |
97-
98-
<Note>*Conditional—see [Gray Areas](#gray-areas-explained) section below.</Note>
90+
| App responds to DMs with helpful info | <Icon icon="circle-check" color="#22c55e" /> | User-initiated |
91+
| App sends affiliate links when user DMs first | <Icon icon="circle-check" color="#22c55e" /> | User-initiated—must disclose. [Conditions apply](#gray-areas-explained) |
92+
| App auto-DMs new followers with welcome message | <Icon icon="circle-xmark" color="#ef4444" /> | Unsolicited, even to followers |
93+
| App bulk-DMs users about a product launch | <Icon icon="circle-xmark" color="#ef4444" /> | Spam |
94+
| Support integration asks "How can I help?" after user DMs | <Icon icon="circle-check" color="#22c55e" /> | User-initiated conversation |
9995
</Tab>
10096
<Tab title="Engagement">
10197
| Scenario | Allowed? | Why |
10298
|----------|:--------:|-----|
103-
| Bot auto-likes posts containing a hashtag | <Icon icon="circle-xmark" color="#ef4444" /> | Automated likes banned |
104-
| Bot auto-likes posts from a specific user | <Icon icon="circle-xmark" color="#ef4444" /> | Automated likes banned |
105-
| Bot reposts content from a curated list | <Icon icon="circle-check" color="#22c55e" />* | OK for informational purposes, no bulk spam |
106-
| Bot bulk-follows accounts to grow audience | <Icon icon="circle-xmark" color="#ef4444" /> | Manipulation |
107-
| Bot follows back anyone who follows it | <Icon icon="circle-xmark" color="#ef4444" /> | Bulk/aggressive following |
108-
| Bot adds users to lists in bulk | <Icon icon="circle-xmark" color="#ef4444" /> | Indiscriminate list manipulation |
109-
110-
<Warning>**Automated likes are banned with no exceptions.** This is one of the most common violations.</Warning>
99+
| App auto-likes posts containing a hashtag | <Icon icon="circle-xmark" color="#ef4444" /> | Automated likes banned |
100+
| Mobile app has "auto-like" feature for selected users | <Icon icon="circle-xmark" color="#ef4444" /> | Automated likes banned |
101+
| App reposts content from a curated list | <Icon icon="circle-check" color="#22c55e" /> | OK for informational purposes, no bulk spam. [Conditions apply](#gray-areas-explained) |
102+
| Growth tool bulk-follows accounts to grow audience | <Icon icon="circle-xmark" color="#ef4444" /> | Manipulation |
103+
| App follows back anyone who follows it | <Icon icon="circle-xmark" color="#ef4444" /> | Bulk/aggressive following |
104+
| App adds users to lists in bulk | <Icon icon="circle-xmark" color="#ef4444" /> | Indiscriminate list manipulation |
105+
106+
<Warning>**Automated likes are banned with no exceptions.** This applies to all apps—bots, mobile apps, browser extensions, or any integration.</Warning>
111107
</Tab>
112108
<Tab title="Promotions & Commerce">
113109
| Scenario | Allowed? | Why |
114110
|----------|:--------:|-----|
115-
| Bot sends product recommendations when asked | <Icon icon="circle-check" color="#22c55e" /> | User-initiated |
116-
| Bot replies to random posts with affiliate links | <Icon icon="circle-xmark" color="#ef4444" /> | Unsolicited spam |
117-
| Giveaway bot that requires follows/retweets to enter | <Icon icon="triangle-exclamation" color="#f59e0b" /> | Risky—can be seen as engagement manipulation |
118-
| Bot selling likes/follows/retweets | <Icon icon="circle-xmark" color="#ef4444" /> | Strictly prohibited |
119-
| Tip bot that sends crypto when user requests | <Icon icon="circle-check" color="#22c55e" />* | User-initiated—comply with financial regulations |
120-
121-
<Note>*Conditional—see [Gray Areas](#gray-areas-explained) section below.</Note>
111+
| App sends product recommendations when asked | <Icon icon="circle-check" color="#22c55e" /> | User-initiated |
112+
| App replies to random posts with affiliate links | <Icon icon="circle-xmark" color="#ef4444" /> | Unsolicited spam |
113+
| Giveaway app that requires follows/retweets to enter | <Icon icon="triangle-exclamation" color="#f59e0b" /> | Risky—can be seen as engagement manipulation |
114+
| Service selling likes/follows/retweets | <Icon icon="circle-xmark" color="#ef4444" /> | Strictly prohibited |
115+
| Tip service that sends crypto when user requests | <Icon icon="circle-check" color="#22c55e" /> | User-initiated—comply with financial regulations. [Conditions apply](#gray-areas-explained) |
122116
</Tab>
123117
<Tab title="Data & Research">
124118
| Scenario | Allowed? | Why |

0 commit comments

Comments
 (0)