Skip to content
Scrappa Get API key
Bluesky API 1 credit/request

Bluesky Post Search

GET https://scrappa.co/api/bluesky/search-posts?query=bluesky&limit=10

Searches public posts. version=v2 (default) takes query= and accepts sort=top or sort=recent; version=v1 takes q= and is the only generation that accepts the literal sort=latest token. Filter names differ per generation and mixing them is rejected rather than silently ignored. hits_total is an upstream estimate and saturates near 10000.

Bluesky Post Search 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/bluesky/search-posts?query=bluesky&limit=10
Auth header
x-api-key
Cost
1 credit/request
Response preview
200 OK
{
    "success": true,
    "hits_total": 10000,
    "hits_total_approximate": true,
    "detected_query_languages": [
        "en"
    ]
}

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

This endpoint has no required query parameters.

23 optional filters available.

query string Optional

Search text for version=v2.

Example value bluesky
q string Optional

Search text for version=v1.

Example value coffee shops
version string Optional

v2 (default) or v1.

Example value example
limit integer Optional

Results per page, 1-100.

Example value 10
sort string Optional

V2: top or recent. V1: latest or top.

Example value relevance
cursor string Optional

Opaque pagination cursor.

Example value 0
authors[] array Optional

Restrict to these authors. V2 only, plural key.

Example value ["example"]
hashtags[] array Optional

Restrict to these hashtags. V2 only, plural key.

Example value ["example"]
domains[] array Optional

Restrict to posts linking these domains. V2 only.

Example value ["example"]
hasMedia boolean Optional

Only posts with media. V2 only.

Example value true
following boolean Optional

Rejected with 422. This filter only narrows results for a viewer, and public Bluesky search is always read anonymously, so it could never do anything.

Example value true
author string Optional

Restrict to one author. V1 only, singular key.

Example value example
tag[] array Optional

Restrict to these hashtags. V1 only. This is the one plural filter on V1: repeat the key or pass a comma-separated list, and multiple tags are AND-matched.

Example value ["example"]
lang string Optional

Restrict to this language code. V1 only.

Example value example
since string Optional

Only posts after this timestamp. Both generations.

Example value example
until string Optional

Only posts before this timestamp. Both generations.

Example value example
excludeAuthors[] array Optional

Exclude these authors. V2 only, plural key. Accepted and forwarded; upstream effect unverified.

Example value ["example"]
excludeHashtags[] array Optional

Exclude these hashtags. V2 only, plural key. Accepted and forwarded; upstream effect unverified.

Example value ["example"]
excludeMentions[] array Optional

Exclude these mentions. V2 only, plural key. Accepted and forwarded; upstream effect unverified.

Example value ["example"]
excludeDomains[] array Optional

Exclude posts linking these domains. V2 only. Accepted and forwarded; upstream effect unverified.

Example value ["example"]
excludeUrls[] array Optional

Exclude posts linking these URLs. V2 only. Accepted and forwarded; upstream effect unverified.

Example value ["example"]
excludeLanguages[] array Optional

Exclude these language codes. V2 only. Accepted and forwarded; upstream effect unverified.

Example value ["example"]
excludeEmbeddedAtUris[] array Optional

Exclude posts embedding these records. V2 only. Accepted and forwarded; upstream effect unverified.

Example value ["example"]

Request Examples

PHP
<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://scrappa.co/api/bluesky/search-posts?query=bluesky&limit=10",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        "x-api-key: YOUR_API_KEY_HERE"
    ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
    echo "cURL Error #:" . $err;
} else {
    echo $response;
}
PHP
<?php

use Illuminate\Support\Facades\Http;

$response = Http::timeout(30)
    ->withHeaders(['x-api-key' => 'YOUR_API_KEY_HERE'])
    ->get('https://scrappa.co/api/bluesky/search-posts?query=bluesky&limit=10');

if ($response->successful()) {
    echo $response->body();
} else {
    echo "Error: " . $response->status();
}
JavaScript
const options = {
    method: 'GET',
    headers: {
        'x-api-key': 'YOUR_API_KEY_HERE'
    }
};

