Sign in
Ad Accounts

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.

get/v1/ads/instagram-posts

Query parameters

accountIdstring required

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.

limitinteger

Number of posts to return per page.

afterstring

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

Response

Instagram posts available to boost.

igUserIdstring required

Instagram identity the posts belong to.

usernamestring required

Instagram username; empty when Meta does not expose it.

Changes

Changed in 2 of the 55 revisions of this API.13

  • 2c04683ce69412See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 339f59df69dd1See the full diff
    • ○

      endpoint added

      endpoint-added