List Bluesky profile posts
List posts from a Bluesky profile by handle.
Headers
Get your API keyAPI key (`sfk_...`)
Bluesky handle whose posts should be listed.
min 1 chars · max 253 chars
Pagination cursor returned by a previous response.
min 1 chars
Optional Bluesky user id to speed up the request.
min 1 chars
Endpoint-specific response payload.
Whether the handle resolved for this listing.
one of: found, not_found
Bluesky posts returned for this page.
Stable Bluesky post URI (at://…).
min 1 chars
Content id when available.
Canonical public Bluesky web URL for the post.
min 1 chars
Post text body when available.
ISO-8601 timestamp when the post was created.
ISO-8601 timestamp when the post was indexed.
Author snapshot when available.
Social platform for this author.
one of: bluesky
Stable Bluesky user id as a string.
min 1 chars
Bluesky handle without a leading @.
min 1 chars
Public display name when available.
Avatar image URL when available.
Whether the profile is marked as verified.
Engagement metrics when available.
Like count when available.
≥ 0
Repost count when available.
≥ 0
Reply count when available.
≥ 0
Quote count when available.
≥ 0
Embed when present.
Normalized embed kind.
one of: external, images, video, record, unknown
External link card when kind is external.
Linked page URL.
min 1 chars
Link card title when available.
Link card description when available.
Link card thumbnail URL when available.
Images when kind is images.
Image URL.
min 1 chars
Alt text when available.
Video details when kind is video.
Playable video URL when available.
Video thumbnail URL when available.
Alt text when available.
Quoted record when kind is record.
Quoted or referenced post URI.
min 1 chars
Content id when available.
Pagination state for the current response.
Opaque cursor for the next page, or null when there is no next page.
Whether another page of results is available.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/bluesky/profiles/espn.com/posts" \
-H "x-api-key: YOUR_API_KEY"Responses
Bluesky profile posts page.