HDW Instagram icon

HDW Instagram

Integrate with Horizon Data Wave Instagram API
Join our community

Actions8

Overview

This node integrates with the Horizon Data Wave Instagram API to retrieve Instagram user friendship data, specifically followers or following lists. It is useful for scenarios where you want to analyze or monitor an Instagram user's social connections, such as gathering follower information for marketing analysis, influencer tracking, or social media research.

For example, you can use this node to:

  • Get a list of followers of a specific Instagram user.
  • Retrieve the accounts that a user is following.
  • Limit the number of friendships returned to manage data volume.

Properties

Name Meaning
User Instagram username, user ID, or URL of the target user whose friendships are retrieved.
Friendship Type Type of friendship to retrieve: either "Followers" (users who follow the target) or "Following" (users the target follows).
Count Maximum number of friendships to return (e.g., limit to 50).
Timeout Timeout in seconds for the API request; valid range is 20 to 1500 seconds.

Output

The output is a JSON array where each item represents a single friendship entry (a follower or following user). The exact structure depends on the API response but typically includes details about each related Instagram user.

If multiple friendships are returned, each will be an individual JSON object in the output array.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Horizon Data Wave Instagram API.
  • The node sends POST requests to https://api.horizondatawave.ai/api/instagram/user/friendships.
  • The API expects parameters including user identifier, count, friendship type, and timeout.
  • Proper configuration of the API authentication credential within n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing user identifier may cause errors or empty results.
    • Request timeouts if the timeout parameter is set too low or network issues occur.
    • Exceeding API rate limits could result in HTTP error responses.

  • Error messages:

    • Errors include HTTP status codes and may contain headers like x-error describing the issue.
    • Response body may provide additional details.
    • If the node is configured to continue on failure, error details are included in the output JSON under an error field.

  • Resolutions:

    • Verify the correctness of the Instagram username, user ID, or URL.
    • Increase the timeout value if requests frequently time out.
    • Ensure the API key credential is valid and has sufficient permissions.
    • Handle rate limiting by adding delays between requests or reducing the count parameter.

Links and References

Discussion