Get Instagram Page Media

This endpoint is used to fetch media assets (both images and videos) associated with a user’s Instagram Page. It provides access to the creative library that can be used in ad campaigns, allowing users to browse and select previously uploaded media for their advertisements.

POST /meta/get_ig_page_media

Get Instagram Page Media

cURL

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

200

{
  "success": true,
  "results": {
    "success": true,
    "media": [
      {
        "id": "<string>",
        "caption": "<string>",
        "media_type": "<string>",
        "media_url": "<string>",
        "permalink": "<string>",
        "timestamp": "<string>",
        "ig_id": "<string>",
        "boost_eligibility_info": {
          "eligible_to_boost": true
        },
        "media_product_type": "<string>"
      }
    ],
    "error": "<string>"
  }
}

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.

pagination · string · default: ""

If the number of results exceeds the page limit, the response will include pagination links (next and previous) to help you navigate through the result set

Response

success · boolean

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

results · object

Show Media Results

success · boolean

Indicates whether the specific operation or API action was successful.

media · object[]

Show Media Items

id · string

Unique Instagram media ID

caption · string

Post caption text

media_type · string

Type of media content : IMAGE or VIDEO or CAROUSEL_ALBUM

media_url · string

Direct URL to the media file

permalink · string

Permanent link to the Instagram post

timestamp · string

When the media was published

ig_id · string

Instagram’s internal ID for the media

boost_eligibility_info · object

Show Boost Eligibility

eligible_to_boost · boolean

Whether the post can be boosted as an ad

media_product_type · string

Placement type of the media : FEED or STORY or REELS

error · string

Error string if something went wrong