Enrich a company from a social network url (LinkedIn, Instagram, etc.)
Retrieve the profile of a company by sending us a social network URL (see the list below for the ones we accept).
Multiple social URLs can be sent (i.e., both LinkedIn and YouTube), and we will check them in the order they are provided until we find a company that matches it.
Signup to access all the features
Get your API token and start implementing the API in your product with 500 free credits.
No credit card required
The company's Dribbble URL.
/companies/by-social?dribbble=https://dribbble.com/microsoft
The company's Facebook URL.
/companies/by-social?facebook=https://www.facebook.com/microsoft
The company's GitHub URL.
/companies/by-social?github=https://github.com/microsoft
The company's Instagram URL.
/companies/by-social?instagram=https://www.instagram.com/microsoft
The company's LinkedIn URL. We handle both alpha urls (/company/microsoft) and numeric ids (/company/6585).
/companies/by-social?linkedin=https://www.linkedin.com/company/microsoft
The company's Pinterest URL.
/companies/by-social?pinterest=https://www.pinterest.com/microsoft
The company's Snapchat URL.
/companies/by-social?snapchat=https://www.snapchat.com/add/microsoft
The company's TikTok URL.
/companies/by-social?tiktok=https://www.tiktok.com/@microsoft
The company's Twitter URL.
/companies/by-social?twitter=https://twitter.com/microsoft
The company's Wellfound URL.
/companies/by-social?wellfound=https://wellfound.com/company/microsoft
The company's YouTube URL.
/companies/by-social?youtube=https://www.youtube.com/@microsoft
When set to true, triggers a real-time refresh of the company data including website crawling, social media analysis, and AI-powered enrichment. Note: This operation costs 10 additional credits per request.
/companies/by-social?linkedin=https://www.linkedin.com/company/microsoft&refresh=true
import createClient from '@thecompaniesapi/sdk'
const tca = createClient({ apiToken: 'YOUR_API_TOKEN' })
const response = await tca.fetchCompanyBySocial({
linkedin: 'https://www.linkedin.com/company/apple'
})
const company = response.data // The company profile