🦋 Bluesky Scraper

Scrape posts from Bluesky (the AT Protocol social network) — by keyword, hashtag, author handle, or any custom feed. No coding, no rate-limit headaches. Export to JSON, CSV, Excel, or push directly into your stack via API.

⚡ Built for AI dataset builders, social media analysts, brand-monitoring teams, and trend hunters who need clean, structured Bluesky data at scale.

---

✨ What you can do

• 🔎 Search posts by keyword or hashtag (#ai, bitcoin, climate change)
• 👤 Pull any user's full feed by handle (jay.bsky.team)
• 📡 Subscribe to custom feeds by AT URI
• 📅 Filter by date range and language
• 💬 Optionally include replies
• 📤 Get rich post metadata: text, likes, reposts, replies, embeds, hashtags, mentions, links

---

🎯 Use cases

Who	Why
🤖 AI / LLM teams	Build clean training datasets from a fast-growing social network
📊 Social analytics	Track hashtags, brand mentions, sentiment over time
🕵️ Competitor monitoring	Watch what competitors post, what gets engagement
📰 Journalists & researchers	Archive public discourse around news events
📈 Trend hunters	Find rising topics & influencers before they hit mainstream

---

🚀 Quick start

1. Click Try for free
2. Choose a mode: search, author, or feed
3. Enter your search terms / handles / feed URIs
4. (Optional but recommended) Add your Bluesky handle + an App Password for higher rate limits and full reliability
5. Click Start

That's it. Your data appears in the Dataset tab in seconds.

---

📥 Input

Field	Type	Description
mode	enum	search / author / feed
searchTerms	array	Keywords or hashtags (search mode)
authors	array	Bluesky handles (author mode)
feedUris	array	AT URIs (feed mode)
maxItems	int	Cap per target (default 1000)
since / until	ISO date	Date range filter
language	string	2-letter code (e.g. en)
includeReplies	bool	Include replies in author mode
bskyHandle	string	Optional — your Bluesky handle
bskyAppPassword	secret	Optional — your App Password

Example input

{
    "mode": "search",
    "searchTerms": ["#ai", "llm"],
    "maxItems": 5000,
    "since": "2026-04-01",
    "language": "en",
    "bskyHandle": "yourname.bsky.social",
    "bskyAppPassword": "xxxx-xxxx-xxxx-xxxx"
}

---

📤 Output (per post)

{
    "uri": "at://did:plc:.../app.bsky.feed.post/...",
    "cid": "bafyrei...",
    "author": {
        "did": "did:plc:...",
        "handle": "username.bsky.social",
        "displayName": "Display Name",
        "avatar": "https://..."
    },
    "text": "Full post text",
    "createdAt": "2026-04-15T12:34:56.000Z",
    "indexedAt": "2026-04-15T12:34:57.000Z",
    "langs": ["en"],
    "likeCount": 42,
    "repostCount": 7,
    "replyCount": 3,
    "quoteCount": 1,
    "embed": { /* images, video, quoted posts */ },
    "tags": ["ai"],
    "mentions": ["did:plc:..."],
    "links": ["https://..."],
    "isReply": false,
    "replyParent": null,
    "replyRoot": null,
    "bskyUrl": "https://bsky.app/profile/username.bsky.social/post/abc"
}

---

💡 Why authentication?

Bluesky's public API rate-limits anonymous requests aggressively from datacenter IPs. Adding your own free Bluesky App Password (NOT your main password — App Passwords are revocable single-purpose tokens) lifts limits and gives reliable, full-speed scraping. Your credentials are never stored — they're passed only to Bluesky's official servers per run.

---

❓ FAQ

Is this legal? Bluesky's public API is open by design — the AT Protocol is built around portable, public data. This Actor uses official endpoints only.

Will my account get banned? No. App Passwords are intended for read access. Treat normal rate limits and you'll be fine.

Can I run this on a schedule? Yes — use Apify's Schedule feature to run hourly/daily.

How fast is it? Authenticated runs typically pull ~3,000 posts/minute.

---

Got questions or feature requests? Open an issue or message us.