fetch('https://scrappa.co/api/bluesky/search-posts?query=bluesky&limit=10', options)
    .then(response => {
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        return response.text();
    })
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));
JavaScript
const axios = require('axios');

const options = {
    method: 'GET',
    url: 'https://scrappa.co/api/bluesky/search-posts?query=bluesky&limit=10',
    headers: {
        x-api-key: 'YOUR_API_KEY_HERE',
    }
};

try {
    const response = await axios(options);
    console.log(response.data);
} catch (error) {
    console.error('Error:', error.message);
}
Ruby
require 'net/http'
require 'uri'

uri = URI.parse("https://scrappa.co/api/bluesky/search-posts?query=bluesky&limit=10")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'

request = Net::HTTP::Get.new(uri.request_uri)
request['x-api-key'] = 'YOUR_API_KEY_HERE'

begin
    response = http.request(request)
    puts response.body
rescue => e
    puts "Error: #{e.message}"
end
Python
import http.client
import json

conn = http.client.HTTPSConnection("scrappa.co")

headers = {
    'x-api-key': 'YOUR_API_KEY_HERE',
}

try:
    conn.request("GET", "/api/bluesky/search-posts?query=bluesky&limit=10", headers=headers)
    res = conn.getresponse()
    data = res.read()
    print(data.decode("utf-8"))
except Exception as e:
    print(f"Error: {e}")
finally:
    conn.close()
Python
import requests

headers = {
    'x-api-key': 'YOUR_API_KEY_HERE',
}

try:
    response = requests.get('https://scrappa.co/api/bluesky/search-posts?query=bluesky&limit=10', headers=headers)
    response.raise_for_status()
    print(response.text)
except requests.exceptions.RequestException as e:
    print(f"Error: {e}")
Java
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.io.IOException;

public class ApiExample {
    public static void main(String[] args) {
        OkHttpClient client = new OkHttpClient();

        Request request = new Request.Builder()
            .url("https://scrappa.co/api/bluesky/search-posts?query=bluesky&limit=10")
        .addHeader("x-api-key", "YOUR_API_KEY_HERE")
            .build();

        try (Response response = client.newCall(request).execute()) {
            if (response.isSuccessful()) {
                System.out.println(response.body().string());
            } else {
                System.out.println("Error: " + response.code());
            }
        } catch (IOException e) {
            System.out.println("Error: " + e.getMessage());
        }
    }
}
Go
package main

import (
    "fmt"
    "net/http"
    "io/ioutil"
)

func main() {
    client := &http.Client{}
    req, err := http.NewRequest("GET", "https://scrappa.co/api/bluesky/search-posts?query=bluesky&limit=10", nil)
    if err != nil {
        fmt.Println("Error creating request:", err)
        return
    }
    req.Header.Set("x-api-key", "YOUR_API_KEY_HERE")

    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("Error making request:", err)
        return
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Println("Error reading response:", err)
        return
    }

    fmt.Println(string(body))
}
Terminal
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/bluesky/search-posts?query=bluesky&limit=10"
C#
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY_HERE");

        try
        {
            var response = await client.SendAsync(new HttpRequestMessage(HttpMethod.Get, "https://scrappa.co/api/bluesky/search-posts?query=bluesky&limit=10"));
            var content = await response.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}
TypeScript
import axios from 'axios';

async function run(): Promise<void> {
    try {
        const response = await axios({
            method: 'GET',
            url: 'https://scrappa.co/api/bluesky/search-posts?query=bluesky&limit=10',
            headers: {
        'x-api-key': 'YOUR_API_KEY_HERE',
            },
        });

        console.log(response.data);
    } catch (error) {
        console.error('Error:', error);
    }
}

void run();
RUST
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    let response = client
        .get("https://scrappa.co/api/bluesky/search-posts?query=bluesky&limit=10")
        .header("x-api-key", "YOUR_API_KEY_HERE")
        .send()
        .await?;

    println!("{}", response.text().await?);

    Ok(())
}

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

success hits_total hits_total_approximate detected_query_languages
JSON Response
200 OK
{
    "success": true,
    "hits_total": 10000,
    "hits_total_approximate": true,
    "detected_query_languages": [
        "en"
    ]
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.