Instagram Collaborator API

Instagram recently introduced a feature that enables users to co-author posts by tagging others as collaborators. This update allows you to designate other Instagram users as creators of your posts. If tagged, these users receive an invitation to participate. If they accept, the post will appear in their feed and be visible to their followers, expanding the post’s reach and engagement potential.

Meta also adds the ability to add participants via an API, which we call the “Participation API”. When you create a new Instagram post using the Instagram API, you can tag up to three social usernames.

New features allow:

• Invites Participants: Users can send invitations via the Instagram API to other Instagram users to become contributors to a post.
• Participant Acceptance Status: The Instagram API provides the ability to check whether the invited participant has accepted the request, ensuring transparency and ease of communication.

How Partnerships Work

If you want to add a list of participants just type in Instagram usernames in the program.

Here is an example of a POST call to publish an image with participants using the API.

POST graph.facebook.com/{page_id}/media
?image_url=
&caption=#BronzedFonzes!
&collaborators= [‘username1’,’username2’]

Also using the Ayrshare social API collaborator field, here’s an example in JavaScript:

{
    "post": "#BronzedFonzes!",
    "platforms": "instagram",
    "mediaUrls": [""],
    "instagramOptions": {
        "collaborators": ["username1", "username2"]
    }
}

After publishing, Instagram users receive a message asking if they want to accept the invitation.

After they accept, the photo will appear in their feed and be shown to their followers.

Unfortunately, Stories cannot have editors, but Reels can add contributors.

Finding Acceptance Status

If you want to know if the user has accepted the invitation to join, there is an editor status endpoint that returns the status of the invitation.

GET 

which returns the JSON state:

{
  "data": [
    {
      "id": "90010775360791",
      "username": "realtest1",
      "invite_status": "Accepted"
    },
    {
      "id": "17841449208283139",
      "username": "realtest2",
      "invite_status": "Pending"
    },
    {
      "id": "90011117049518",
      "username": "realtest3",
      "invite_status": "Declined"
    }
  ]
}

or using the Ayrshare social media API:

GET 

where i :id the original post id. Returning JSON:

{
    "collaborators": [
        {
            "id": "17841401319910272",
            "username": "ayrshare",
            "inviteStatus": "accepted"
        }
    ],
    "lastUpdated": "2024-03-08T04:08:18.979Z",
    "nextUpdate": "2024-03-08T04:09:18.979Z"
}

A New Way to Create Content Together

The Instagram Collaborator API is a new addition to Instagram’s suite of digital tools, designed to make social media post collaboration easier and more efficient. Using this API, users can invite other Instagram users to be contributors to their posts. This feature benefits not only influencers and brands who often collaborate with others but also any users who want to co-create content with friends, family, or colleagues.

For developers and users interested in using this feature, detailed documentation and guidelines are available on the official Ayrshare documentation page.