# Bluesky Posts Scraper, No Login Needed (`bepolabs/bluesky-posts`) Actor Search words or an account feed, narrow by date and language; each row holds the author, text and links. Costs 0.8 USD per 1,000 posts. - **URL**: https://apify.com/bepolabs/bluesky-posts.md - **Developed by:** [BEPO Labs](https://apify.com/bepolabs) (community) - **Categories:** Social media, News, AI - **Features:** Limited permissions - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $0.80 / 1,000 posts This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### đŸĻ‹ What is Bluesky Posts? Collect what people say on Bluesky: queries or handles go in, a table of posts comes out, with hashtags, quotes and a URL for each one. It reads the AppView API, so no app password is needed. - **Brand monitoring**: follow every mention of your company or product - **Social listening**: measure what people say about a topic, with likes and reposts as engagement - **Account tracking**: archive the posts of competitors, journalists or politicians - **Research**: collect posts in a date window and a language for analysis ![Bluesky Posts: Bluesky posts for any search or handle with text, date, author, likes, reposts, replies, links and hashtags. No login.](https://api.apify.com/v2/key-value-stores/wdeAWGooHdIhvFgSY/records/bluesky-posts-hero.png) #### ✨ Why use this Actor? - ✅ **No login needed**: public API, so no Bluesky account and no app password at risk - ✅ **Search and accounts**: `queries` and `handles` in the same run - ✅ **Filters**: `since`, `until`, `lang` and `sort` (latest or top) - ✅ **Ready for analysis**: links and hashtags extracted, reply flag and engagement counts on every row - ✅ **Cheap**: 0.80 USD per 1,000 posts; failed inputs are not charged ### đŸ“Ļ What data can you get with Bluesky Posts? | | | | |---|---|---| | 📝 Post text | 📅 Created at | 👤 Author handle, name and DID | | ❤ī¸ Likes | 🔁 Reposts and quotes | đŸ’Ŧ Replies | | 🌐 Languages | 🔗 Links | #ī¸âƒŖ Hashtags | | ↩ī¸ Reply flag | 🧭 Post URL and URI | 🔎 Query or handle it came from | ### 🚀 How to use Bluesky Posts Bluesky Posts works in a few clicks, no coding needed: 1. [Create a free Apify account](https://console.apify.com/sign-up) (the free plan includes 5 USD of monthly credit). 2. Open [Bluesky Posts](https://apify.com/bepolabs/bluesky-posts) and click **Try for free**. 3. Enter search words or Bluesky handles, optionally a date window and a language. 4. Click **Start** and wait for the run to finish (most runs take seconds). 5. Download your data as JSON, CSV, Excel, XML or HTML, or send it straight to Google Sheets, Make, Zapier or your AI agent. ![How Bluesky Posts works](https://api.apify.com/v2/key-value-stores/wdeAWGooHdIhvFgSY/records/bluesky-posts-workflow.png) ### âŦ‡ī¸ Input Give `queries`, `handles` or both. Each source returns up to `maxItemsPerSource` posts (default 100). ##### Search Words such as `web scraping` or `"exact phrase"`; `sort` picks the latest (default) or the top posts. ##### Handles Names such as `bsky.app`; the Actor reads that profile's own feed. ##### Dates and language `since` and `until` take a date (YYYY-MM-DD); `lang` a two-letter code such as `en`. | Field | Type | What it does | Default | |---|---|---|---| | **Search queries** (`queries`) | array | Full-text post search, one search per query. | `["web scraping"]` | | **Handles** (`handles`) | array | Account handles whose own posts are read (replies left out), e.g. | | | **Sort (search)** (`sort`) | string | Order of search results: "latest" (newest posts first) or "top" (most liked and reposted first). | `"latest"` | | **Posted since** (`since`) | string | Keep posts on or after this date, e.g. | | | **Posted before** (`until`) | string | Keep posts before this date (exclusive), e.g. | | | **Language (search)** (`lang`) | string | Two-letter language code, e.g. | | | **Maximum posts per query or handle** (`maxItemsPerSource`) | integer | Maximum number of posts returned for each search query or each account handle (1 to 2,000). | `100` | | **Maximum retries** (`maxRetries`) | integer | Retries per request with exponential backoff on network errors, 429 and 5xx. | `3` | ![Bluesky Posts input form](https://api.apify.com/v2/key-value-stores/wdeAWGooHdIhvFgSY/records/bluesky-posts-input.png) #### Input example ```json { "queries": [ "web scraping" ], "sort": "latest", "maxItemsPerSource": 30 } ``` ### âŦ†ī¸ Output Every post becomes one row. The run summary (`OUTPUT`) lists every query and handle with the posts found and the error if one failed. ![Bluesky Posts output table](https://api.apify.com/v2/key-value-stores/wdeAWGooHdIhvFgSY/records/bluesky-posts-output.png) #### Output example One row of the dataset (search "web scraping", a real run of 2026-10-16): ```json { "uri": "at://did:plc:6nkng5626orolzuyvuzocl4e/app.bsky.feed.post/3mxxivr4tvr2l", "url": "https://bsky.app/profile/mmccue.bsky.social/post/3mxxivr4tvr2l", "text": "This is not ok.\n\nwww.niemanlab.org/2026/10/meta...", "createdAt": "2026-10-16T02:13:56.595Z", "authorHandle": "mmccue.bsky.social", "authorName": "Mike McCue", "authorDid": "did:plc:6nkng5626orolzuyvuzocl4e", "likeCount": 6, "repostCount": 5, "replyCount": 2, "quoteCount": 1, "langs": [ "en" ], "isReply": false, "links": [ "https://www.niemanlab.org/2026/10/metas-new-commercial-terms-will-allow-the-scraping-of-news-sites-legal-experts-say/" ], "hashtags": [], "source": "web scraping", "sourceKind": "search" } ``` View the results as a table or JSON in the Output tab and download them as JSON, CSV, Excel, XML, HTML or RSS, all fields or only those you pick. ### 💰 How much does Bluesky Posts cost? Bluesky Posts is priced **per event**: **0.8 USD per 1,000 items** (0.0008 USD per item), with no monthly rental. Whatever lands in the dataset is billed; failed queries and handles cost nothing. | You get | You pay | |---|---| | 100 items | 0.08 USD | | 1,000 items | 0.8 USD | | 10,000 items | 8 USD | | 100,000 items | 80 USD | 💡 Apify's free plan gives you 5 USD of credit every month, enough for about **6,250 items** at no cost. Set a spending limit per run and the Actor stops there. ### ⚖ī¸ Bluesky Posts vs. the alternatives | | Bluesky Posts | Login-based scrapers | Reading the app | |---|---|---|---| | **No account or app password** | ✅ | ❌ | – | | **Search and handles in one run** | ✅ | varies | ❌ | | **Links and hashtags extracted** | ✅ | varies | ❌ | | **Export, schedule, API and MCP** | ✅ | ✅ | ❌ | ### 🔌 Integrations, API and MCP #### Connect Bluesky Posts to your AI agent (MCP) Give Claude, ChatGPT, Cursor or any MCP client direct access to Bluesky Posts through the [Apify MCP server](https://mcp.apify.com). Add this URL to its settings: ```text https://mcp.apify.com/?actors=bepolabs/bluesky-posts ``` For Claude Desktop, add it under `mcpServers` in `claude_desktop_config.json`: ```json { "mcpServers": { "bluesky-posts": { "command": "npx", "args": [ "-y", "@apify/actors-mcp-server", "--actors", "bepolabs/bluesky-posts" ], "env": { "APIFY_TOKEN": "" } } } } ``` Then ask: *"Find the latest Bluesky posts about our product name from the last 7 days and list the ones with more than 10 likes."* #### Run it from your code Python (`pip install apify-client`): ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("bepolabs/bluesky-posts").call(run_input={"queries":["web scraping"],"sort":"latest","maxItemsPerSource":30}) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) ``` JavaScript (`npm install apify-client`): ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: '' }); const run = await client.actor('bepolabs/bluesky-posts').call({"queries":["web scraping"],"sort":"latest","maxItemsPerSource":30}); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` #### No-code integrations Send results to **Google Sheets, Slack, Airtable, HubSpot, Make, Zapier, n8n** and more from the Integrations tab, start runs on a **schedule**, or trigger your own endpoint with a **webhook** when a run finishes. The [Apify API](https://docs.apify.com/api/v2) gives you full control over runs and datasets. ### ❓ FAQ ##### Do I need a Bluesky account? No. The Actor reads Bluesky's public AppView API without login. ##### How far back can I go? As far as Bluesky's search and feeds return; use `since` and `until` for a window and `maxItemsPerSource` for the amount. ##### Are replies included? Yes; `isReply` marks them, so you can filter them out. ##### Is it legal to use Bluesky Posts? The Actor uses Bluesky's open API. Names and texts can be personal data: store and use them under the privacy rules that apply to you (for example the GDPR) and Bluesky's terms. ##### What if something is missing or does not work? Open an issue on the **Issues** tab; we read each one and reply. Feature requests are welcome too. ### đŸ’Ŧ Your feedback Tell us what Bluesky Posts should add on the **Issues** tab or leave a review; your notes decide what we work on next. ### 🔗 Related Actors | Actor | What it does | |---|---| | 🟧 [Hacker News Search](https://apify.com/bepolabs/hacker-news) | Hacker News stories, comments, Ask HN, Show HN and jobs for any search, with points, comment count, date and text. | | 📰 [RSS Feed Reader](https://apify.com/bepolabs/rss-reader) | Any RSS, Atom or JSON feed, or just a website URL, to one clean list of articles, with full text on request. | | 🎙ī¸ [Podcast Episodes](https://apify.com/bepolabs/podcast-episodes) | Search terms, Apple Podcasts ids or RSS feeds to every show and its episodes, with audio links, dates and durations. | | 📈 [Google Trends Scraper](https://apify.com/bepolabs/google-trends) | Interest over time for up to five keywords on one 0 to 100 scale, any country or worldwide, plus top and rising related queries. | | 🏛ī¸ [SAM.gov Contract Opportunities](https://apify.com/bepolabs/sam-gov) | US federal contract opportunities by keyword, NAICS, set-aside or agency, with deadlines, contacts and attachments. | | 🏛ī¸ [UK Tenders](https://apify.com/bepolabs/uk-tenders) | UK public contracts from Contracts Finder and Find a Tender by keyword, CPV, value, region and deadline, with daily alerts. | | 🏛ī¸ [US Federal Grants Finder](https://apify.com/bepolabs/us-grants) | Grants.gov opportunities by keyword, agency or CFDA number, with award amounts, deadlines, eligibility and contacts. | | đŸŒĻī¸ [US Weather Forecast](https://apify.com/bepolabs/us-weather) | Official National Weather Service forecasts, hourly and 7-day, plus active weather alerts for any US point or state. | # Changelog This Actor's version history is a separate document: https://apify.com/bepolabs/bluesky-posts/changelog.md # Actor input Schema ## `queries` (type: `array`): Full-text post search, one search per query. ## `handles` (type: `array`): Account handles whose own posts are read (replies left out), e.g. bsky.app. ## `sort` (type: `string`): Order of search results: "latest" (newest posts first) or "top" (most liked and reposted first). Applies to search queries only, not to account feeds. ## `since` (type: `string`): Keep posts on or after this date, e.g. 2026-10-01. ## `until` (type: `string`): Keep posts before this date (exclusive), e.g. 2026-10-08. With "Posted since" it gives a date window. ## `lang` (type: `string`): Two-letter language code, e.g. en. ## `maxItemsPerSource` (type: `integer`): Maximum number of posts returned for each search query or each account handle (1 to 2,000). Lower it for quick tests. ## `maxRetries` (type: `integer`): Retries per request with exponential backoff on network errors, 429 and 5xx. ## Actor input object example ```json { "queries": [ "web scraping" ], "sort": "latest", "maxItemsPerSource": 100, "maxRetries": 3 } ``` # Actor output Schema ## `results` (type: `string`): Dataset items, one row per result, in the overview table view. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ "web scraping" ] }; // Run the Actor and wait for it to finish const run = await client.actor("bepolabs/bluesky-posts").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": ["web scraping"] } # Run the Actor and wait for it to finish run = client.actor("bepolabs/bluesky-posts").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "queries": [ "web scraping" ] }' | apify call bepolabs/bluesky-posts --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,bepolabs/bluesky-posts" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/z9CfOxwRZ16bNuzPZ/builds/oqjRiZ05AKsPoV7KZ/openapi.json