---
title: "This channel's own posts, from the network"
method: GET
path: "/v1/social-accounts/{id}/posts"
tags: ["Channels"]
---

# This channel's own posts, from the network

`GET /v1/social-accounts/{id}/posts`

## Request

- Base URL: `https://api.postlake.dev`
- URL: `https://api.postlake.dev/v1/social-accounts/{id}/posts`
- Auth: `bearerAuth` (a scheme the document does not define)

The account's own posts read live from the network, including ones published outside PostLake. Different from GET /v1/posts, which lists what PostLake itself published: an account with existing history has posts we never sent, and this is how to reach them.

## Path parameters

- `id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Posts

- object
  - `items` DiscoveredPost[], required
    - `id` string
    - `platform` string
    - `author` SocialActor
      - `handle` string
      - `displayName` string, nullable
      - `avatarUrl` string, nullable
      - `id` string, nullable: The network's own id, for follow/block/mute
    - `text` string
    - `createdAt` string, date-time
    - `url` string, nullable
    - `mediaType` 'text' | 'image' | 'video' | 'other': 'other' keeps a new network media type from breaking a parser that switches on this.
    - `isReply` boolean
    - `isQuote` boolean
    - `authorHidden` boolean: True when the network REFUSES to name the author, as opposed to us failing to read it. Instagram hashtag results are the case: Meta rejects the username field on media returned by a tag search, so author.handle is necessarily empty. Treat an empty handle WITHOUT this flag as a bug; with it, as the network's rule.
  - `cursor` string, nullable, required
  - `platform` 'bluesky' | 'threads' | 'x' | 'linkedin' | 'instagram' | 'tiktok' | 'facebook' | 'youtube' | 'pinterest', required

---

[API](https://skmtc.dev/postlake/apis/postlake-api.md) · [All operations](https://skmtc.dev/postlake/apis/postlake-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postlake/apis/postlake-api/revisions/f81060e31f69?raw)