APIs / Bluesky / Search Posts

Bluesky: Search Posts

Search Posts from Bluesky as JSON. 1 credit per successful call.

GET /v1/bluesky/search-postsNeeds terms

Note

This endpoint needs the restricted-endpoint terms, which you can accept in your dashboard.

Parameters

Send parameters in the query string.

Parameter	Type	Required	Allowed values
`q`	string	Optional	Up to 2,048 characters
`query`	string	Optional	Up to 2,048 characters
`version`	string	Required	v1, v2
`limit`	integer	Optional	Any
`cursor`	string	Optional	Up to 2,048 characters
`sort`	string	Optional	Up to 32 characters
`author`	string	Optional	Up to 512 characters
`lang`	string	Optional	Up to 64 characters
`domain`	string	Optional	Up to 512 characters
`url`	string	Optional	Up to 2,048 characters
`since`	string	Optional	Up to 64 characters
`until`	string	Optional	Up to 64 characters
`authors[]`	list of string	Optional	Up to 2,048 characters
`hashtags[]`	list of string	Optional	Up to 2,048 characters
`domains[]`	list of string	Optional	Up to 2,048 characters
`urls[]`	list of string	Optional	Up to 2,048 characters
`languages[]`	list of string	Optional	Up to 2,048 characters
`embeddedAtUris[]`	list of string	Optional	Up to 2,048 characters
`tag[]`	list of string	Optional	Up to 2,048 characters
`excludeAuthors[]`	list of string	Optional	Up to 2,048 characters
`excludeHashtags[]`	list of string	Optional	Up to 2,048 characters
`excludeMentions[]`	list of string	Optional	Up to 2,048 characters
`excludeDomains[]`	list of string	Optional	Up to 2,048 characters
`excludeUrls[]`	list of string	Optional	Up to 2,048 characters
`excludeLanguages[]`	list of string	Optional	Up to 2,048 characters
`excludeEmbeddedAtUris[]`	list of string	Optional	Up to 2,048 characters
`mentions[]`	list of string	Optional	Up to 2,048 characters
`allTime`	boolean	Optional	Any
`hasMedia`	boolean	Optional	Any
`hasVideo`	boolean	Optional	Any
`repliesOnly`	boolean	Optional	Any
`excludeReplies`	boolean	Optional	Any
`following`	boolean	Optional	Any

Example request

cURLshell

curl "https://api.perceptlayer.com/v1/bluesky/search-posts?query=bluesky&limit=10" \
  -H "X-API-Key: $API_KEY"

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.