OverviewProductsPlatformsAPI ReferenceResources
Accounts & Ops

List Instagram posts to boost

GEThttps://zernio.com/api/v1/ads/instagram-posts

Lists posts from the Instagram account a Meta ad connection can reach, so you can boost one as an ad.

An existing Instagram post can be boosted this way without connecting the Instagram account separately. Each posts[].id is the existing-post id to send as platformPostId when creating the ad; Meta turns it into source_instagram_media_id on the creative.

Identity resolution reuses the same resolver as /v1/ads/instagram-accounts. igUserId is always checked against the identities the connection can reach and is never trusted as sent.

PlatformsMeta

Authentication

AuthorizationBearer tokenRequired

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

Query parameters

accountIdstringRequired

Zernio Meta Ads, Facebook or Instagram SocialAccount ID.

adAccountIdstring

Meta ad account ID including the act_ prefix. Narrows identity resolution to the Instagram accounts reachable from this ad account.

igUserIdstring

Instagram identity to list. Must be one this connection can reach, otherwise the request is rejected with a 400.

limitintegerDefault 25

Number of posts to return per page.

afterstring

Opaque Meta cursor from a previous response's paging.after.

Responses

Success· the request worked

Errors· the request failed

How it behaves

When no identity is reachable

The endpoint fails instead of returning an empty list, and the two causes stay apart:

  • 403 reconnect_required: the connection predates Instagram access, and the account must be reconnected granting Instagram access. Meta then omits instagram_business_account from the Page read rather than erroring, so it looks identical to having no data.
  • 422 instagram_business_account_unresolved: the Page genuinely has no Instagram professional account linked.
GET/v1/ads/instagram-posts
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adaccounts.listAdsInstagramPosts({  query: {    accountId: 'account_abc123',  },});console.log(data);
{  "igUserId": "17841400000000000",  "username": "example",  "posts": [    {      "id": "18050809559368305",      "caption": "Launch day",      "mediaType": "VIDEO",      "thumbnailUrl": "https://scontent.cdninstagram.com/thumb.jpg",      "permalink": "https://www.instagram.com/reel/ABCdef/",      "timestamp": "2026-09-18T09:00:00+0000"    }  ],  "paging": {    "after": "QVFIUl..."  }}
OpenAPI specification
Was this page helpful?