Skip to main content
GET
/
wf
/
instagram-account-mentions
cURL
curl --request GET \
  --url https://riona.ai/api/1.1/wf/instagram-account-mentions \
  --header 'Authorization: Bearer <token>'
{
  "status": {
    "code": 200,
    "message": "OK"
  },
  "posts": [
    {
      "postDetails": {
        "socialPostID": "67fe375d8283972027a44681",
        "postID": "18045023591193396",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_INST:17841401492096261_18045023591193396?time=1744713565",
        "videoLink": "https://scontent-hel3-1.cdninstagram.com/o1/v/t16/f2/m86/AQNeUYoWvasb0l32LZmVkVGIcXy4f-Crjd99gqzfVZFXQuxs0SbIqd6WrE7goaBeDA7FPLKCsIvp_IttDO2uiHd0l07WUr80WBvvYq4.mp4?efg=eyJ2ZW5jb2RlX3RhZyI6InZ0c192b2RfdXJsZ2VuLmNsaXBzLnVua25vd24tQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSJ9&_nc_ht=scontent-hel3-1.cdninstagram.com&edm=AL-3X8kEAAAA&_nc_gid=7PVQnBUrnZIyIo-93Ske6A&_nc_cat=101&_nc_oc=Admd4n7sRZoa7ZNRwpuj6WAQUAp0LgXKmOxUGVDmrv0l_FUsjzbF4At861Hewf1sIzg&vs=592553056874969_3603806940&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC82RTQzODgzNEQ2RjdBNjY4NzRGMzE2MTMzN0E4NzlBMF92aWRlb19kYXNoaW5pdC5tcDQVAALIAQAVAhg6cGFzc3Rocm91Z2hfZXZlcnN0b3JlL0dCQkFSeHpkYjUtczhSRUNBSVdhR1VYdFJSaG1icV9FQUFBRhUCAsgBACgAGAAbAYgHdXNlX29pbAExFQAAJvLAg6fOve4%2FFQIoAkMzLBdAOZmZmZmZmhgSZGFzaF9iYXNlbGluZV8xX3YxEQB1AAA%3D&ccb=9-4&oh=00_AfGhhPDUaGxK9-Z6IYBY_JtqdmKSl5vBCutVqVbICE7Peg&oe=68000DA7&_nc_sid=1d576d",
        "postUrl": "https://www.instagram.com/reel/DFDMu6qptNs/",
        "dataId": "17841401492096261_18045023591193396",
        "date": "20-01-2025",
        "dateISO": "2025-01-20T14:03:38.000Z",
        "likes": 10339,
        "dislikes": 0,
        "comments": 172,
        "rePosts": 0,
        "views": 1154064,
        "pollVotes": 0,
        "videoViews": 218557,
        "type": "REELS",
        "types": [
          "text_small",
          "REELS"
        ],
        "hashTags": [],
        "text": "He looks buzzing with the outcome 🤣⁠\n⁠\n🎥: therock",
        "textLength": 51,
        "fromOwner": true,
        "isAd": true,
        "mentions": [
          {
            "name": "Dwayne Johnson",
            "url": "https://instagram.com/therock",
            "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/INST:17841400005463628?time=1755784592",
            "Followers": 392700476
          }
        ],
        "mentionsText": [
          "therock"
        ]
      },
      "postStats": {
        "interactions": 10511,
        "er": 0.00073167020308425,
        "viewsER": 0.00910781377809203,
        "videoViewsER": 0.0480927172316604,
        "indexGrade": 0,
        "mainGrade": "a_plus"
      }
    },
    {
      "postDetails": {
        "socialPostID": "681934bf8283972027abaa4b",
        "postID": "18037763771637301",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_INST:17841400899574041_18037763771637301?time=1754871198",
        "videoLink": "",
        "postUrl": "https://www.instagram.com/p/DJKMt22OZHY/",
        "dataId": "17841400899574041_18037763771637301",
        "date": "02-05-2025",
        "dateISO": "2025-05-02T20:45:28.000Z",
        "likes": 394,
        "dislikes": 0,
        "comments": 5,
        "rePosts": 0,
        "views": 414798,
        "pollVotes": 0,
        "videoViews": 0,
        "type": "carousel_album",
        "types": [
          "text_medium",
          "carousel_album"
        ],
        "hashTags": [],
        "text": "Happy 53rd Birthday to therock! It has been a pleasure watching his journey from iconic wrestler to Hollywood superstar!",
        "textLength": 120,
        "fromOwner": true,
        "isAd": true,
        "mentions": [
          {
            "name": "Dwayne Johnson",
            "url": "https://instagram.com/therock",
            "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/INST:17841400005463628?time=1755784592",
            "Followers": 392700476
          }
        ],
        "mentionsText": [
          "therock"
        ]
      },
      "postStats": {
        "interactions": 399,
        "er": 0.0000704437959142598,
        "viewsER": 0.000961913991870742,
        "videoViewsER": 0,
        "indexGrade": 0,
        "mainGrade": "a_plus"
      }
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 1,
    "currentResults": 2,
    "totalCount": 2,
    "remaining": 0,
    "hasNextPage": false
  }
}

{
  "status": {
    "code": 200,
    "message": "OK"
  },
  "posts": [
    {
      "postDetails": {
        "socialPostID": "67fe375d8283972027a44681",
        "postID": "18045023591193396",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_INST:17841401492096261_18045023591193396?time=1744713565",
        "videoLink": "https://scontent-hel3-1.cdninstagram.com/o1/v/t16/f2/m86/AQNeUYoWvasb0l32LZmVkVGIcXy4f-Crjd99gqzfVZFXQuxs0SbIqd6WrE7goaBeDA7FPLKCsIvp_IttDO2uiHd0l07WUr80WBvvYq4.mp4?efg=eyJ2ZW5jb2RlX3RhZyI6InZ0c192b2RfdXJsZ2VuLmNsaXBzLnVua25vd24tQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSJ9&_nc_ht=scontent-hel3-1.cdninstagram.com&edm=AL-3X8kEAAAA&_nc_gid=7PVQnBUrnZIyIo-93Ske6A&_nc_cat=101&_nc_oc=Admd4n7sRZoa7ZNRwpuj6WAQUAp0LgXKmOxUGVDmrv0l_FUsjzbF4At861Hewf1sIzg&vs=592553056874969_3603806940&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC82RTQzODgzNEQ2RjdBNjY4NzRGMzE2MTMzN0E4NzlBMF92aWRlb19kYXNoaW5pdC5tcDQVAALIAQAVAhg6cGFzc3Rocm91Z2hfZXZlcnN0b3JlL0dCQkFSeHpkYjUtczhSRUNBSVdhR1VYdFJSaG1icV9FQUFBRhUCAsgBACgAGAAbAYgHdXNlX29pbAExFQAAJvLAg6fOve4%2FFQIoAkMzLBdAOZmZmZmZmhgSZGFzaF9iYXNlbGluZV8xX3YxEQB1AAA%3D&ccb=9-4&oh=00_AfGhhPDUaGxK9-Z6IYBY_JtqdmKSl5vBCutVqVbICE7Peg&oe=68000DA7&_nc_sid=1d576d",
        "postUrl": "https://www.instagram.com/reel/DFDMu6qptNs/",
        "dataId": "17841401492096261_18045023591193396",
        "date": "20-01-2025",
        "dateISO": "2025-01-20T14:03:38.000Z",
        "likes": 10339,
        "dislikes": 0,
        "comments": 172,
        "rePosts": 0,
        "views": 1154064,
        "pollVotes": 0,
        "videoViews": 218557,
        "type": "REELS",
        "types": [
          "text_small",
          "REELS"
        ],
        "hashTags": [],
        "text": "He looks buzzing with the outcome 🤣⁠\n⁠\n🎥: therock",
        "textLength": 51,
        "fromOwner": true,
        "isAd": true,
        "mentions": [
          {
            "name": "Dwayne Johnson",
            "url": "https://instagram.com/therock",
            "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/INST:17841400005463628?time=1755784592",
            "Followers": 392700476
          }
        ],
        "mentionsText": [
          "therock"
        ]
      },
      "postStats": {
        "interactions": 10511,
        "er": 0.00073167020308425,
        "viewsER": 0.00910781377809203,
        "videoViewsER": 0.0480927172316604,
        "indexGrade": 0,
        "mainGrade": "a_plus"
      }
    },
    {
      "postDetails": {
        "socialPostID": "681934bf8283972027abaa4b",
        "postID": "18037763771637301",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_INST:17841400899574041_18037763771637301?time=1754871198",
        "videoLink": "",
        "postUrl": "https://www.instagram.com/p/DJKMt22OZHY/",
        "dataId": "17841400899574041_18037763771637301",
        "date": "02-05-2025",
        "dateISO": "2025-05-02T20:45:28.000Z",
        "likes": 394,
        "dislikes": 0,
        "comments": 5,
        "rePosts": 0,
        "views": 414798,
        "pollVotes": 0,
        "videoViews": 0,
        "type": "carousel_album",
        "types": [
          "text_medium",
          "carousel_album"
        ],
        "hashTags": [],
        "text": "Happy 53rd Birthday to therock! It has been a pleasure watching his journey from iconic wrestler to Hollywood superstar!",
        "textLength": 120,
        "fromOwner": true,
        "isAd": true,
        "mentions": [
          {
            "name": "Dwayne Johnson",
            "url": "https://instagram.com/therock",
            "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/INST:17841400005463628?time=1755784592",
            "Followers": 392700476
          }
        ],
        "mentionsText": [
          "therock"
        ]
      },
      "postStats": {
        "interactions": 399,
        "er": 0.0000704437959142598,
        "viewsER": 0.000961913991870742,
        "videoViewsER": 0,
        "indexGrade": 0,
        "mainGrade": "a_plus"
      }
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 1,
    "currentResults": 2,
    "totalCount": 2,
    "remaining": 0,
    "hasNextPage": false
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
id
string
required

masterID: the id of the Social Account, to get this you need to call the endpoint Get Profile by URL OR Get User Account

​
month
string
required
  • Understanding Post Data Handling
  • If you are planning to use Get Post Details, you can check what months already being tracked first Check Tracked Posts
  • 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.
​
includeProfile
boolean
default:false

If you would like to include Profile details, set this to true

​
api_key
string
required

This is your account API Key. You can easily locate it in your account dashboard.

Response

200

OK