All endpoints
Bluesky User Likes

Bluesky User Likes API

Get the posts a Bluesky user has liked, newest first. Returns the full post for each like plus liked_at, the time the user liked it.

Price: $0.003 per page
Free tier: 50 requests/month
Get API Key Documentation
Endpoint
GET /v1/bluesky/user/likes

Parameters

username
Bluesky handle, e.g. bsky.app, with or without leading @, or the account's DID (max 100 characters). Provide either username or url.
url
Bluesky profile URL, e.g. https://bsky.app/profile/bsky.app (max 500 characters). Provide either username or url.
pages
Number of pages to fetch, 1-20 (default: 1). Each page returns up to 50 posts; you are billed per page returned.
get_sentiment
Set to true to add AI emotion analysis (Plutchik's Wheel) to each result. Adds +$0.001 per page to the cost. Returns emotion scores, dominant emotion, intensity, and polarity.

Response fields

posts
Array of liked posts, most recently liked first
title
Post title (format: @handle on Bluesky)
url
Direct link to the post
date
Publication date and time (UTC, YYYY-MM-DD HH:MM:SS)
author
Author's Bluesky handle
author_name
Author's display name
author_id
Author's DID (permanent account ID)
author_verified
Whether the author is verified
source
"Bluesky"
domain
"bsky.app"
snippet
Post text
likes
Number of likes
replies
Number of replies
reposts
Number of reposts
quotes
Number of quote posts
bookmarks
Number of bookmarks
lang
Post language code (e.g. en), empty when not set
is_reply
Whether the post is a reply
in_reply_to_id
post_id of the post replied to (empty when not a reply)
is_quote
Whether the post quotes another post
quoted_post
The quoted post (post_id, url, date, author, author_name, author_verified, snippet, likes, reposts), or null
hashtags
Hashtags used in the post
mentions
Handles mentioned in the post
links
URLs linked in the post text
link_preview
Link card for posts sharing a URL (url, title, description, image_url), or null
media_type
text, image, video, or carousel
image_url
Full-size image URL for image posts, the thumbnail for video posts, empty for text-only
video_url
Video playlist URL (HLS) for video posts, empty otherwise
carousel_media
Images of a multi-image post (image_url, thumbnail_url, alt, width, height); empty otherwise
post_id
The post's AT URI (pass it as post_id to the post endpoints)
liked_at
When the user liked the post
sentiment
Emotion analysis: emotions, dominant_emotion, emotional_intensity, polarity (when get_sentiment=true)
username
The requested handle or DID
pages
Number of pages returned
count
Number of results returned

Example Request

curl "https://apidirect.io/v1/bluesky/user/likes?username=pfrazee.com&pages=1"   -H "X-API-Key: YOUR_API_KEY"

Example Response

{
  "posts": [
    {
      "title": "@cthomasjamh.bsky.social on Bluesky",
      "url": "https://bsky.app/profile/cthomasjamh.bsky.social/post/3mvnh4tvkfc2j",
      "date": "2026-09-16 15:25:06",
      "author": "cthomasjamh.bsky.social",
      "author_name": "Charlie Thomas",
      "author_id": "did:plc:he2lkvdpuq3vnsnludc2r5im",
      "author_verified": false,
      "source": "Bluesky",
      "domain": "bsky.app",
      "snippet": "I am actually going to start trying to use Sankey diagrams in every briefing I do from now on while watching the reactions of the audience like a hawk…",
      "likes": 22,
      "replies": 1,
      "reposts": 4,
      "quotes": 1,
      "bookmarks": 0,
      "lang": "en",
      "is_reply": false,
      "in_reply_to_id": "",
      "is_quote": true,
      "quoted_post": {
        "post_id": "at://did:plc:ragtjsm2j2vknwkz3zp4oxrd/app.bsky.feed.post/3mvm4gtzkgk2f",
        "url": "https://bsky.app/profile/pfrazee.com/post/3mvm4gtzkgk2f",
        "date": "2026-09-16 02:41:11",
        "author": "pfrazee.com",
        "author_name": "P(aul) Frazee",
        "author_verified": true,
        "snippet": "I’m gonna need a moratorium on sankey diagrams",
        "likes": 311,
        "reposts": 17
      },
      "hashtags": [],
      "mentions": [],
      "links": [],
      "link_preview": null,
      "media_type": "text",
      "image_url": "",
      "video_url": "",
      "carousel_media": [],
      "post_id": "at://did:plc:he2lkvdpuq3vnsnludc2r5im/app.bsky.feed.post/3mvnh4tvkfc2j",
      "liked_at": "2026-09-16 16:43:04"
    }
  ],
  "username": "pfrazee.com",
  "pages": 1,
  "count": 50
}

Frequently asked questions

Are likes public on Bluesky?

Yes. Every account's likes are part of its public data on the network, which is what this endpoint reads.

Why can a page hold fewer than 50 posts?

A liked post that has since been deleted or hidden cannot be returned, so it is skipped. You are still billed per page returned, never for skipped posts.

How does pricing work?

You only pay for successful requests. The Bluesky User Likes API costs $0.003 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 10 simultaneous requests per endpoint per user. If you need more, just get in touch.

Start using the Bluesky User Likes API

Get your API key and start making requests in minutes. 50 requests/month free every month.

Get API Key