The Companies API icon

The Companies API

Access company data, enrichment, analytics and more using The Companies API
Join our community

Actions41

Overview

This node operation enriches company data by using social media identifiers. It allows users to input various social media handles or URLs related to a company (such as LinkedIn, Twitter, Facebook, GitHub, etc.) and fetch detailed company information associated with those social profiles. This is particularly useful for marketing, sales, or research teams who want to gather comprehensive company insights based on social presence without needing the company name or email.

Common scenarios:

  • Enriching lead or prospect data by linking social media accounts to company details.
  • Verifying company information from social media profiles collected during outreach.
  • Aggregating company data from multiple social channels for analytics or CRM enrichment.

Practical example:
You have a list of LinkedIn URLs or Twitter handles of companies and want to automatically retrieve their full company profile including industry, size, location, and other metadata to feed into your CRM system.

Properties

Name Meaning
Refresh Boolean flag to force refresh of cached data when fetching company info by social handle.
Simplified Boolean flag to request simplified company data response.
Angellist Company identifier on AngelList platform.
Dribbble Company identifier on Dribbble platform.
Facebook Company Facebook page or username.
Github Company GitHub organization or username.
Instagram Company Instagram handle.
Linkedin Company LinkedIn page or username.
Pinterest Company Pinterest username.
Snapchat Company Snapchat username.
Souncloud Company SoundCloud username.
Tiktok Company TikTok username.
Twitter Company Twitter handle.
Wellfound Company identifier on Wellfound platform (formerly AngelList Talent).
Youtube Company YouTube channel name or ID.

All these properties are optional string inputs representing the company's social media identifiers on respective platforms. The node uses whichever identifiers are provided to query and enrich the company data.

Output

The output is a JSON object containing the enriched company data retrieved from the external API. The structure typically includes detailed company information such as:

  • Company name
  • Industry
  • Location
  • Size
  • Website URL
  • Social media links
  • Other metadata fields relevant to the company profile

If multiple items are processed, each input item corresponds to one output item paired by index.

No binary data output is produced by this operation.

Dependencies

  • Requires an API token credential for authenticating requests to The Companies API service.
  • Uses the official SDK of The Companies API to perform the enrichment calls.
  • Network access to The Companies API endpoints is necessary.
  • No additional environment variables or n8n configurations beyond the API token credential are required.

Troubleshooting

  • Common issues:

    • Providing invalid or empty social media identifiers will result in no data found or errors.
    • Missing or incorrect API token credential will cause authentication failures.
    • Rate limiting or quota exceeded errors if too many requests are made in a short time.

  • Error messages:

    • Unknown operation: Indicates the specified operation is not supported; ensure "fetchCompanyBySocial" is selected.
    • SDK method ... not found: Internal error indicating mismatch between operation and SDK; usually a configuration issue.
    • API errors returned from The Companies API (e.g., 401 Unauthorized, 404 Not Found) should be checked against the API token validity and input correctness.

  • Resolutions:

    • Verify all social media handles are correctly formatted and valid.
    • Confirm the API token credential is set up properly in n8n.
    • Handle errors gracefully by enabling "Continue On Fail" option if partial processing is acceptable.

Links and References

Discussion