Bluesky Search API

Search Bluesky using the documented query and filters, and return structured results.

GET/v1/bluesky/search

1 credit per successful callCache window 5 minutesFull API reference ↗

Coverage is rolling out during preview. Test the endpoint you need before integrating. Unavailable operations return an explicit error and use no credits.

Try this endpoint

Enter the documented inputs, run a protected browser test, and inspect the JSON response.

Request preview

Copy this request into your server-side integration, or run a test to inspect the response.

curl -X GET 'https://socialquery.dev/v1/bluesky/search?query=espresso' \
  -H "x-api-key: $SOCIALQUERY_API_KEY"

Request contract

Parameters

Pass these fields as query parameters. Production requests also require your server-side API key.

queryRequired: The keywords or phrase to search for.
Example: espresso
sortOptional: Provide sort in the format shown in the example.
Example: latest
sinceOptional: Provide since in the format shown in the example.
Example: —
untilOptional: Provide until in the format shown in the example.
Example: —
langOptional: Provide lang in the format shown in the example.
Example: —
authorOptional: Provide author in the format shown in the example.
Example: —