Skip to main content
GET
/
posts
Get Posts
curl --request GET \
  --url https://our-secret-api-url.com/posts
{
  "data": [
    {
      "id": 123,
      "userId": 123,
      "snowflakeId": "<string>",
      "user": {
        "id": 123,
        "username": "<string>",
        "name": "<string>",
        "image": "<string>",
        "bio": "<string>",
        "verifiedAt": "2023-11-07T05:31:56Z",
        "role": "user",
        "tags": [
          "<string>"
        ]
      },
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "type": "post",
      "content": "<string>",
      "reposts": [
        123
      ],
      "repostsCount": 123,
      "repliesCount": 123,
      "originalId": 123,
      "parentId": 123,
      "hashtags": [
        "<string>"
      ],
      "media": [
        {
          "id": 123,
          "updatedAt": "2023-11-07T05:31:56Z",
          "postId": 123,
          "mediaUrl": "<string>",
          "mimeType": "<string>"
        }
      ],
      "isSuspended": true,
      "links": [
        {
          "url": "<string>",
          "title": "<string>",
          "description": "<string>",
          "image": "<string>"
        }
      ],
      "parent": "<unknown>"
    }
  ],
  "totalPages": 123
}
Use query string or #hashtag to show posts that contains query term.
For user’s profile feed, use the userId to show posts by the users.
For a specific list feed, use tagged accounts’ userId to show posts by the tagged accounts. Eg news feed, use news accounts’ userIds

Users By Tag API

Get userIds of tagged users

Query Parameters

​
cursor
integer

Cursor for pagination (last ID of the page)

​
size
integer
default:10

Number of posts to fetch

​
query
string

Search query to filter posts

​
userIds
string

Comma-separated list of user IDs to filter posts

Response

A list of posts

​
data
object[]
​
totalPages
integer