Pricing

from $0.58 / 1,000 post returneds

Try for free

Go to Apify Store

Bluesky Scraper: Firehose Mentions & Hashtags

Try for free

Track Bluesky mentions of your keywords, hashtags or account, and every post linking to your site or page, read from Bluesky's own firehose over the last 1 to 36 hours. Quiet posts are found as surely as popular ones. One row per post with text, author, images, likes, reposts and replies.

Pricing

from $0.58 / 1,000 post returneds

Rating

0.0

(0)

Developer

Pradio Actors

Actor stats

Bookmarked

Total users

Monthly active users

19 days ago

Last modified

Categories

Social media

Marketing

You can access the Bluesky Scraper: Firehose Mentions & Hashtags 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 API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.1",
    "x-build-id": "sSQ7ACo8dfNJV0MSU"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/pradio~bluesky-mentions/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-pradio-bluesky-mentions",
        "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/pradio~bluesky-mentions/runs": {
      "post": {
        "operationId": "runs-sync-pradio-bluesky-mentions",
        "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/pradio~bluesky-mentions/run-sync": {
      "post": {
        "operationId": "run-sync-pradio-bluesky-mentions",
        "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": {
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Words or phrases to track, matched as whole words, case-insensitive. A post matching any topic in any field is returned. A keyword written as a Bluesky handle is held to the mentions rule: an account that opted out or is on the exclusion list is not tracked.",
            "items": {
              "type": "string"
            }
          },
          "hashtags": {
            "title": "Hashtags",
            "type": "array",
            "description": "Hashtags to track, with or without the #.",
            "items": {
              "type": "string"
            }
          },
          "mentions": {
            "title": "Mentions of an account",
            "type": "array",
            "description": "Handles whose @mentions to track (brand.bsky.social). Returns posts by anyone that mention the account, never the account's own history. An account that asked Bluesky to hide it from logged-out viewers, or is on the exclusion list, is not tracked: its topic returns one free row saying why.",
            "items": {
              "type": "string"
            }
          },
          "domains": {
            "title": "Links to a domain",
            "type": "array",
            "description": "Domains whose links to track (example.com). A post linking to the domain or any subdomain matches, through its links, link card or text.",
            "items": {
              "type": "string"
            }
          },
          "urls": {
            "title": "Links to a page",
            "type": "array",
            "description": "Web addresses whose links to track, one page each (https://example.com/news/story). A post matches when it links to that exact page, through its links, link card or text. Tracking parameters such as utm_source do not count against a match; the rest of the address must match. For every page on a site, use Links to a domain.",
            "items": {
              "type": "string"
            }
          },
          "lookbackHours": {
            "title": "Look back (hours)",
            "minimum": 1,
            "maximum": 36,
            "type": "integer",
            "description": "How far back to read, from 1 to 36 hours (the firehose keeps about 36). For a daily schedule, use 24: it reads each hour once. 25 adds an hour of overlap for a late schedule, at the price of one extra hour-scanned event.",
            "default": 24
          },
          "endHoursAgo": {
            "title": "End the window (hours ago)",
            "minimum": 0,
            "maximum": 35,
            "type": "integer",
            "description": "Where the window ends, in hours before the run starts. 0 (the default) reads up to the start of the run. With a look back of 30 and 6 here, the run reads from 30 hours back to 6 hours back, 24 hours in all. Only the hours between are read and charged. Must be smaller than the look back.",
            "default": 0
          },
          "resumeFrom": {
            "title": "Resume from",
            "type": "string",
            "description": "Continue a run that ended early: paste the resume_from timestamp a stopped row carried and the run reads from that exact scan position instead of Look back hours ago. Already-scanned hours are not read or billed twice. The window still ends where End hours ago puts it. Must fall inside the roughly 36 hours the firehose keeps; an older point is refused. Leave empty for a normal run."
          },
          "languages": {
            "title": "Languages",
            "type": "array",
            "description": "Only posts tagged with one of these language codes (en, de, ja); pt-BR and pt both mean Portuguese. Empty returns every language. Posts with no tag are left out unless you tick the option below.",
            "items": {
              "type": "string"
            }
          },
          "matchDetectedLanguage": {
            "title": "Include untagged posts by detected language",
            "type": "boolean",
            "description": "Many authors tag no language. Tick this and a post with no language tag is kept when its text reads as one of your Languages. Off by default: only tagged posts pass the Languages filter. Does nothing when Languages is empty.",
            "default": false
          },
          "includeReplies": {
            "title": "Include replies",
            "type": "boolean",
            "description": "Return replies as well as top-level posts and quotes.",
            "default": true
          },
          "excludeAuthors": {
            "title": "Exclude authors",
            "type": "array",
            "description": "Handles or DIDs whose posts this run must not return, one per line.",
            "items": {
              "type": "string"
            }
          },
          "excludePosts": {
            "title": "Exclude posts already returned",
            "type": "array",
            "description": "at:// addresses of posts an earlier run already returned: the uri column of its rows, one per line. A listed post is never matched: it does not count toward the caps and is neither returned nor billed. This is how a daily schedule returns only posts it has not sent you. An entry that is not an at:// address is named on a free bad_input row and does not stop the run.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Maximum items",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "The most posts one run returns, newest first. Up to 5000.",
            "default": 1000
          },
          "maxItemsPerTopic": {
            "title": "Maximum items per topic",
            "minimum": 1,
            "type": "integer",
            "description": "The most posts one topic returns, newest first, so a busy topic cannot use up the run's cap. Empty means only maxItems applies."
          },
          "minLikes": {
            "title": "Minimum likes",
            "minimum": 0,
            "type": "integer",
            "description": "Only return posts with at least this many likes when the row is read. A post under the minimum is not returned and not charged, and does not count toward Maximum items. Empty returns every post."
          },
          "minReposts": {
            "title": "Minimum reposts",
            "minimum": 0,
            "type": "integer",
            "description": "Only return posts with at least this many reposts when the row is read. Works with Minimum likes: a post must meet both. A post under the minimum is not returned and not charged."
          },
          "minReplies": {
            "title": "Minimum replies",
            "minimum": 0,
            "type": "integer",
            "description": "Only return posts with at least this many replies when the row is read: the posts people answered. Works with the other minimums: a post must meet each one set. A post under it is not returned and not charged."
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Bluesky Scraper: Mentions, Hashtags & Links 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: Firehose Mentions & Hashtags 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: Firehose Mentions & Hashtags API in Python

Bluesky Scraper: Firehose Mentions & Hashtags API in JavaScript

Bluesky Scraper: Firehose Mentions & Hashtags API through CLI

Bluesky Scraper: Firehose Mentions & Hashtags API

Facebook Hashtag Search Scraper

easyapi/facebook-hashtag-search-scraper

Scrape Facebook hashtag posts with ease! Extract post content, user info, reactions, comments count and more from any public Facebook hashtag search results. Perfect for social media monitoring and trend analysis.

EasyApi

923

1.2

(9)

Bluesky Video Downloader

bytepulselabs/bluesky-video-downloader

Download videos from Bluesky posts by adding one or more Bluesky post URLs to extract embedded videos. Then, save downloaded media files, run the downloader via API, schedule and monitor downloads, or integrate with other tools for automated video archiving.

BytePulse Labs

5.0

(9)

Bluesky Post Details Scraper

ecomscrape/bluesky-post-details-scraper

Bluesky Post Details Scraper automates extraction of comprehensive post data including engagement metrics, author information, embedded content, and conversation threads. Efficiently collect social media intelligence from the decentralized Bluesky platform for brand monitoring, trend analysis.

ecomscrape

Bluesky Scraper — Posts, Profiles, Followers & Search

s0rgcl/bluesky-scraper

The most complete Bluesky scraper. Search posts, extract profiles, track followers, analyze engagement — all in one Actor. 8 modes, pagination up to 10K results, rate limiting built-in. No auth required. MCP server for AI agents. Pay per use: $1/1,000 results.

s0rgCL

BlueSky Feed Scraper

harvest/bluesky-feed-scraper

Scrapes data from a specified BlueSky feed URL and outputs detailed information about the posts, including metadata, authors, embedded media, and statistics such as likes, replies, and reposts.

Harvest Data

3.9

(2)

Bluesky Scraper

kelvinosse/bluesky-scraper

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

Kelvin

X (Twitter) Keyword Monitor – Track Mentions, Hashtags

b2b_leads/X-Keyword-Mention-Monitor

Monitor X (Twitter) for keywords, hashtags, cashtags & @mentions in real time. Scrape the latest matching tweets or run scheduled checks that return only new posts since the last run. Filter by language, likes & retweets, push results to a webhook, and export JSON/CSV/Excel.

Emmanuel

BlueSky Profile Data Extractor

sandaliaapps/bluesky-profile-data-extractor

Bluesky profile Data Extractor extracts user details including handle, bio, avatar, verification, followers, and activity metrics in structured JSON format.

Sandalia Apps

Bluesky Scraper & API - Posts, Search, Profiles, Followers

apeye/bluesky-scraper

Scrape Bluesky through the official API: keyword post search, posts with like, repost and reply counts, profiles with follower totals, follower lists, user search and full threads. Clean JSON for social listening, influencer research and AI agents. No login needed except for post search.