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 Posts operation, it fetches posts made by a specified Instagram user. This is useful for scenarios such as social media monitoring, content analysis, or gathering recent posts from influencers or competitors.

For example, you can use this node to:

  • Retrieve the latest 12 posts from a public Instagram user like "cristiano".
  • Collect posts for sentiment analysis or marketing insights.
  • Aggregate posts for display in dashboards or reports.

Properties

Name Meaning
User Instagram username, user ID, or URL identifying the target user whose posts are fetched.
Count Maximum number of posts to return.
Timeout Timeout in seconds for the API request (range: 20-1500 seconds).

Output

The output is an array of JSON objects, each representing an individual Instagram post retrieved from the specified user. Each item contains the post's details as returned by the Horizon Data Wave Instagram API. The exact structure depends on the API response but typically includes fields such as post ID, caption, media URLs, timestamps, and engagement metrics.

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 the endpoint /api/instagram/user/posts with parameters including user identifier, count, and timeout.

Troubleshooting

  • Timeouts: If the request times out, consider increasing the Timeout property within the allowed range (20-1500 seconds).
  • Invalid User: Providing an incorrect or private Instagram username/ID may result in errors or empty results.
  • API Errors: The node surfaces detailed error information including HTTP status, API error messages, request IDs, and execution time when available. Common issues include rate limiting or invalid credentials.
  • Rate Limits: Excessive requests might be throttled; respect API usage limits and consider adding delays between calls if processing multiple inputs.
  • Authentication Failures: Ensure the API key credential is correctly configured and has necessary permissions.

Links and References

Discussion