{
  "openapi": "3.0.1",
  "info": {
    "title": "Bluesky Scraper: Posts, Profiles, Search & Threads",
    "description": "Scrape Bluesky posts by keyword, hashtag, author or date, full profile timelines, reply threads and people search. Get text, likes, reposts, replies, quotes, links, images, follower counts and emails in bios. No login. Export to JSON, CSV or Excel.",
    "version": "0.1",
    "x-build-id": "2UpYpevOJvhO0rxDc"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/davidcastro~bluesky-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-davidcastro-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/davidcastro~bluesky-scraper/runs": {
      "post": {
        "operationId": "runs-sync-davidcastro-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/davidcastro~bluesky-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-davidcastro-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": {
          "searchQueries": {
            "title": "Search posts",
            "type": "array",
            "description": "Keywords or phrases, with quotes for exact phrases. Each query returns up to 100 posts. Use several queries or date ranges to collect more.",
            "default": [
              "climate tech"
            ],
            "items": {
              "type": "string"
            }
          },
          "handles": {
            "title": "Profiles",
            "type": "array",
            "description": "Handles such as bsky.app or nytimes.com, @name, or profile links. Returns the profile and its posts.",
            "items": {
              "type": "string"
            }
          },
          "postUrls": {
            "title": "Post threads",
            "type": "array",
            "description": "Bluesky post links. Returns the post and all replies in its thread.",
            "items": {
              "type": "string"
            }
          },
          "userSearchQueries": {
            "title": "Search people",
            "type": "array",
            "description": "Words to find accounts by name, handle or bio, for example \"data journalist\". Returns full profiles.",
            "items": {
              "type": "string"
            }
          },
          "followersOf": {
            "title": "Followers of",
            "type": "array",
            "description": "Handles or profile links. Returns the accounts that follow each one, with handle, name, bio and links in the bio.",
            "items": {
              "type": "string"
            }
          },
          "maxPostsPerSource": {
            "title": "Max results per source",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Limit for each search query, profile timeline, thread, people search or followers list. Post searches return up to 100 posts each.",
            "default": 100
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Total posts and profiles to deliver in this run. Free Apify plans are limited to 10 per run.",
            "default": 100
          },
          "sort": {
            "title": "Search order",
            "enum": [
              "latest",
              "top"
            ],
            "type": "string",
            "description": "Latest posts first, or the most engaged posts first.",
            "default": "latest"
          },
          "since": {
            "title": "From date",
            "type": "string",
            "description": "Only posts created on or after this date. Also applies to profile timelines."
          },
          "until": {
            "title": "To date",
            "type": "string",
            "description": "Only posts created before this date."
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Two-letter language code for search results, for example en, es, pt or ja."
          },
          "hashtags": {
            "title": "Hashtags",
            "type": "array",
            "description": "Only search results with all of these hashtags, without the # sign.",
            "items": {
              "type": "string"
            }
          },
          "author": {
            "title": "Posted by",
            "type": "string",
            "description": "Only search results from this handle."
          },
          "mentions": {
            "title": "Mentioning",
            "type": "string",
            "description": "Only search results that mention this handle."
          },
          "domain": {
            "title": "Linking to domain",
            "type": "string",
            "description": "Only search results that link to this website, for example nytimes.com."
          },
          "minLikes": {
            "title": "Minimum likes",
            "minimum": 0,
            "type": "integer",
            "description": "Skip posts with fewer likes."
          },
          "excludeReplies": {
            "title": "Exclude replies",
            "type": "boolean",
            "description": "Keep only top-level posts in search results and timelines.",
            "default": false
          },
          "includeProfiles": {
            "title": "Include the profile row",
            "type": "boolean",
            "description": "For each profile in Profiles, add one row with its bio, counters, links and emails in the bio.",
            "default": true
          },
          "postsFromProfiles": {
            "title": "Include profile posts",
            "type": "boolean",
            "description": "Collect posts from each profile's timeline.",
            "default": true
          },
          "profileFeed": {
            "title": "Profile timeline",
            "enum": [
              "posts",
              "replies",
              "media",
              "videos",
              "threads"
            ],
            "type": "string",
            "description": "Which posts to take from each profile.",
            "default": "posts"
          },
          "includeReposts": {
            "title": "Include reposts",
            "type": "boolean",
            "description": "Also return posts the profile reposted from others.",
            "default": false
          },
          "minFollowers": {
            "title": "People search: minimum followers",
            "minimum": 0,
            "type": "integer",
            "description": "Skip accounts with fewer followers in people search."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}