Skip to main content
GET
/
wf
/
facebook-account-mentions
cURL
curl --request GET \
  --url https://riona.ai/api/1.1/wf/facebook-account-mentions \
  --header 'Authorization: Bearer <token>'
{
  "status": {
    "code": 200,
    "message": "OK"
  },
  "posts": [
    {
      "postDetails": {
        "postID": "131143736925036_1252341852923402",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_FB:131143736925036_131143736925036_1252341852923402?time=1749262035",
        "videoLink": "https://www.facebook.com/768351471322445/videos/618556937716348",
        "postUrl": "https://www.facebook.com/768351471322445/videos/618556937716348",
        "dataId": "131143736925036_131143736925036_1252341852923402",
        "date": "13-03-2025",
        "dateISO": "2025-03-13T14:07:16.000Z",
        "likes": 3956,
        "dislikes": 0,
        "comments": 31,
        "rePosts": 67,
        "views": 242390,
        "pollVotes": 0,
        "videoViews": 0,
        "type": "video",
        "types": [
          "video",
          "text_medium",
          "text_hashtag"
        ],
        "hashTags": [
          "throwback",
          "MUFC",
          "ManUtdFoundation"
        ],
        "text": "Sir Alex, Cristiano Ronaldo and Rio Ferdinand  😎\n\nToday we celebrate our 18th anniversary, so why would we not #throwback to the star-studded line-up that launched our charity ❤️ 🤩\n\n#MUFC | #ManUtdFoundation",
        "textLength": 209,
        "fromOwner": true,
        "isAd": true,
        "mentions": [
          {
            "name": "Cristiano Ronaldo",
            "url": "https://www.facebook.com/Cristiano",
            "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/FB:81221197163?time=1756203719",
            "Followers": 171308444
          },
          {
            "name": "Rio Ferdinand",
            "url": "https://www.facebook.com/RioFerdinandOfficial",
            "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/FB:219643781416878?time=1752096532",
            "Followers": 10010915
          }
        ],
        "mentionsText": [
          "",
          ""
        ]
      },
      "postStats": {
        "interactions": 4054,
        "er": 0.00145922870368371,
        "viewsER": 0.0167251124221296,
        "videoViewsER": 0,
        "indexGrade": 0,
        "mainGrade": "a_plus"
      }
    },
    {
      "postDetails": {
        "postID": "131143736925036_1252395509584703",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_FB:131143736925036_131143736925036_1252395509584703?time=1749262035",
        "videoLink": "https://www.facebook.com/768351471322445/videos/1375837956944556",
        "postUrl": "https://www.facebook.com/768351471322445/videos/1375837956944556",
        "dataId": "131143736925036_131143736925036_1252395509584703",
        "date": "13-03-2025",
        "dateISO": "2025-03-13T15:32:54.000Z",
        "likes": 58663,
        "dislikes": 0,
        "comments": 396,
        "rePosts": 965,
        "views": 845226,
        "pollVotes": 0,
        "videoViews": 0,
        "type": "video",
        "types": [
          "video",
          "text_medium",
          "text_hashtag"
        ],
        "hashTags": [
          "Ronaldo",
          "ManUtdFoundation"
        ],
        "text": "18 years ago today 🔄\n\nA rocket from #Ronaldo in the game that launched the Foundation 🚀\n\nCristiano Ronaldo | #ManUtdFoundation",
        "textLength": 128,
        "fromOwner": true,
        "isAd": true,
        "mentions": [
          {
            "name": "Cristiano Ronaldo",
            "url": "https://www.facebook.com/Cristiano",
            "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/FB:81221197163?time=1756203719",
            "Followers": 171308444
          }
        ],
        "mentionsText": [
          ""
        ]
      },
      "postStats": {
        "interactions": 60024,
        "er": 0.0216055115219316,
        "viewsER": 0.071015326078469,
        "videoViewsER": 0,
        "indexGrade": 0,
        "mainGrade": "a_plus"
      }
    },
    {
      "postDetails": {
        "postID": "129522783836191_1103756545127676",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_FB:129522783836191_129522783836191_1103756545127676?time=1745433026",
        "videoLink": "",
        "postUrl": "https://www.facebook.com/643891337780868/posts/1103756545127676",
        "dataId": "129522783836191_129522783836191_1103756545127676",
        "date": "23-03-2025",
        "dateISO": "2025-03-23T19:01:16.000Z",
        "likes": 404,
        "dislikes": 0,
        "comments": 10,
        "rePosts": 0,
        "views": 450518,
        "pollVotes": 0,
        "videoViews": 0,
        "type": "photo",
        "types": [
          "photo",
          "text_small"
        ],
        "hashTags": [],
        "text": "🚨⚠️ Cristiano Ronaldo has sent a warning - and is ready to fight!",
        "textLength": 66,
        "fromOwner": true,
        "isAd": true,
        "mentions": [
          {
            "name": "Cristiano Ronaldo",
            "url": "https://www.facebook.com/Cristiano",
            "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/FB:81221197163?time=1756203719",
            "Followers": 171308444
          }
        ],
        "mentionsText": [
          ""
        ]
      },
      "postStats": {
        "interactions": 414,
        "er": 0.0000667990815933033,
        "viewsER": 0.000918942195428374,
        "videoViewsER": 0,
        "indexGrade": 0,
        "mainGrade": "a_plus"
      }
    }
  ]
}

