Fetch Actor Timeline
fetch-timelineRead-only
Retrieve recent posts from any fediverse actor by handle, with cursor and ID-based pagination for browsing.
Instructions
Fetch recent posts (the outbox) from any fediverse actor — a user or account — with cursor- and ID-based pagination. Pass a handle like 'alice@mastodon.social'.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| identifier | Yes | Actor identifier (e.g., user@example.social) | |
| limit | No | Number of posts to fetch (default: 20) | |
| cursor | No | Pagination cursor from previous response to fetch next page | |
| minId | No | Return posts newer than this post ID (pagination) | |
| maxId | No | Return posts older than this post ID (pagination) | |
| sinceId | No | Return posts more recent than this post ID |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| posts | Yes | ||
| nextCursor | No | Opaque cursor for the next page, if more results | |
| hasMore | No | ||
| source | No | Account/actor/instance the posts came from |