SOCRadar icon

SOCRadar

Comprehensive SOCRadar API integration
Join our community

Actions21

Overview

This node integrates with the SOCRadar API to perform various cybersecurity-related operations. Specifically, for the Takedown resource and the Get Progress operation, it retrieves the current progress status of a takedown request associated with a company. This is useful in scenarios where organizations want to monitor the status of their reported takedown requests for malicious or infringing content.

Practical examples include:

  • Tracking the resolution status of a takedown request submitted to remove harmful content.
  • Automating alerts or workflows based on the progress of takedown actions.
  • Integrating takedown progress data into security dashboards or incident response systems.

Properties

Name Meaning
Company ID The unique identifier of the company for which the takedown progress is being requested.
Takedown ID The unique identifier of the specific takedown request whose progress is to be retrieved.

Output

The node outputs JSON data representing the progress details of the specified takedown request. This typically includes status information, timestamps, and any relevant metadata returned by the SOCRadar API about the takedown's current state.

If the node encounters an error during execution (e.g., invalid IDs or API issues), the output JSON will contain an error field with the error message and possibly additional details.

The node does not output binary data.

Dependencies

  • Requires an active SOCRadar API key credential configured in n8n.
  • The node makes HTTP requests to the SOCRadar API base URL using this API key.
  • Proper network connectivity to the SOCRadar service is necessary.

Troubleshooting

  • Common Issues:

    • Invalid or missing Company ID or Takedown ID parameters will cause errors.
    • Expired or incorrect API key credentials will result in authentication failures.
    • Network connectivity problems can prevent successful API calls.

  • Error Messages:

    • Errors from the SOCRadar API are captured and included in the output under an error field.
    • If the node is set to continue on failure, it returns error details per item; otherwise, it throws exceptions stopping execution.

  • Resolution Tips:

    • Verify that the Company ID and Takedown ID are correct and correspond to existing records.
    • Ensure the API key credential is valid and has appropriate permissions.
    • Check network access and firewall settings to allow outbound requests to the SOCRadar API.

Links and References

Discussion