{
  "status": {
    "code": 200,
    "message": "OK"
  },
  "posts": [
    {
      "postDetails": {
        "postID": "131143736925036_1252341852923402",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_FB:131143736925036_131143736925036_1252341852923402?time=1749262035",
        "videoLink": "https://www.facebook.com/768351471322445/videos/618556937716348",
        "postUrl": "https://www.facebook.com/768351471322445/videos/618556937716348",
        "dataId": "131143736925036_131143736925036_1252341852923402",
        "date": "13-03-2025",
        "dateISO": "2025-03-13T14:07:16.000Z",
        "likes": 3956,
        "dislikes": 0,
        "comments": 31,
        "rePosts": 67,
        "views": 242390,
        "pollVotes": 0,
        "videoViews": 0,
        "type": "video",
        "types": [
          "video",
          "text_medium",
          "text_hashtag"
        ],
        "hashTags": [
          "throwback",
          "MUFC",
          "ManUtdFoundation"
        ],
        "text": "Sir Alex, Cristiano Ronaldo and Rio Ferdinand  😎\n\nToday we celebrate our 18th anniversary, so why would we not #throwback to the star-studded line-up that launched our charity ❤️ 🤩\n\n#MUFC | #ManUtdFoundation",
        "textLength": 209,
        "fromOwner": true,
        "isAd": true,
        "mentions": [
          {
            "name": "Cristiano Ronaldo",
            "url": "https://www.facebook.com/Cristiano",
            "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/FB:81221197163?time=1756203719",
            "Followers": 171308444
          },
          {
            "name": "Rio Ferdinand",
            "url": "https://www.facebook.com/RioFerdinandOfficial",
            "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/FB:219643781416878?time=1752096532",
            "Followers": 10010915
          }
        ],
        "mentionsText": [
          "",
          ""
        ]
      },
      "postStats": {
        "interactions": 4054,
        "er": 0.00145922870368371,
        "viewsER": 0.0167251124221296,
        "videoViewsER": 0,
        "indexGrade": 0,
        "mainGrade": "a_plus"
      }
    },
    {
      "postDetails": {
        "postID": "131143736925036_1252395509584703",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_FB:131143736925036_131143736925036_1252395509584703?time=1749262035",
        "videoLink": "https://www.facebook.com/768351471322445/videos/1375837956944556",
        "postUrl": "https://www.facebook.com/768351471322445/videos/1375837956944556",
        "dataId": "131143736925036_131143736925036_1252395509584703",
        "date": "13-03-2025",
        "dateISO": "2025-03-13T15:32:54.000Z",
        "likes": 58663,
        "dislikes": 0,
        "comments": 396,
        "rePosts": 965,
        "views": 845226,
        "pollVotes": 0,
        "videoViews": 0,
        "type": "video",
        "types": [
          "video",
          "text_medium",
          "text_hashtag"
        ],
        "hashTags": [
          "Ronaldo",
          "ManUtdFoundation"
        ],
        "text": "18 years ago today 🔄\n\nA rocket from #Ronaldo in the game that launched the Foundation 🚀\n\nCristiano Ronaldo | #ManUtdFoundation",
        "textLength": 128,
        "fromOwner": true,
        "isAd": true,
        "mentions": [
          {
            "name": "Cristiano Ronaldo",
            "url": "https://www.facebook.com/Cristiano",
            "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/FB:81221197163?time=1756203719",
            "Followers": 171308444
          }
        ],
        "mentionsText": [
          ""
        ]
      },
      "postStats": {
        "interactions": 60024,
        "er": 0.0216055115219316,
        "viewsER": 0.071015326078469,
        "videoViewsER": 0,
        "indexGrade": 0,
        "mainGrade": "a_plus"
      }
    },
    {
      "postDetails": {
        "postID": "129522783836191_1103756545127676",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_FB:129522783836191_129522783836191_1103756545127676?time=1745433026",
        "videoLink": "",
        "postUrl": "https://www.facebook.com/643891337780868/posts/1103756545127676",
        "dataId": "129522783836191_129522783836191_1103756545127676",
        "date": "23-03-2025",
        "dateISO": "2025-03-23T19:01:16.000Z",
        "likes": 404,
        "dislikes": 0,
        "comments": 10,
        "rePosts": 0,
        "views": 450518,
        "pollVotes": 0,
        "videoViews": 0,
        "type": "photo",
        "types": [
          "photo",
          "text_small"
        ],
        "hashTags": [],
        "text": "🚨⚠️ Cristiano Ronaldo has sent a warning - and is ready to fight!",
        "textLength": 66,
        "fromOwner": true,
        "isAd": true,
        "mentions": [
          {
            "name": "Cristiano Ronaldo",
            "url": "https://www.facebook.com/Cristiano",
            "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/FB:81221197163?time=1756203719",
            "Followers": 171308444
          }
        ],
        "mentionsText": [
          ""
        ]
      },
      "postStats": {
        "interactions": 414,
        "er": 0.0000667990815933033,
        "viewsER": 0.000918942195428374,
        "videoViewsER": 0,
        "indexGrade": 0,
        "mainGrade": "a_plus"
      }
    }
  ]
}

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