A Python library for scraping Twitter/X via its web GraphQL API. No official API access needed — just your browser cookies.

What you can do:

• Search tweets — by keyword, date range, user, hashtag, engagement filters, language, location. Supports raw Twitter advanced search operators as the query string
• Profile tweets — fetch a user's timeline
• Followers / Following — scrape follower and following lists
• User info — profile metadata (bio, follower count, verified status, etc.)
• Multi-account pooling — rotate across accounts with automatic rate limiting and cooldowns
• Resume — pick up interrupted scrapes from where they left off
• Save to CSV / JSON — built-in output persistence
• Async support — every method has a sync and async variant

pip install -U Scweet

1. Get your cookies — Log into Twitter/X, open DevTools (F12) → Application → Cookies → https://x.com, copy auth_token and ct0.

Don't want to deal with cookies and account management? Try the hosted version on Apify — no setup, free tier included.

2. Create cookies.json:

[{ "username": "your_account", "cookies": { "auth_token": "...", "ct0": "..." } }]

3. Scrape:

from Scweet import Scweet

s = Scweet(cookies_file="cookies.json")

# Search tweets
tweets = s.search("python programming", limit=100)
tweets = s.search("AI", since="2024-01-01", until="2024-06-01", limit=500)

# Profile tweets
tweets = s.get_profile_tweets(["elonmusk", "OpenAI"], limit=200)

# Followers / Following
users = s.get_followers(["elonmusk"], limit=1000)
users = s.get_following(["OpenAI"], limit=500)

# User info
profiles = s.get_user_info(["elonmusk", "OpenAI"])

Tip: Always set limit — without it, scraping continues until results are exhausted or daily account caps are hit.

tweets = s.search(
    since="2024-01-01",
    from_users=["OpenAI"],
    min_likes=50,
    has_links=True,
    lang="en",
    limit=200,
)

Available filters: all_words, any_words, exact_phrases, exclude_words, hashtags_any, from_users, to_users, mentioning_users, tweet_type, verified_only, has_images, has_videos, has_links, min_likes, min_replies, min_retweets, place, geocode, and more. See Full Documentation.

s = Scweet(cookies={"auth_token": "...", "ct0": "..."})           # Direct cookies
s = Scweet(auth_token="YOUR_AUTH_TOKEN")                           # Auth token only (ct0 bootstrapped)
s = Scweet(cookies=[{"auth_token": "t1", "ct0": "c1"}, ...])      # Multi-account pool
s = Scweet(db_path="scweet_state.db")                              # Reuse provisioned accounts

from Scweet import Scweet, ScweetConfig

s = Scweet(
    cookies_file="cookies.json",
    config=ScweetConfig(
        concurrency=3,
        proxy="http://user:pass@host:port",
        daily_requests_limit=50,
        manifest_scrape_on_init=True,
    ),
)

For output formats, resume, async patterns, account management, and the full config reference — see Full Documentation.

tweets = s.search("bitcoin", since="2024-01-01", limit=200, save=True)
# → outputs/bitcoin_2024-01-01_2024-03-20.csv

tweets = s.search("AI", limit=200, save=True, save_format="json")
# → outputs/AI_2024-03-13_2024-03-20.json

tweets = s.search("query", limit=200, save=True, save_name="my_results")
# → outputs/my_results.csv

Files are written to outputs/ by default (configurable via ScweetConfig(save_dir="my_dir")). File names are auto-generated from the query and date range, or you can set save_name explicitly. Results append to existing files.

import asyncio
from Scweet import Scweet

async def main():
    s = Scweet(cookies_file="cookies.json")
    tweets = await s.asearch("python", limit=100)
    users = await s.aget_followers(["elonmusk"], limit=500)

asyncio.run(main())

All methods: asearch(), aget_profile_tweets(), aget_followers(), aget_following(), aget_user_info().

• This is scraping (Twitter/X web GraphQL), not an official API. Behavior may change.
• You need X account cookies. Rate limits and anti-bot measures are enforced by X.
• Use responsibly and in compliance with applicable terms and laws.

For production workloads, or if you'd rather skip account and proxy management entirely, Scweet is available as a hosted actor on Apify with a free tier.

PRs, bug reports, and feature suggestions are welcome! If you find Scweet useful, consider starring the repo.

MIT License