{
  "openapi": "3.0.1",
  "info": {
    "title": "Bluesky Scraper: Posts, Profiles & Followers",
    "description": "Scrape Bluesky posts, profiles, reply threads, followers, custom feeds and lists as clean JSON, CSV or Excel. Official public API, no login. Date and language filters plus a new-items-only monitoring mode. $0.80 per 1,000 posts.",
    "version": "1.0",
    "x-build-id": "gDa8tt3m1tebaDNJd"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/cleanfeed-data~bluesky-data/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-cleanfeed-data-bluesky-data",
        "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/cleanfeed-data~bluesky-data/runs": {
      "post": {
        "operationId": "runs-sync-cleanfeed-data-bluesky-data",
        "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/cleanfeed-data~bluesky-data/run-sync": {
      "post": {
        "operationId": "run-sync-cleanfeed-data-bluesky-data",
        "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": {
          "profiles": {
            "title": "Profiles",
            "type": "array",
            "description": "Bluesky accounts as handles (<code>bsky.app</code>, <code>@jay.bsky.team</code>), DIDs (<code>did:plc:…</code>) or profile URLs (<code>https://bsky.app/profile/…</code>). For each one you get the profile, recent posts and optionally followers/follows. Post, feed and list URLs pasted here are routed automatically.",
            "items": {
              "type": "string"
            }
          },
          "posts": {
            "title": "Posts / threads",
            "type": "array",
            "description": "Post URLs (<code>https://bsky.app/profile/{handle}/post/{id}</code>) or <code>at://</code> URIs. Returns the post plus its reply tree.",
            "items": {
              "type": "string"
            }
          },
          "feeds": {
            "title": "Custom feeds",
            "type": "array",
            "description": "Custom feed URLs (<code>https://bsky.app/profile/{handle}/feed/{name}</code>) or <code>at://…/app.bsky.feed.generator/…</code> URIs.",
            "items": {
              "type": "string"
            }
          },
          "lists": {
            "title": "Lists",
            "type": "array",
            "description": "List URLs (<code>https://bsky.app/profile/{handle}/lists/{id}</code>) or <code>at://…/app.bsky.graph.list/…</code> URIs. Returns members and/or the list's post feed (see List mode).",
            "items": {
              "type": "string"
            }
          },
          "includeProfileDetails": {
            "title": "Include profile details",
            "type": "boolean",
            "description": "Output one profile item (bio, follower/following/post counts, avatar, created date…) for each account in Profiles.",
            "default": true
          },
          "postsPerProfile": {
            "title": "Posts per profile",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Most recent posts to fetch from each profile's author feed (after filters). 0 = profile only.",
            "default": 100
          },
          "authorFeedFilter": {
            "title": "Author feed filter",
            "enum": [
              "posts_no_replies",
              "posts_with_replies",
              "posts_and_author_threads",
              "posts_with_media",
              "posts_with_video"
            ],
            "type": "string",
            "description": "Which posts to take from each profile.",
            "default": "posts_no_replies"
          },
          "includeReposts": {
            "title": "Include reposts",
            "type": "boolean",
            "description": "Include posts the account reposted (marked with isRepost, repostedByHandle and repostedAt).",
            "default": false
          },
          "includePinned": {
            "title": "Include pinned post",
            "type": "boolean",
            "description": "Include the profile's pinned post (marked isPinned). It does not count toward Posts per profile.",
            "default": true
          },
          "maxFollowersPerProfile": {
            "title": "Followers per profile",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Fetch up to this many followers (newest first) for each profile as profile items with relation = \"follower\". 0 = off.",
            "default": 0
          },
          "maxFollowsPerProfile": {
            "title": "Following per profile",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Fetch up to this many accounts each profile follows, as profile items with relation = \"follow\". 0 = off.",
            "default": 0
          },
          "threadDepth": {
            "title": "Reply depth",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "How many levels of replies to fetch below each post in Posts / threads. 0 = only the post itself.",
            "default": 6
          },
          "includeThreadParents": {
            "title": "Include parent posts",
            "type": "boolean",
            "description": "If the post is itself a reply, also output the posts above it (negative threadDepth).",
            "default": false
          },
          "maxRepliesPerThread": {
            "title": "Max replies per thread",
            "minimum": 0,
            "type": "integer",
            "description": "Cap on replies output per thread (the root post is always included).",
            "default": 1000
          },
          "postsPerFeed": {
            "title": "Posts per custom feed",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Posts to fetch from each custom feed, in the feed's own order.",
            "default": 100
          },
          "listMode": {
            "title": "List mode",
            "enum": [
              "members",
              "posts",
              "both"
            ],
            "type": "string",
            "description": "What to fetch for each list.",
            "default": "members"
          },
          "maxMembersPerList": {
            "title": "Members per list",
            "minimum": 0,
            "type": "integer",
            "description": "Max members to fetch from each list.",
            "default": 1000
          },
          "postsPerList": {
            "title": "Posts per list feed",
            "minimum": 0,
            "type": "integer",
            "description": "Max posts to fetch from each list's feed (List mode = posts or both).",
            "default": 100
          },
          "dateFrom": {
            "title": "Posted on or after",
            "type": "string",
            "description": "Only posts created on/after this date (YYYY-MM-DD or ISO timestamp). Author feeds stop paginating once they pass it. Thread root posts are always kept."
          },
          "dateTo": {
            "title": "Posted on or before",
            "type": "string",
            "description": "Only posts created on/before this date (YYYY-MM-DD is inclusive of the whole day)."
          },
          "postedWithinDays": {
            "title": "Posted within last N days",
            "minimum": 0,
            "type": "integer",
            "description": "Shortcut for a rolling date window. 0 = off. If both this and 'Posted on or after' are set, the later date wins.",
            "default": 0
          },
          "languages": {
            "title": "Languages",
            "type": "array",
            "description": "Only keep posts tagged with one of these language codes (e.g. en, ja, pt). Empty = all.",
            "items": {
              "type": "string"
            }
          },
          "onlyNew": {
            "title": "Only new items (monitoring)",
            "type": "boolean",
            "description": "Output only posts/profiles not output by a previous run with the same state store. Author feeds and follower lists stop paginating as soon as they reach already-seen items. Ideal for scheduled runs.",
            "default": false
          },
          "stateStoreName": {
            "title": "State store name",
            "type": "string",
            "description": "Named key-value store that remembers what was already output (used to set isNew and for Only new items). Use a different name per monitoring task.",
            "default": "bluesky-data-state"
          },
          "maxResults": {
            "title": "Max results (total)",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap on items output in this run, split fairly across all sources (0 = no cap; per-source limits below still apply). Prefilled to 25 so your first test run is quick and cheap; set 0 for full runs. Also caps your cost ($0.80 per 1,000 posts).",
            "default": 0
          },
          "maxConcurrency": {
            "title": "Parallel sources",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Sources processed in parallel. All requests share one polite rate limiter.",
            "default": 3
          },
          "requestDelayMs": {
            "title": "Delay between API requests (ms)",
            "minimum": 100,
            "maximum": 10000,
            "type": "integer",
            "description": "Minimum gap between requests to the Bluesky API. 250 ms (4 req/s) stays far below Bluesky's published limit of 3,000 requests per 5 minutes per IP. 429 responses are retried after the RateLimit-Reset time.",
            "default": 250
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}