Skip to main content
← Back to blog
•by Engineering
write-apiautomationTutorials

How to Automate Twitter Posts with API: Complete Guide

Why Automate Twitter Posts?

Manual posting is fine for personal accounts, but if you're running a crypto signal channel, managing a community bot, or publishing market updates, you need automation. The XCROP Write API lets you create tweets, reply to threads, quote-tweet, like, retweet, and follow/unfollow users, all through simple REST endpoints, at a flat 100 credits per operation. That's a fraction of official Twitter API write pricing.

Connect Your X Account First

Before any of the bots below will work, connect your X account to XCROP. It's a one-time setup. Full details on credentials vs. cookie auth, proxy requirements, and how your credentials are secured are covered in the Write API Guide; here's the minimal call to get connected:

PYTHON
import requests, os

requests.post(
    "https://xcrop.io/api/v2/account/connect",
    headers={"Authorization": "Bearer " + os.environ["XCROP_API_KEY"]},
    json={
        "email": "[email protected]",
        "password": "your-x-password",
        "proxy": "http://user:pass@residential-proxy:port"
    }
)

Once connected, every write endpoint (create, reply, quote, like, retweet, follow) works exactly as documented in the Write API Guide. The rest of this post focuses on stringing those endpoints together into real, running bots.

Practical Automation Examples

Example 1: Scheduled Posting Bot

Post market updates at specific times using a simple scheduler:

PYTHON
import schedule
import time
import requests
import os

API_KEY = os.environ["XCROP_API_KEY"]
HEADERS = {
    "Authorization": "Bearer " + API_KEY,
    "Content-Type": "application/json"
}
BASE = "https://xcrop.io/api/v2"

def morning_update():
    # Fetch trending topics first
    trending = requests.get(
        BASE + "/trending",
        headers=HEADERS
    ).json()["data"]

    top_topics = [t["name"] for t in trending[:3]]
    text = (
        "GM! Here is what crypto Twitter is talking about today:\n\n"
        + "1. " + top_topics[0] + "\n"
        + "2. " + top_topics[1] + "\n"
        + "3. " + top_topics[2] + "\n\n"
        + "Stay sharp out there."
    )

    requests.post(BASE + "/tweets/create", headers=HEADERS, json={"text": text})

schedule.every().day.at("08:00").do(morning_update)

while True:
    schedule.run_pending()
    time.sleep(60)

Example 2: KOL Engagement Bot

Monitor key opinion leaders and auto-engage with high-impact tweets:

JAVASCRIPT
const API_KEY = process.env.XCROP_API_KEY;
const HEADERS = {
  "Authorization": "Bearer " + API_KEY,
  "Content-Type": "application/json"
};
const BASE = "https://xcrop.io/api/v2";

async function monitorAndEngage() {
  // Fetch each KOL's latest tweets and merge them
  const kols = ["CryptoHayes", "DefiIgnas", "Pentosh1"];
  const feeds = await Promise.all(
    kols.map(u => fetch(BASE + "/users/" + u + "/tweets?count=20", { headers: HEADERS }).then(r => r.json()))
  );
  const tweets = feeds.flatMap(f => f.data || []);

  for (const tweet of tweets) {
    const likes = tweet.metrics.likes;

    // Only engage with viral tweets (5k+ likes)
    if (likes > 5000) {
      // Like it
      await fetch(BASE + "/tweets/" + tweet.tweet_id + "/like", {
        method: "POST",
        headers: HEADERS
      });

      // Retweet it
      await fetch(BASE + "/tweets/" + tweet.tweet_id + "/retweet", {
        method: "POST",
        headers: HEADERS
      });

      console.log("Engaged with tweet by @" + tweet.author.username);

      // Rate limit: wait 30 seconds between actions
      await new Promise(r => setTimeout(r, 30000));
    }
  }
}

// Run every 10 minutes
setInterval(monitorAndEngage, 600000);

Example 3: Auto-Reply to Mentions

Search for mentions of your project and reply automatically:

PYTHON
import requests
import os
import time

API_KEY = os.environ["XCROP_API_KEY"]
HEADERS = {
    "Authorization": "Bearer " + API_KEY,
    "Content-Type": "application/json"
}
BASE = "https://xcrop.io/api/v2"

replied_ids = set()

def check_mentions():
    response = requests.post(
        BASE + "/search",
        headers=HEADERS,
        json={
            "query": "@yourproject",
            "sort": "latest",
            "count": 10
        }
    )

    tweets = response.json()["data"]

    for tweet in tweets:
        tid = tweet["tweet_id"]
        if tid not in replied_ids:
            requests.post(
                BASE + "/tweets/reply",
                headers=HEADERS,
                json={
                    "tweet_id": tid,
                    "text": "Thanks for the mention! Check out our docs at https://yourproject.io/docs"
                }
            )
            replied_ids.add(tid)
            time.sleep(15)  # Space out replies

while True:
    check_mentions()
    time.sleep(300)  # Check every 5 minutes

Responsible Automation

Automation is powerful, but misuse leads to account suspension. Follow these rules:

1. Respect rate limits: XCROP enforces plan-based rate limits (60-600 req/min). Space out write operations by at least 10-30 seconds
2. No spam: Every tweet should provide genuine value. Do not post repetitive or promotional content
3. Vary your content: Identical or near-identical tweets get flagged by X's spam detection
4. Use residential proxies: Required by XCROP and essential for avoiding detection
5. Monitor your account: Check /account/status regularly to ensure your session is healthy
6. Comply with X/Twitter ToS: Automated posting must follow platform rules

Credit Costs

Every write operation used above (create, reply, quote, like, retweet) costs a flat 100 credits. See the Write API Guide for the full operation table and plan pricing.

Next Steps

• Combine read + write: Use search and KOL timeline to find content, then engage automatically
• Build dashboards: Track your bot's activity via the Dashboard API
• Export data: Collect engagement metrics on your automated posts
• Go deeper: The Write API Guide covers the full endpoint reference, security model, and best practices behind everything used here
Build this with the XCROP API

One API for X/Twitter data: profiles, tweets, followers, search and real-time streams. Start free with 5,000 credits/month, no card required.

Get your free API keyRead the docsSee pricing