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 information related to Instagram posts. Specifically, the "Get Likes" operation under the "Post" resource fetches a list of users who have liked a particular Instagram post.

Common scenarios where this node is beneficial include:

  • Analyzing engagement on specific Instagram posts by retrieving the list of users who liked them.
  • Building marketing or social media analytics workflows that require detailed interaction data.
  • Monitoring popular posts and their audience interactions for influencer marketing or brand management.

For example, you can input an Instagram post ID and get up to 100 users who liked that post, which can then be used for further processing or reporting.

Properties

Name Meaning
Post ID The unique identifier of the Instagram post to retrieve likes for. Example: 3676612811870810696_1777543238
Count Maximum number of likes to return. Defaults to 100.
Timeout Timeout in seconds for the API request, ranging from 20 to 1500 seconds. Default is 300.

Output

The output is a JSON array where each item represents a user who liked the specified Instagram post. Each JSON object contains details about a single like, typically including user information such as username, user ID, and possibly other metadata provided by the API.

No binary data is returned by this operation.

Example output structure (simplified):

[
  {
    "userId": "123456789",
    "username": "example_user",
    "fullName": "Example User",
    "profilePictureUrl": "https://instagram.com/..."
  },
  ...
]

Dependencies

  • Requires an API key credential for authentication with the Horizon Data Wave Instagram API.
  • The node makes HTTP POST requests to the endpoint https://api.horizondatawave.ai/api/instagram/post/likes.
  • The API key must be configured in n8n credentials to allow authenticated requests.
  • Network connectivity to the external API endpoint is required.

Troubleshooting

  • Timeouts: If the API request times out, consider increasing the "Timeout" property within the allowed range (20-1500 seconds).
  • Invalid Post ID: Providing an incorrect or malformed Instagram post ID will result in an error response from the API.
  • API Rate Limits: Excessive requests may lead to rate limiting; monitor token points or request limits if available.
  • Authentication Errors: Ensure the API key credential is correctly set up and has necessary permissions.
  • Error Messages: The node captures detailed error information including HTTP status, API error messages, request IDs, execution time, and token points. These details help diagnose issues such as invalid parameters or server errors.

If the node is set to continue on failure, errors are returned in the output JSON with fields like error, details, httpStatus, and others for easier debugging.

Links and References

Discussion