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 various types of Instagram data. Specifically, for the User resource and Get Reels operation, it fetches Instagram reels posted by a specified user. This is useful for social media analysts, marketers, or developers who want to programmatically access Instagram reels content from a particular user for monitoring trends, content aggregation, or analytics.

Practical examples:

  • Automatically collect the latest reels from an influencer's Instagram account to analyze engagement.
  • Aggregate reels from multiple users for a marketing campaign dashboard.
  • Monitor competitor reels content regularly without manual checking.

Properties

Name Meaning
User Instagram username, user ID, or URL identifying the target Instagram user.
Count Maximum number of reels to return (default 12).
Timeout Timeout in seconds for the API request; must be between 20 and 1500 seconds (default 300).

Output

The node outputs JSON data representing the reels retrieved from the specified Instagram user. The output structure corresponds directly to the API response from the Horizon Data Wave Instagram endpoint /api/instagram/user/reels. Each item in the output array represents one reel with its associated metadata (e.g., reel ID, caption, media URLs, timestamps).

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authentication with the Horizon Data Wave Instagram API.
  • The base URL for API requests is https://api.horizondatawave.ai.
  • The node uses HTTP POST requests to interact with the API endpoints.
  • Proper configuration of the API key credential within n8n is necessary for successful requests.

Troubleshooting

  • Common issues:

    • Invalid or missing Instagram username/user ID/URL will cause the API to return errors.
    • Exceeding the allowed timeout range (less than 20 or more than 1500 seconds) may result in request failures.
    • Network connectivity problems or incorrect API credentials will prevent successful data retrieval.

  • Error messages:

    • Errors returned from the API include HTTP status codes and may contain detailed error messages in headers or response body.
    • Typical error details are included in the node output when "Continue On Fail" is enabled, showing HTTP status, API error message, request ID, execution time, and token usage.
    • To resolve errors, verify the correctness of input parameters, ensure valid API credentials, and check network connectivity.

Links and References

Discussion