# Bluesky Topic Modeling API

> Bluesky Topic Modeling API is a paid API for AI agents from api.naco.li, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-15).

Analyzes a Bluesky author's posts over a time window and returns topic clusters with labels, keywords, post counts, and sample posts

## Facts

- Endpoint: POST https://api.naco.li/v1/getTopicModeling
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bluesky-topic-modeling-api-5c47aa3c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oC87QYVIiSbpBtCaZXKdG

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability bluesky-topic-modeling-api-5c47aa3c -d '<json body>'
```

Example prompt: What topics does the Bluesky account @bsky.social post about most? Analyze their last 100 posts from January 2025 through March 2025 and break it down by theme.

## When to prefer this

Choose this endpoint when you need to understand the thematic composition of a specific Bluesky user's content over a defined period — especially for competitive intelligence, journalist profiling, influencer analysis, or content auditing on the Bluesky/AT Protocol platform. It is distinct from raw post retrieval because it returns pre-clustered topics with labels and keywords rather than individual posts, saving downstream NLP work.

## Known failure modes

- Author handle not found or misspelled → empty or null topics array
- No posts in the given time window → null topics array
- Insufficient post volume for meaningful clustering → single topic or null
- Invalid date format for startTime/endTime → request error
- Rate limits or payment failure via x402 → 402 Payment Required or 429 response
- Platform parameter unsupported → unexpected behavior or error

## How this service works

Auto-generated REST API matching active Model Context Protocol (MCP) tools.

## Output

Returns a structured object containing the queried author handle and an array of topic clusters. Each cluster includes a topic ID, a human-readable label, an array of keywords characterizing the topic, the count of posts assigned to it, its percentage share of total posts, and a set of sample post texts illustrating the theme. The topics array may be null if no posts are found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "author"
 ],
 "properties": {
  "limit": {
   "type": "integer"
  },
  "author": {
   "type": "string"
  },
  "endTime": {
   "type": "string"
  },
  "platform": {
   "type": "string"
  },
  "startTime": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "author",
  "topics",
  "twitterPostCount"
 ],
 "properties": {
  "author": {
   "type": "string"
  },
  "topics": {
   "type": [
    "null",
    "array"
   ],
   "items": {
    "type": "object",
    "required": [
     "topicId",
     "label",
     "keywords",
     "postCount",
     "percentage",
     "samplePosts"
    ],
    "properties": {
     "label": {
      "type": "string"
     },
     "topicId": {
      "type": "integer"
     },
     "keywords": {
      "type": [
       "null",
       "array"
      ],
      "items": {
       "type": "string"
      }
     },
     "postCount": {
      "type": "integer"
     },
     "percentage": {
      "type": "number"
     },
     "samplePosts": {
      "type": [
       "null",
       "array"
      ],
      "items": {
       "type": "string"
      }
     }
    },
    "additionalProperties": false
   }
  },
  "twitterPostCount": {
   "type": "integer"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bluesky-topic-modeling-api-5c47aa3c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.naco.li](https://www.zero.xyz/host/api.naco.li/llms.txt)