Zernio
Zernio
API Reference

Accounts & Ops

Accounts

List ad accountsGETCreate Meta ad accountPOSTUpdate ad account settingsPATCHAd account financesGET

Activity

Ad account change / audit logGETList comments on an adGETReply to an ad commentPOSTHide or unhide an ad commentPOSTDelete an ad commentDELETE

Business Assets

Businesses listGETList TikTok Business CentersGETAd labelsGETA/B tests and lift studiesGETList Instagram ad identitiesGETList advertisable appsGETGet iOS 14 campaign limitsGETList TikTok ad pixelsGET

Extension Assets

List account calloutsGETAdd account calloutsPOSTUpdate account calloutsPUTRemove account calloutDELETEList account sitelinksGETAdd account sitelinksPOSTUpdate account sitelinksPUTRemove account sitelinkDELETEList account snippetsGETAdd account snippetsPOSTUpdate account snippetsPUTRemove account snippetDELETE

Negative Keyword Lists

List negative keyword listsGETCreate a negative keyword listPOSTGet a negative keyword listGETRename a negative keyword listPUTDelete a negative keyword listDELETEReplace negative list keywordsPUT

Custom Conversions

List custom conversionsGETCreate custom conversionPOST

Value Rules

List value rule setsGETCreate a value rule setPOSTRead a value rule setGETReplace a value rule setPUTDelete a value rule setDELETE

Budget Scheduling

List high-demand periodsGETSchedule a budget increasePOST

DSA Compliance

Get ad account DSA defaultsGETGet DSA recommendationsGET

Other

List Instagram posts to boostGET
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Accounts & Ops

List Instagram posts to boost

Lists the media of the Instagram account this Meta connection can reach, so an existing Instagram post can be boosted 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. When no identity is reachable the endpoint fails instead of returning an empty list, and the two causes stay apart: 403 reconnect_required means the connection predates Instagram access (Meta then omits instagram_business_account from the Page read rather than erroring, so it looks identical to having no data) and the account must be reconnected granting Instagram access, while 422 instagram_business_account_unresolved means the Page genuinely has no Instagram professional account linked.

PlatformsMeta
GET
/v1/ads/instagram-posts

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Query Parameters

accountId*string

Zernio Meta Ads, Facebook or Instagram SocialAccount ID.

adAccountId?string

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

Match^act_[0-9]+$
igUserId?string

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

limit?integer

Number of posts to return per page.

Range1 <= value <= 100
Default25
after?string

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

Response Body

application/json

application/json

application/json

application/json

application/json

{  "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..."  }}
Was this page helpful?

Get DSA recommendations

Returns Meta's suggested beneficiary/payor names for an ad account, derived by Meta from the account's recent activity. Useful for prefilling `dsaBeneficiary`/`dsaPayor` inputs, or the defaults sent to `PATCH /v1/ads/accounts`, in your own UI. Meta returns a single flat list. Entries are not labeled as beneficiary or payor, and since these are legal disclosures Zernio never applies them automatically: let your user pick the right entity. The list may be empty for accounts with little activity. Meta accounts only.

List accounts it is shared with

Meta only (platform `metaads`); other platforms return 405.