Sign in
Social Accounts

List Social Account Posts

Lists the existing posts of a connected Facebook page, Instagram account, or TikTok account.

get/social_accounts/{id}/posts

Query parameters

account_idstring required

The Account (a biz_ identifier) the social account is connected to.

post_idstring

Return only the single post with this platform id, instead of the full list.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

Response

single post returned when post_id is given

Example response

{
  "data": [
    {
      "call_to_action": "shop_now",
      "caption": "Ceramic coating in action",
      "destination_url": "https://shinetime.example/book",
      "embed_url": "https://www.facebook.com/plugins/post.php",
      "id": "media_1",
      "media_url": "https://shinetime.example/ceramic-coating-reel.mp4",
      "restrictions": [
        "lead_form_ineligible"
      ],
      "thumbnail_url": "https://shinetime.example/ceramic-coating-poster.jpg",
      "video_id": "18000000000000000"
    }
  ],
  "page_info": {
    "end_cursor": "MTI=",
    "has_next_page": true
  }
}

Changes

Changed in 6 of the 74 revisions of this API.157

  • 4fe3b2d215462See the full diff
    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

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

  • 23dfbe1a0d1f3See the full diff
    • ●

      added the new instagram_destination enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new messenger_destination enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new whatsapp_destination enum value to the /// response property for the response status

      response-property-enum-value-added

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

  • 6fb1c04bf2552See the full diff
    • ●

      added the new copyrighted_music enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new promotion_ineligible enum value to the /// response property for the response status

      response-property-enum-value-added

  • f1020c3ecda43See 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

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

  • 099fdc3be4221See the full diff
    • ○

      added the required property // to the response with the status

      response-required-property-added

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

  • 60bbb4a6ffbc11See the full diff
    • ▲

      for the query request parameter first, default value was changed from 25 to 20

      request-parameter-default-value-changed

    • ○

      added the required property // to the response with the status

      response-required-property-added

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

Of the 74 revisions, 1 has no diff computed.