# Bluesky Engagement Metrics API (x402)

> Bluesky Engagement Metrics API (x402) is a paid API for AI agents from api.naco.li, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-14).

Retrieves per-post engagement metrics (likes, reposts, replies, quotes, engagement rate) for a given Bluesky author over a specified time range.

## Facts

- Endpoint: POST https://api.naco.li/v1/getEngagementMetrics
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bluesky-engagement-metrics-api-x402-ad19772a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HJ0FoCn8iuJEzNwZIQ1sV

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-engagement-metrics-api-x402-ad19772a -d '<json body>'
```

Example prompt: Pull the engagement metrics for the Bluesky author @nntaleb.bsky.social — I want likes, reposts, replies, quotes, and engagement rate for their last 20 posts from January 1 to March 31 2025.

## When to prefer this

Choose this endpoint when you need per-post Bluesky engagement metrics (likes, reposts, replies, quotes, engagement rate) for a specific author, especially when operating as an autonomous agent that can handle x402 micropayment flows. It is purpose-built for the Bluesky / AT Protocol ecosystem and returns structured per-post data, making it ideal for analytics, benchmarking, or campaign monitoring workflows rather than generic social listening tools.

## Known failure modes

- Author handle not found or does not exist on Bluesky — metrics array returns null
- Invalid or unparseable startTime/endTime format — likely a 400 or malformed response
- Limit set to 0 or negative — may return empty results
- Payment not completed (x402) — request blocked before processing
- Platform field set to unsupported value — undefined behavior or empty result

## How this service works

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

## Output

Returns a JSON object containing the author handle and an array of per-post metric objects. Each object includes the postId, timestamp, likes, reposts, replies, quotes, and a computed engagementRate (float). The metrics array may be null if no posts are found for the given parameters.

## 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",
  "metrics",
  "twitterPostCount"
 ],
 "properties": {
  "author": {
   "type": "string"
  },
  "metrics": {
   "type": [
    "null",
    "array"
   ],
   "items": {
    "type": "object",
    "required": [
     "postId",
     "timestamp",
     "likes",
     "reposts",
     "replies",
     "quotes",
     "engagementRate"
    ],
    "properties": {
     "likes": {
      "type": "integer"
     },
     "postId": {
      "type": "string"
     },
     "quotes": {
      "type": "integer"
     },
     "replies": {
      "type": "integer"
     },
     "reposts": {
      "type": "integer"
     },
     "timestamp": {
      "type": "string"
     },
     "engagementRate": {
      "type": "number"
     }
    },
    "additionalProperties": false
   }
  },
  "twitterPostCount": {
   "type": "integer"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bluesky-engagement-metrics-api-x402-ad19772a/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)