LINKUPInstall

Overview

This node integrates with the LINKUP API to perform LinkedIn-related automation tasks. Specifically, the Search Companies operation allows users to search for LinkedIn companies based on various criteria such as location, sector, keywords, and company size. This is useful for lead generation, market research, competitive analysis, or recruitment purposes.

Typical use cases include:

• Finding companies in specific geographic locations or industries.
• Filtering companies by size to target startups or large enterprises.
• Retrieving a list of companies matching certain keywords for outreach campaigns.

For example, a user could search for software companies located in France with 51-200 employees to build a targeted marketing list.

Properties

Output

The node outputs JSON data containing the search results from the LINKUP API. The structure includes:

• The main response fields returned by the API representing the list of companies matching the search criteria.
• A _debug object containing:
  • requestBody: The exact request payload sent to the API.
  • apiResponse: The raw response received from the API.
• A _meta object with metadata:
  • operation: The operation performed (searchCompanies).
  • timestamp: ISO timestamp of execution.
  • nodeVersion: Version of the node implementation.

No binary data output is produced by this operation.

Example snippet of output JSON structure:

{
  "_debug": {
    "requestBody": { /* search parameters */ },
    "apiResponse": { /* raw API response */ }
  },
  /* ... actual company search results ... */,
  "_meta": {
    "operation": "searchCompanies",
    "timestamp": "2024-06-xxTxx:xx:xx.xxxZ",
    "nodeVersion": "1.1.0"
  }
}

Dependencies

• Requires an active LINKUP API key credential.
• Requires a valid LinkedIn authentication token (login token) obtained via prior login/verification steps.
• The node uses the LINKUP API endpoint at https://api.linkupapi.com/v1.
• Network access to LINKUP API and LinkedIn services is necessary.
• Optional: Use of custom credentials can override saved credentials.
• Configurable request timeout and retry count.

Troubleshooting

Common Issues

• Invalid or missing credentials: If the API key or LinkedIn login token is incorrect or missing, requests will fail.
• Rate limiting: Exceeding the allowed number of API requests will result in errors.
• Invalid request parameters: Providing malformed or unsupported search filters may cause the API to reject the request.

Error Messages and Resolutions

• "Clé API ou credentials invalides. Vérifiez votre clé API LINKUP et vos identifiants LinkedIn."
  Means the API key or LinkedIn token is invalid. Verify and update your credentials or use the custom credentials option.

• "Limite de requêtes atteinte. Veuillez réessayer plus tard."
  Indicates rate limit exceeded. Wait before retrying or reduce request frequency.

• "Requête invalide : <message>"
  The request was malformed. Check the input parameters for correctness and completeness.

• "Erreur inconnue"
  Generic unknown error. Check network connectivity and API status.

Recommendations

• Use the "Options avancées" to fine-tune queries and avoid overly broad searches that might trigger limits.
• Ensure tokens are refreshed and valid.
• Adjust timeout and retry settings if experiencing intermittent failures.

Links and References

• LINKUP API Documentation (general reference for API endpoints and parameters)
• LINKUP Dashboard (to obtain API keys and manage account)
• LinkedIn Authentication Guide (for understanding LinkedIn login tokens)

This summary covers the static analysis of the execute() method for the "Search Companies" operation of the LINKUP node, focusing on its inputs, outputs, dependencies, and potential troubleshooting points.