Instagram Private API icon

Instagram Private API

Interact with Instagram using private API methods

Overview

This node integrates with Instagram's private API to perform various actions related to Instagram media. Specifically, the Get Media Info operation retrieves detailed information about a specific Instagram media item using its media ID.

Common scenarios where this node is useful include:

  • Fetching metadata and details (like captions, comments count, likes count, media type) of a particular Instagram post.
  • Integrating Instagram media data into workflows for analytics, reporting, or content management.
  • Automating social media monitoring by retrieving up-to-date info on posts.

For example, you can use this node to input an Instagram media ID and get back comprehensive details about that post, which can then be used downstream in your automation workflow.

Properties

Name Meaning
Media ID Instagram media ID (string). The unique identifier of the Instagram media item to retrieve information about. This property is required for the Get Media Info operation.

Output

The node outputs JSON data representing the detailed information of the specified Instagram media item. The structure typically includes fields such as:

  • Media metadata (e.g., caption text, creation timestamp)
  • User information related to the media
  • Engagement metrics (likes, comments count)
  • Media type (image, video, carousel)
  • URLs or identifiers for the media content

If the operation succeeds, the output JSON array contains one object per input item with the media details.

No binary data output is produced by this operation.

Dependencies

  • Requires an Instagram API authentication credential (an API key or token) configured in n8n.
  • Uses Instagram private API client library internally to authenticate and fetch data.
  • The node attempts to reuse saved session data if available; otherwise, it authenticates using provided credentials.
  • No additional external services are needed beyond Instagram's private API access.

Troubleshooting

  • Authentication failures: If the node throws an error like Instagram authentication failed, verify that the Instagram API credentials are correct and have not expired. Ensure the account is active and accessible.
  • Invalid Media ID: Providing an incorrect or malformed media ID will result in errors or empty responses. Double-check the media ID format.
  • Rate limits or API restrictions: Instagram may limit requests or block access if too many calls are made in a short time. Implement delays or reduce request frequency if encountering rate limit errors.
  • Operation not supported: If the node reports the operation is unsupported for the resource, confirm that the selected Resource is "Media" and Operation is "Get Media Info".
  • Continue On Fail: If enabled, the node will continue processing other items even if one fails, returning error details in the output JSON.

Links and References

Discussion