# Bluesky Posts by user API (bluesky.user_posts)

- Canonical page: [https://everyinfra.com/en/bluesky-api/user_posts](https://everyinfra.com/en/bluesky-api/user_posts?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "bluesky", "action": "user_posts", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 200 per call
- Mode: sync; add "mode": "async" for slow tasks

Bluesky Posts by user collects the public posts of a single Bluesky account, located by its full handle in `username`. Each row carries the full text, post link, like, repost, quote, comment and bookmark counts, the publish time, flags for replies and reposts, and the hashtags, mentions and external links in the post. Journalists, researchers and social teams use it to follow what an account publishes and how readers react: tracking people and organizations that post on Bluesky, studying which posts travel, or building a dataset for language and network analysis.

The handle must be complete, such as bsky.app or alice.bsky.social, not a display name or a profile link. `hashtags`, `mentions` and `links` are left out of a row when the post has none, so treat a missing key as an empty list. `mentions` lists the handles a post @-mentions, in order, which makes it a ready source for mapping whom the account talks to.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=bluesky&action=user_posts

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| username | not declared | yes | not declared | Specifies a complete Bluesky handle, such as alice.bsky.social or a connected custom domain name. Do not pass a display nickname or a bsky.app/profile/ page URL. The profile, user_posts, followers, and following actions all use this parameter to locate the target account. |
| limit | integer (1–200) | no | 20 | The most rows to return in this call, an integer from 1 to 200. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| author_username | Author's username (@handle), usually usable in URLs. |
| author_name | Author's display name. |
| author_id | Author's unique ID on the platform. |
| author_avatar_url | platform-native meaning |
| lang | platform-native meaning |
| like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| repost_count | Reposts (as distinct from quote posts). null means not disclosed. |
| comment_count | Comments. null means not disclosed, not 0. |
| quote_count | platform-native meaning |
| bookmark_count | platform-native meaning |
| is_reply | platform-native meaning |
| is_repost | platform-native meaning |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| media_urls | platform-native meaning |
| embed_url | platform-native meaning |
| embed_title | platform-native meaning |
| hashtags | Hashtags in the text, in order of appearance; absent when there are none. |
| mentions | platform-native meaning |
| links | platform-native meaning |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "bluesky",
  "action": "user_posts",
  "params": {
    "username": "bsky.app"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "bluesky",
        "action": "user_posts",
        "params": {
            "username": "bsky.app",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-10-24T18:28:34Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "bluesky",
  "action": "user_posts",
  "results": [
    {
      "id": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mykozpeyv22w",
      "url": "https://bsky.app/profile/bsky.app/post/3mykozpeyv22w",
      "text": "this was the exact use case we had in mind while we were building it",
      "author_username": "bsky.app",
      "author_name": "•••",
      "author_id": "•••",
      "author_avatar_url": "https://cdn.bsky.app/•••",
      "lang": "en",
      "like_count": 90,
      "repost_count": 3,
      "comment_count": 4,
      "quote_count": 0,
      "bookmark_count": 0,
      "is_reply": true,
      "is_repost": false,
      "posted_at": "2026-10-23T17:24:06.492000+00:00",
      "platform": "bluesky"
    },
    {
      "id": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3myinmg7his27",
      "url": "https://bsky.app/profile/bsky.app/post/3myinmg7his27",
      "text": "please make sure to get the goat's permission",
      "author_username": "bsky.app",
      "author_name": "•••",
      "author_id": "•••",
      "author_avatar_url": "https://cdn.bsky.app/•••",
      "lang": "en",
      "like_count": 73,
      "repost_count": 2,
      "comment_count": 1,
      "quote_count": 0,
      "bookmark_count": 1,
      "is_reply": true,
      "is_repost": false,
      "posted_at": "2026-10-22T21:53:27.448000+00:00",
      "platform": "bluesky"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### How do I keep only the account's own posts?

Drop rows where `is_repost` is true, which are reposts of other accounts' posts, and drop rows where `is_reply` is true if you want top-level posts without replies. What remains are the posts the account published to start a new thread.

### What is the difference between `quote_count` and `repost_count`?

A repost shares a post unchanged, and `repost_count` counts those. A quote shares it with the quoting account's own comment on top, and `quote_count` counts those. Quotes carry reactions in the quoters' own words, so read them separately when you study how a post was received.

### Is `lang` detected from the text?

No. `lang` is the language the author chose when posting, so it is the author's own label rather than a detection, and it is only as accurate as that choice. Check a sample against `text` before you filter a large dataset on it.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=bluesky
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
