> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riona.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Posts & Videos

> Get the feed, posts and videos of any social profile.

<Check>Supported Platforms:  <Icon icon="youtube" size={20} />  <Icon icon="tiktok" size={20} />  <Icon icon="instagram" size={20} />  <Icon icon="facebook" size={20} />  <Icon icon="x-twitter" size={20} />  <Icon icon="telegram" size={20} /></Check>

<ResponseExample>
  ```json 200 theme={null}
  {
      "status": {
      "code": 200,
      "message": "OK"
  	},

  "about": {
  "type": "posts",
  "period": "Aug 2025"
  },
  "posts": [

  {
    "postDetails": {
          "postID": "7535822781108194582",
          "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_TT:127905465618821121_7535822781108194582?time=1760016121",
          "videoLink": "https://v16-webapp-prime.tiktok.com/video/tos/no1a/tos-no1a-ve-0068c001-no/oIolenxnIqJKBaOEQEIUEFAngRFwIkfspgSD7E/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2822&bt=1411&cs=0&ds=3&ft=-Csk_mgdPD12NACEwh-Ux7N2hY3W3wv25BcAp&mime_type=video_mp4&qs=0&rc=PDw1Zzw2aWY7NDs2ZDg5NEBpanI3b205cms8NTMzbzczNUAuXzMwLmFeXi4xNC1iLjZgYSNmbmVnMmQ0cV5hLS1kMTFzcw%3D%3D&btag=e000b8000&expire=1760188945&l=20251009132200EF2F52587F9646227AD2&ply_type=2&policy=2&signature=3bd178c95569874d9e2a2c08017e17ca&tk=tt_chain_token",
          "postUrl": "https://www.tiktok.com/@khaby.lame/video/7535822781108194582",
          "dataId": "127905465618821121_7535822781108194582",
          "date": "07-08-2025",
          "dateISO": "2025-08-07T12:41:12.000Z",
          "likes": 375800,
          "dislikes": 0,
          "comments": 7522,
          "rePosts": 6484,
          "views": 8200000,
          "pollVotes": 0,
          "videoViews": 8200000,
          "type": "video",
          "types": [
            "video"
          ],
          "hashTags": [
           "learnfromkhaby","comedy"
          ],
          "text": "Nothing personal 🚶🏿🫶🏾#learnfromkhaby #comedy ",
          "textLength": 49,
          "fromOwner": false,
          "isAd": false,
          "mentions": [

  ],
          "mentionsText": [

  ]
  },
    "postStats": {
          "interactions": 389806,
          "er": 0.00241067408781694,
          "viewsER": 0.0475373170731707,
          "videoViewsER": 0.0475373170731707,
          "indexGrade": -2.18230284655743,
          "mainGrade": "d"
   }
  },{
    "postDetails": {
          "postID": "7538431890357865750",
          "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_TT:127905465618821121_7538431890357865750?time=1760016121",
          "videoLink": "https://v16-webapp-prime.tiktok.com/video/tos/no1a/tos-no1a-ve-0068c001-no/oYZBYFadADV7FaxtBCiBdJ7jIQQS53lEEPiWw/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=1788&bt=894&cs=0&ds=3&ft=-Csk_mgdPD12NACEwh-Ux7N2hY3W3wv25BcAp&mime_type=video_mp4&qs=0&rc=PDc6aDY0ZTc0Z2Y8OjhpNUBpanVvb2s5cmp4NTMzbzczNUAuX2NgMl9fX18xMDI2YV9iYSMuLmBqMmQ0NGJhLS1kMTFzcw%3D%3D&btag=e00088000&expire=1760188966&l=20251009132200EF2F52587F9646227AD2&ply_type=2&policy=2&signature=df5135eeec0cfc65bd548e3d4e1efeb1&tk=tt_chain_token",
          "postUrl": "https://www.tiktok.com/@khaby.lame/video/7538431890357865750",
          "dataId": "127905465618821121_7538431890357865750",
          "date": "14-08-2025",
          "dateISO": "2025-08-14T13:25:53.000Z",
          "likes": 528000,
          "dislikes": 0,
          "comments": 14100,
          "rePosts": 12900,
          "views": 15200000,
          "pollVotes": 0,
          "videoViews": 15200000,
          "type": "video",
          "types": [
            "video"
          ],
          "hashTags": [
           "learnfromkhaby","commedy"
          ],
          "text": "👌🏾 perfect #learnfromkhaby #commedy ",
          "textLength": 38,
          "fromOwner": false,
          "isAd": false,
          "mentions": [

  ],
          "mentionsText": [

  ]
  },
    "postStats": {
          "interactions": 555000,
          "er": 0.00343228200371058,
          "viewsER": 0.0365131578947368,
          "videoViewsER": 0.0365131578947368,
          "indexGrade": -1.39154817185109,
          "mainGrade": "c"
   }
  }
       
          ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml api-reference/openapi-3.0.json get /wf/universal-profile-posts
openapi: 3.0.3
info:
  title: Riona API Docs
  version: 1.0.0
  contact:
    email: info@riona.ai
    url: https://riona.ai
servers:
  - url: https://riona.ai/api/1.1
security:
  - bearerAuth: []
tags:
  - name: Workflow
    description: Use this to trigger a workflow
  - name: Data
    description: Use this to fetch, modify and delete data
paths:
  /wf/universal-profile-posts:
    get:
      tags:
        - Workflow
      description: Triggers the workflow universal-profile-posts
      operationId: get_wf_universal-profile-posts
      parameters:
        - name: id
          in: query
          required: true
          description: >-
            **masterID**: the id of the Social Account, to get this you need to
            call the endpoint **Get Profile by URL**
          schema:
            type: string
        - name: month
          in: query
          required: true
          description: >-
            - Date Format: **yyyy-mm-dd**

            - Specify the month you want to retrieve.

            - Posts are collected within a one-month period.

            - Enter the first date of the month you want to collect.

            - To collect posts up to yesterday, enter the first date of the
            current month.

            - The more posts a month contains, the longer it will take to return
            the data.
          schema:
            type: string
            default: 2025/08/30
        - name: includeProfile
          in: query
          required: false
          description: If you would like to include Profile details, set this to `true`
          schema:
            type: boolean
            default: false
        - name: type
          in: query
          required: true
          description: |-
            Default: `posts`
            posts will show all feeds and content types.

            Possible options:  `posts` `stories` `REELS` `video` `photo`

            - **posts**, **video**, **photo** : All Platforms
            - **stories**, **REELS** : Instagram
          schema:
            type: string
            default: posts
        - name: api_key
          in: query
          required: true
          description: >-
            This is your account API Key. You can easily locate it in your
            account dashboard.
          schema:
            type: string
      responses:
        '200':
          description: OK
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````