HDW Instagram icon

HDW Instagram

Integrate with Horizon Data Wave Instagram API
Join our community

Actions8

Overview

The node integrates with the Horizon Data Wave Instagram API to perform searches for Instagram posts based on a user-defined query. Specifically, the "Search Posts" operation allows users to search Instagram posts by providing a search query string and specifying how many results to return. This is useful for scenarios such as social media monitoring, brand reputation management, or content discovery where you want to find recent or relevant Instagram posts matching certain keywords or topics.

For example, a marketing team could use this node to search for posts mentioning their brand name or product to analyze customer sentiment or gather user-generated content.

Properties

Name Meaning
Search Query The text query used to search Instagram posts (e.g., keywords like "Intel").
Count Maximum number of posts to return from the search results (default is 20).
Timeout Timeout in seconds for the API request; must be between 20 and 1500 seconds (default 300).

Output

  • The output is an array of JSON objects, each representing an Instagram post that matches the search query.
  • Each item in the output corresponds to one post returned by the API.
  • The exact structure of each post object depends on the API response but typically includes details such as post ID, caption, author, timestamp, and other metadata.
  • The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating 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/search/posts with JSON payload containing the query, count, and timeout parameters.
  • Proper configuration of the API authentication credential within n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing API authentication token will cause authentication errors.
    • Providing an empty or invalid search query may result in no results or API errors.
    • Setting the timeout outside the allowed range (20-1500 seconds) might cause request failures.
    • Network connectivity issues can lead to request timeouts or failures.

  • Error messages:

    • Errors include HTTP status codes and may contain headers with additional error information such as x-error, x-request-id, and x-execution-time.
    • The node captures detailed error info and includes it in the output if "Continue On Fail" is enabled.
    • To resolve errors, verify API credentials, ensure valid input parameters, and check network connectivity.

Links and References

Discussion