{
"openapi": "3.0.1",
"info": {
"title": "Bluesky Scraper — Posts, Profiles, Followers & Search",
"description": "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.",
"version": "0.1",
"x-build-id": "U9O6XpgfJe3wyUpT3"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/apium~bluesky-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-apium-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/apium~bluesky-scraper/runs": {
"post": {
"operationId": "runs-sync-apium-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/apium~bluesky-scraper/run-sync": {
"post": {
"operationId": "run-sync-apium-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": {
"handles": {
"title": "Handles or DIDs",
"uniqueItems": true,
"type": "array",
"description": "Bluesky accounts to scrape, as handles (e.g. jay.bsky.team), full profile URLs (e.g. https://bsky.app/profile/jay.bsky.team) or DIDs (e.g. did:plc:oky5czdrnfjpqslsw2a5iclo). Used by the posts, profile and followers scrape types.",
"items": {
"type": "string"
}
},
"searchQueries": {
"title": "Search queries",
"uniqueItems": true,
"type": "array",
"description": "Full-text search queries for Bluesky posts (same syntax as the search box on bsky.app, e.g. \"climate change\", from:nasa.gov ai). Each query is paginated until Max items is reached.",
"items": {
"type": "string"
}
},
"postUrls": {
"title": "Post URLs",
"uniqueItems": true,
"type": "array",
"description": "Individual Bluesky post URLs (e.g. https://bsky.app/profile/bsky.app/post/3l6oveex3ii2l) or AT URIs (at://did:plc:.../app.bsky.feed.post/...). The post and its full reply thread are scraped; with the likes scrape type, accounts that liked each post are scraped too.",
"items": {
"type": "string"
}
},
"scrapeTypes": {
"title": "What to scrape",
"uniqueItems": true,
"type": "array",
"description": "Which data to collect for the accounts and posts above. posts = author feed of each handle, profile = profile record of each handle, followers = follower list of each handle, likes = accounts that liked each post URL.",
"items": {
"type": "string",
"enum": [
"posts",
"profile",
"followers",
"likes"
],
"enumTitles": [
"Posts (author feed)",
"Profile details",
"Followers",
"Post likes (likers)"
]
},
"default": [
"posts",
"profile"
]
},
"maxItems": {
"title": "Max items (spend cap)",
"minimum": 1,
"type": "integer",
"description": "Hard cap on the total number of results pushed to the dataset across all inputs. The run stops cleanly when the cap is reached, so this directly caps your spend on pay-per-result pricing.",
"default": 1000
},
"includeReplies": {
"title": "Include replies",
"type": "boolean",
"description": "When scraping an account's posts, also include the replies it wrote (not just top-level posts).",
"default": false
},
"includeReposts": {
"title": "Include reposts",
"type": "boolean",
"description": "When scraping an account's posts, also include posts it reposted from other accounts (marked with isRepost: true and repostedBy).",
"default": false
},
"dateFrom": {
"title": "Date from",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([T ].*)?$",
"type": "string",
"description": "Only keep posts created on or after this date. Accepts YYYY-MM-DD or a full ISO 8601 timestamp (e.g. 2026-01-01 or 2026-01-01T12:00:00Z)."
},
"dateTo": {
"title": "Date to",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([T ].*)?$",
"type": "string",
"description": "Only keep posts created on or before this date (inclusive). Accepts YYYY-MM-DD or a full ISO 8601 timestamp."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}