Skip to main content

Fetch Posts

This section covers how to fetch posts from the Subsocial blockchain.

Find and load a single post​

api.findPost(query: FindPostQuery): Promise<PostData | undefined

Example:

api.findPost({ id: '1' })

Output: 

{
    "id": "1",
    "struct": {
        "createdByAccount": "3osmnRNnrcScHsgkTJH1xyBF5kGjpbWHsGrqM31BJpy4vwn8",
        "createdAtBlock": 658170,
        "createdAtTime": 1600870242000,
        "isUpdated": false,
        "contentId": "bafyreidzue2dtxpj6n4x5mktrt7las5wz5diqma47zr25uau743dhe76we",
        "id": "1",
        "ownerId": "3osmnRNnrcScHsgkTJH1xyBF5kGjpbWHsGrqM31BJpy4vwn8",
        "hidden": false,
        "spaceId": "1",
        "repliesCount": 12,
        "hiddenRepliesCount": 0,
        "visibleRepliesCount": 12,
        "sharesCount": 0,
        "upvotesCount": 29,
        "downvotesCount": 0,
        "score": 835,
        "isRegularPost": true,
        "isSharedPost": false,
        "isComment": false
    },
    "content": {
        "body": "Subsocial is an open protocol for decentralized social networks and marketplaces. It's built with [Substrate](https://www.substrate.io/) and [IPFS](https://ipfs.io/).",
        "image": "QmcWWpR176oFao49jrLHUoH3R9MCziE5d77fdD8qdoiinx",
        "tags": [
            "Hello World",
            "FAQ"
        ],
        "title": "What is Subsocial?",
        "summary": "Subsocial is an open protocol for decentralized social networks and marketplaces. It's built with Substrate and IPFS.",
        "isShowMore": false
    }
}

🆃 findPost(query: FindPostQuery): Promise<PostData | undefined>


Find and load an array of posts​

Find and load an array of information about public posts from the Subsocial blockchain and IPFS by a given array of post ids.

A post is considered public if it meets these conditions:

  • The hidden field on its blockchain structure is false.
  • And there is a corresponding JSON file that represents the post's content on IPFS.
api.findPublicPosts(ids: AnyId[]): Promise<PostData[]>

Read API docs here

Find and load structs and contents separately​

Get structs​

api.findPostStructs(ids: AnyId[]): Promise<PostStruct[]>
api.findPostStruct(id: AnyId): Promise<PostStruct | undefined>

Example: 

api.findPostStruct('1')

Output: 

{
  "createdByAccount": "3osmnRNnrcScHsgkTJH1xyBF5kGjpbWHsGrqM31BJpy4vwn8",
  "createdAtBlock": 658170,
  "createdAtTime": 1600870242000,
  "isUpdated": false,
  "contentId": "bafyreidzue2dtxpj6n4x5mktrt7las5wz5diqma47zr25uau743dhe76we",
  "id": "1",
  "ownerId": "3osmnRNnrcScHsgkTJH1xyBF5kGjpbWHsGrqM31BJpy4vwn8",
  "hidden": false,
  "spaceId": "1",
  "repliesCount": 12,
  "hiddenRepliesCount": 0,
  "visibleRepliesCount": 12,
  "sharesCount": 0,
  "upvotesCount": 29,
  "downvotesCount": 0,
  "score": 835,
  "isRegularPost": true,
  "isSharedPost": false,
  "isComment": false
}

Find and load post IDs by space ID​

api.blockchain.postIdsBySpaceId(id: AnySpaceId): Promise<PostId[]>

Example:

api.blockchain.postIdsBySpaceId('1')

Read API docs here