# Bluesky Post History Lookup by Time Range

> Bluesky Post History Lookup by Time Range is a paid API for AI agents from api.naco.li, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Retrieves Bluesky posts from a specific author within a given time window, including engagement metrics like likes, reposts, quotes, and replies.

## Facts

- Endpoint: POST https://api.naco.li/v1/getPostsInTime
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bluesky-post-history-lookup-by-time-range-9fca9ab7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gdZKrBoJe88UXA7ntkx3D

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-post-history-lookup-by-time-range-9fca9ab7 -d '<json body>'
```

Example prompt: Pull the last 20 posts from the Bluesky account @nym.bsky.social between January 1st and January 31st 2025 and show me the content along with likes and reposts.

## When to prefer this

Use this endpoint when you need to retrieve historical Bluesky posts from a specific user within a defined time range, especially in autonomous agent workflows that require paying per call via the x402 protocol. It is ideal for social listening, research, content auditing, or analytics tasks on the Bluesky/AT Protocol network. Prefer this over scraping or building custom AT Protocol clients when you want a simple REST interface with structured engagement data.

## Known failure modes

- Author handle not found or does not exist on Bluesky — likely returns empty posts array or error
- Invalid date/time format for startTime or endTime — may result in a 400 error
- Limit exceeds API maximum — may be capped or rejected
- No posts in the requested time window — returns null or empty array for posts
- Rate limiting or payment failure via x402 — request rejected with payment-required response

## 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 post objects. Each post includes the text content, creation timestamp, and engagement metrics: number of likes, reposts, quotes, and replies. The posts array may be null if no posts are found in the time range.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "author",
  "posts"
 ],
 "properties": {
  "posts": {
   "type": [
    "null",
    "array"
   ],
   "items": {
    "type": [
     "null",
     "object"
    ],
    "required": [
     "content",
     "likes",
     "reposts",
     "quotes",
     "replies",
     "createdAt"
    ],
    "properties": {
     "likes": {
      "type": "integer"
     },
     "author": {
      "type": "string"
     },
     "quotes": {
      "type": "integer"
     },
     "content": {
      "type": "string"
     },
     "replies": {
      "type": "integer"
     },
     "reposts": {
      "type": "integer"
     },
     "createdAt": {
      "type": "string"
     }
    },
    "additionalProperties": false
   }
  },
  "author": {
   "type": "string"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bluesky-post-history-lookup-by-time-range-9fca9ab7/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)