Pricing

from $0.50 / 1,000 post scrapeds

Bluesky Scraper — Posts, Profiles, Followers & Search

Scrape Bluesky posts, profiles, followers/following, full threads, and keyword search into clean flat JSON/CSV. Profiles and feeds need no login; keyword search uses your free app password.

Pricing

from $0.50 / 1,000 post scrapeds

Rating

0.0

(0)

Developer

Ethan Teague

Actor stats

Bookmarked

Total users

Monthly active users

4 days ago

Last modified

Categories

Social media

You can access the Bluesky Scraper — Posts, Profiles, Followers & Search programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "x-build-id": "BwQkFHiQtGhX4wYeg"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/ethanteague~bluesky-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-ethanteague-bluesky-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/ethanteague~bluesky-scraper/runs": {
      "post": {
        "operationId": "runs-sync-ethanteague-bluesky-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/ethanteague~bluesky-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-ethanteague-bluesky-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "userHandles": {
            "title": "User handles or profile URLs",
            "type": "array",
            "description": "Bluesky users to scrape — handles (<code>bsky.app</code>, <code>@someone.bsky.social</code>), profile URLs (<code>https://bsky.app/profile/...</code>), or DIDs. For each user the actor scrapes the profile and/or their posts, depending on the options below. <b>No login needed.</b>",
            "items": {
              "type": "string"
            }
          },
          "maxPostsPerUser": {
            "title": "Max posts per user",
            "minimum": 0,
            "maximum": 50000,
            "type": "integer",
            "description": "How many of each user's most recent posts to scrape. Set to 0 to skip posts and get profiles only.",
            "default": 100
          },
          "includeProfiles": {
            "title": "Scrape profile details",
            "type": "boolean",
            "description": "Push a profile item (bio, follower counts, etc.) for every user handle.",
            "default": true
          },
          "includeReposts": {
            "title": "Include reposts in user feeds",
            "type": "boolean",
            "description": "When on, reposts appearing in a user's feed are included (the item's author is the original poster).",
            "default": false
          },
          "authorPostsFilter": {
            "title": "Which posts from user feeds",
            "enum": [
              "posts_no_replies",
              "posts_with_replies",
              "posts_and_author_threads",
              "posts_with_media"
            ],
            "type": "string",
            "description": "Filter applied to each user's feed.",
            "default": "posts_no_replies"
          },
          "includeFollowers": {
            "title": "Scrape followers",
            "type": "boolean",
            "description": "Collect each user's followers (as profile items with source = followers_of).",
            "default": false
          },
          "includeFollows": {
            "title": "Scrape following",
            "type": "boolean",
            "description": "Collect who each user follows (as profile items with source = follows_of).",
            "default": false
          },
          "maxFollowersPerUser": {
            "title": "Max followers/following per user",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Cap for each list (applies separately to followers and following).",
            "default": 200
          },
          "postThreadUrls": {
            "title": "Post/thread URLs",
            "type": "array",
            "description": "Post URLs (<code>https://bsky.app/profile/handle/post/xyz</code>) or AT-URIs (<code>at://did/app.bsky.feed.post/xyz</code>). The post and its reply tree are scraped.",
            "items": {
              "type": "string"
            }
          },
          "threadDepth": {
            "title": "Thread reply depth",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "How many levels of nested replies to fetch.",
            "default": 6
          },
          "searchQueries": {
            "title": "Search queries",
            "type": "array",
            "description": "Keyword searches, e.g. <code>ai agents</code>. Advanced operators from the Bluesky app work too (e.g. <code>from:handle</code>). Leave empty to skip search.",
            "items": {
              "type": "string"
            }
          },
          "maxPostsPerQuery": {
            "title": "Max posts per query",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "How many posts to collect per search query.",
            "default": 100
          },
          "searchSort": {
            "title": "Search sort",
            "enum": [
              "latest",
              "top"
            ],
            "type": "string",
            "description": "Sort order of search results.",
            "default": "latest"
          },
          "searchSince": {
            "title": "Search since (ISO date)",
            "type": "string",
            "description": "Only posts after this time, e.g. <code>2026-01-01T00:00:00Z</code>. Optional."
          },
          "searchUntil": {
            "title": "Search until (ISO date)",
            "type": "string",
            "description": "Only posts before this time. Optional."
          },
          "searchLanguage": {
            "title": "Search language",
            "type": "string",
            "description": "Two-letter language code filter, e.g. <code>en</code>. Optional."
          },
          "blueskyIdentifier": {
            "title": "Bluesky identifier (for search only)",
            "type": "string",
            "description": "Your Bluesky handle or the email you log in with. Only used to unlock keyword search; never stored."
          },
          "blueskyAppPassword": {
            "title": "Bluesky app password (for search only)",
            "type": "string",
            "description": "An app password from Settings → Privacy and security → App passwords. NOT your main password. Encrypted by Apify; never logged."
          },
          "pdsService": {
            "title": "PDS service URL",
            "type": "string",
            "description": "Only change this if your Bluesky account lives on a self-hosted PDS.",
            "default": "https://bsky.social"
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Bluesky Scraper — posts, profiles, followers & search OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Bluesky Scraper — Posts, Profiles, Followers & Search from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Bluesky Scraper — Posts, Profiles, Followers & Search API in Python

Bluesky Scraper — Posts, Profiles, Followers & Search API in JavaScript

Bluesky Scraper — Posts, Profiles, Followers & Search API through CLI

Bluesky Scraper — Posts, Profiles, Followers & Search API

Bluesky Scraper - Profiles, Posts, Followers, Search

actorzlab/bluesky-scraper

Scrape Bluesky via the official AT Protocol: profiles, posts, post search, followers, following, threads & custom feeds. No proxy required, no anti-bot — official open API. App password optional.

Khalil Drissi

Bluesky Scraper — Posts, Profiles, Search, Followers & Threads

prometheusagency/bluesky-scraper

Extract posts, profiles, author feeds, followers and full threads from Bluesky. Keyword/brand search supported. Clean JSON/CSV output for social listening, research and AI agents. No cookies, no proxies needed.

Prometheus Agency

Bluesky Scraper — Profiles, Posts & Search API

sian.agency/bluesky-scraper

Scrape Bluesky (bsky.app) profiles & posts into clean structured data — followers, bio, engagement counts, media, links. Search by keyword or pull full profiles + post feeds. JSON/CSV/Excel. No login or API key needed.

SIÁN OÜ

Bluesky Scraper — Posts, Profiles, Followers & Search

apium/bluesky-scraper

Bluesky scraper for posts, profiles, followers, likes & search. Uses the public Bluesky posts API (AT Protocol) — no login, no proxies. Fast Bluesky data export to JSON, CSV or Excel for monitoring, research and lead gen.

Tommi Sullivan

Bluesky Scraper — Search Posts, Profiles, Followers & Threads

thriftykiwi/bluesky-scraper

Extract public data from Bluesky via the AT Protocol API. Search posts by keyword, get user profiles, followers, follows, author feeds, and full post threads. No authentication required — uses Bluesky's public API endpoints.

Thrifty Kiwi

Bluesky Scraper - Posts, Profiles, Threads, Followers

piposlab/bluesky-scraper

Scrape Bluesky / AT Protocol: posts, profiles, author feeds, threads, followers and follows. No API key needed. Fast, clean JSON output.

Alejandro Bufarini

Bluesky Scraper — Posts, Profiles, Search & Threads

du7chmaniac/bluesky-scraper

Scrape Bluesky posts, profiles, search results, threads, and followers via the AT Protocol API. No authentication required.

Joren Maurissen

Bluesky Scraper

kelvinosse/bluesky-scraper

Scrape profiles, posts, followers, and threads from Bluesky AT Protocol API.

Kelvin

Bluesky Scraper — Posts, Profiles, Search, Followers

andreaslh/bluesky-scraper

Scrape Bluesky posts, profiles, followers, threads, and search results through the official AT Protocol API — fast, reliable, no blocks. Clean flat JSON for spreadsheets, dashboards, and AI pipelines. Pay only per result.

Andreas Lund Helstrøm

Bluesky Scraper – Profiles, Posts, Followers & Search

hichemdev/bluesky-scraper

Scrape Bluesky (AT Protocol) at scale - profiles, posts, followers and following, plus keyword or user search. No login, no cookies, no proxy required. Reliable structured data for social listening, influencer discovery, and research.