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 Profile operation, it fetches detailed profile information about an Instagram user by their username, user ID, or URL. It optionally includes the account creation date in the response.

Common scenarios where this node is beneficial include:

  • Social media analytics platforms needing to gather Instagram user profile data.
  • Marketing tools that track influencer profiles.
  • Customer engagement systems that personalize interactions based on Instagram user details.

Example use case: Given a username like "cristiano", the node retrieves the public profile information such as follower count, bio, profile picture, and optionally the account creation date.

Properties

Name Meaning
User Instagram username, user ID, or URL to identify the target Instagram account.
With Creation Date Boolean option to include the Instagram account's creation date in the returned profile.
Timeout Timeout duration in seconds for the API request (valid range: 20 to 1500 seconds).

Output

The node outputs JSON data representing the Instagram user's profile information. The structure typically includes fields such as username, full name, biography, follower/following counts, profile picture URL, and optionally the account creation date if requested.

If the API returns multiple items (not typical for Get Profile), each item would be output as a separate JSON object in the 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.
  • The API expects JSON payloads and returns JSON responses.
  • Proper configuration of the API authentication credential within n8n is necessary.

Troubleshooting

  • Timeout issues: If the request times out, consider increasing the "Timeout" property value within the allowed range.
  • Invalid user identifier: Ensure the "User" property contains a valid Instagram username, user ID, or URL.
  • API errors: Errors from the API may include HTTP status codes and error messages. Common causes include invalid credentials, rate limiting, or malformed requests.
  • Error message details: When an error occurs, the node attempts to provide detailed information including HTTP status, API error headers, request ID, execution time, and token usage points to help diagnose issues.
  • Continue on Fail: If enabled, the node will output error details in JSON instead of stopping execution, useful for workflows that need to handle partial failures gracefully.

Links and References

Discussion