Bluesky API

BSK-06 (v2) / BSK-07 (v1)

get/bluesky/search-posts

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/bluesky/search-posts
  • Auth: API key in header X-API-KEY

Query parameters

qstring nullable

Search text for version=v1.

querystring nullable

Search text for version=v2.

version'v1' | 'v2' required

v2 (default) or v1.

limitinteger nullable

Results per page, 1-100.

cursorstring nullable

Opaque pagination cursor.

sortstring nullable

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

authorstring nullable

Restrict to one author. V1 only, singular key.

langstring nullable

Restrict to this language code. V1 only.

domainstring nullable
urlstring nullable
sincestring date-time nullable

Only posts after this timestamp. Both generations.

untilstring date-time nullable

Only posts before this timestamp. Both generations.

authors[]string[]

Restrict to these authors. V2 only, plural key.

hashtags[]string[]

Restrict to these hashtags. V2 only, plural key.

domains[]string[]

Restrict to posts linking these domains. V2 only.

urls[]string[]
languages[]string[]
embeddedAtUris[]string[]
tag[]string[]

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.

excludeAuthors[]string[]

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

excludeHashtags[]string[]

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

excludeMentions[]string[]

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

excludeDomains[]string[]

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

excludeUrls[]string[]

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

excludeLanguages[]string[]

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

excludeEmbeddedAtUris[]string[]

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

mentions[]string[]
allTimeboolean nullable
hasMediaboolean nullable

Only posts with media. V2 only.

hasVideoboolean nullable
repliesOnlyboolean nullable
excludeRepliesboolean nullable
followingboolean nullable

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.

Response

object required
OR
string required

Changes

No recorded changes to this operation across all 3 revisions of this API.