# Bluesky Author Sentiment Trends API

> Bluesky Author Sentiment Trends API 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-15).

Analyzes and returns time-series sentiment trends for a given Bluesky author, including dominant emotions and sentiment shifts over a specified period.

## Facts

- Endpoint: POST https://api.naco.li/v1/getSentimentTrends
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bluesky-author-sentiment-trends-api-a876ab28
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2vdcQHn5ki034TnjuW8Vo

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-author-sentiment-trends-api-a876ab28 -d '<json body>'
```

Example prompt: Pull the sentiment trends for the Bluesky account @pfrazee.com from January 1 2025 to March 31 2025, give me up to 50 data points, and highlight any major sentiment shifts.

## When to prefer this

Choose this endpoint when you need time-series sentiment analysis specifically for a named Bluesky author, including emotion breakdown and shift detection. Prefer it over generic social listening tools when working within the AT Protocol / Bluesky ecosystem, or when you need structured sentiment timelines rather than raw post data.

## Known failure modes

- Author not found or handle invalid — likely returns an error or empty result
- No posts in the specified time range — timeSeries and sentimentShifts may return null
- Platform value not supported — may return an error
- Rate limiting or payment failure (x402) — HTTP 402 if USDC payment not processed
- Very large limit values may slow response or be capped silently

## 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; a time-series array of timestamped sentiment scores (positive, negative, neutral) with post counts; an overall aggregate sentiment breakdown; an array of dominant emotions with scores; and an array of sentiment shift events indicating when and how dramatically the author's tone changed.

## 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",
  "timeSeries",
  "overallSentiment",
  "dominantEmotions",
  "sentimentShifts",
  "twitterPostCount"
 ],
 "properties": {
  "author": {
   "type": "string"
  },
  "timeSeries": {
   "type": [
    "null",
    "array"
   ],
   "items": {
    "type": "object",
    "required": [
     "timestamp",
     "positive",
     "negative",
     "neutral",
     "postCount"
    ],
    "properties": {
     "neutral": {
      "type": "number"
     },
     "negative": {
      "type": "number"
     },
     "positive": {
      "type": "number"
     },
     "postCount": {
      "type": "integer"
     },
     "timestamp": {
      "type": "string"
     }
    },
    "additionalProperties": false
   }
  },
  "sentimentShifts": {
   "type": [
    "null",
    "array"
   ],
   "items": {
    "type": "object",
    "required": [
     "timestamp",
     "fromSentiment",
     "toSentiment",
     "magnitude"
    ],
    "properties": {
     "magnitude": {
      "type": "number"
     },
     "timestamp": {
      "type": "string"
     },
     "toSentiment": {
      "type": "string"
     },
     "fromSentiment": {
      "type": "string"
     }
    },
    "additionalProperties": false
   }
  },
  "dominantEmotions": {
   "type": [
    "null",
    "array"
   ],
   "items": {
    "type": "object",
    "required": [
     "emotion",
     "score"
    ],
    "properties": {
     "score": {
      "type": "number"
     },
     "emotion": {
      "type": "string"
     }
    },
    "additionalProperties": false
   }
  },
  "overallSentiment": {
   "type": "object",
   "required": [
    "positive",
    "negative",
    "neutral"
   ],
   "properties": {
    "neutral": {
     "type": "number"
    },
    "negative": {
     "type": "number"
    },
    "positive": {
     "type": "number"
    }
   },
   "additionalProperties": false
  },
  "twitterPostCount": {
   "type": "integer"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bluesky-author-sentiment-trends-api-a876ab28/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)