Get Page Posts

This endpoint is used to get page posts from facebook and instagram. You can use this posts to create boost post ads.

POST /meta/get_page_posts

Get Page Posts

cURL

curl --request POST \
  --url https://public.plai.io/meta/get_page_posts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "userId": "<string>",
  "platform": "<string>",
  "pagination": "<string>"
}
'

200 (Facebook)

{
    "success": true,
    "results": {
        "success": true,
        "posts": [
            {
                "id": "337703969429296_122169622310329585",
                "createdTime": "2025-04-15T19:47:40+0000",
                "postUrl": "https://www.facebook.com/reel/465694996566136/",
                "mediaType": "video",
                "primaryText": "#trend #sensations",
                "image": "https://scontent-dfw5-3.xx.fbcdn.net/v/t51.71878-10/487045751_1506048210352677_1460106608139613669_n.jpg?stp=dst-jpg_s720x720_tt6&_nc_cat=109&ccb=1-7&_nc_sid=282d23&_nc_ohc=ltdfzNvKXjgQ7kNvwGfsR5B&_nc_oc=Adn5uL-JBf2W_4feDYpOuc8TtAZdjb6jUSlYkXtZQMfmIYl8jVX1NJx9Of2ofvoN_8h4U4Qiwo4v7UQC6DDRr1hg&_nc_zt=23&_nc_ht=scontent-dfw5-3.xx&edm=AKK4YLsEAAAA&_nc_gid=-kNdEWOVvJgyLYvvE6hG8A&oh=00_AfGeuAqiWfYDlxBGGDpV0TS6JAFnorAimRT6dFwwazhX7A&oe=6813667F",
                "height": 720,
                "width": 406,
                "video": "https://scontent-dfw5-3.xx.fbcdn.net/o1/v/t2/f2/m69/AQNZXVm7EVuCjtwEaGQ-F2u5WZRO0lmiQcvNTaetnRD6ryfyhnR30uBV1Jm9Lgyb-ES3v0VdW_We5G3RmcgJWXxZ.mp4?strext=1&_nc_cat=108&_nc_sid=8bf8fe&_nc_ht=scontent-dfw5-3.xx.fbcdn.net&_nc_ohc=iuKuKOO4sPkQ7kNvwF_1PGG&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLnByb2dyZXNzaXZlX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjoxMDY2NDg5MDA4NjU0OTkxLCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MzAsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_zt=28&oh=00_AfHa25qHjWo7n33umOEfOfxK1e8likNXDSyCRuZuvDhT-A&oe=6813874A",
                "videoId": "465694996566136"
            }
        ]
    }
}

Request Body

userId · string · required

User ID, If not already created, make a user on create user page first. If already created, retrieve the user ID from get profile page.

platform · string · required

The social media platform for the operation. FACEBOOK or INSTAGRAM.

pagination · string

Pagination

Response

Facebook Response

success · boolean

Indicates that the HTTP response was successful (status code 200 OK).

results · object

Show Results Object

success · boolean

Indicates whether the specific operation or API action was successful.

posts · object[]

Show Posts Array

id · string

The unique identifier for the post.

createdTime · string

The timestamp when the post was created (ISO 8601 format).

postUrl · string

The URL to view the post on Facebook.

mediaType · string

The type of media in the post : photo or video or album

primaryText · string

The main text/content of the post including hashtags.

image · string

URL of the thumbnail/preview image for the post.

height · number

Height of the post media in pixels.

width · number

Width of the post media in pixels.

video · string

URL of the video content (if mediaType is VIDEO).

videoId · string

The unique identifier for the video.

error · string

Error string if something went wrong

Instagram Response

success · boolean

Indicates that the HTTP response was successful (status code 200 OK).

results · object

Show Results Object

success · boolean

Indicates whether the specific operation or API action was successful.

posts · object[]

Show Post Object

id · string

The unique identifier for the Instagram post.

caption · string

The caption text of the post.

media_type · string

Type of media in the post: VIDEO or IMAGE or CAROUSEL_ALBUM

thumbnail_url · string

URL of the thumbnail image for the post.

permalink · string

Permanent URL to access the post on Instagram.

timestamp · string

When the post was created (ISO 8601 format).

ig_id · string

Instagram’s internal ID for the post.

boost_eligibility_info · object

Show Boost Eligibility Info

eligible_to_boost · boolean

Whether the post is eligible for boosting/promotion.

media_product_type · string

The type of Instagram media product (e.g., REELS).

error · string

Error string if something went wrong

200 (Facebook)

{
    "success": true,
    "results": {
        "success": true,
        "posts": [
            {
                "id": "337703969429296_122169622310329585",
                "createdTime": "2025-04-15T19:47:40+0000",
                "postUrl": "https://www.facebook.com/reel/465694996566136/",
                "mediaType": "video",
                "primaryText": "#trend #sensations",
                "image": "https://scontent-dfw5-3.xx.fbcdn.net/v/t51.71878-10/487045751_1506048210352677_1460106608139613669_n.jpg?stp=dst-jpg_s720x720_tt6&_nc_cat=109&ccb=1-7&_nc_sid=282d23&_nc_ohc=ltdfzNvKXjgQ7kNvwGfsR5B&_nc_oc=Adn5uL-JBf2W_4feDYpOuc8TtAZdjb6jUSlYkXtZQMfmIYl8jVX1NJx9Of2ofvoN_8h4U4Qiwo4v7UQC6DDRr1hg&_nc_zt=23&_nc_ht=scontent-dfw5-3.xx&edm=AKK4YLsEAAAA&_nc_gid=-kNdEWOVvJgyLYvvE6hG8A&oh=00_AfGeuAqiWfYDlxBGGDpV0TS6JAFnorAimRT6dFwwazhX7A&oe=6813667F",
                "height": 720,
                "width": 406,
                "video": "https://scontent-dfw5-3.xx.fbcdn.net/o1/v/t2/f2/m69/AQNZXVm7EVuCjtwEaGQ-F2u5WZRO0lmiQcvNTaetnRD6ryfyhnR30uBV1Jm9Lgyb-ES3v0VdW_We5G3RmcgJWXxZ.mp4?strext=1&_nc_cat=108&_nc_sid=8bf8fe&_nc_ht=scontent-dfw5-3.xx.fbcdn.net&_nc_ohc=iuKuKOO4sPkQ7kNvwF_1PGG&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLnByb2dyZXNzaXZlX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjoxMDY2NDg5MDA4NjU0OTkxLCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MzAsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_zt=28&oh=00_AfHa25qHjWo7n33umOEfOfxK1e8likNXDSyCRuZuvDhT-A&oe=6813874A",
                "videoId": "465694996566136"
            }
        ]
    }
}