The Companies API LogoThe Companies API Logo
APIUse casesCompanies
LoginLogin
Get started
Authentication
Errors
Rate limits
Webhooks
Datapoints
Companies
Enrich from domain
Enrich from email
Enrich from social network
Count companies
Search companies
Search by name
Search by prompt
Search similar
Ask company
Fetch context
Find email patterns
Fetch analytics
Export analytics
Industries
Search industries
Find similar industries
Lists
Fetch lists
Create list
Fetch companies
Toggle companies
Locations
Search cities
Search counties
Search countries
Search states
Search continents
Actions
Request action
Fetch actions
Teams
Fetch team
Technologies
Search technologies
Utilities
API health
OpenAPI spec
Get started
Authentication
Errors
Rate limits
Webhooks
Datapoints
Companies
Enrich from domain
Enrich from email
Enrich from social network
Count companies
Search companies
Search by name
Search by prompt
Search similar
Ask company
Fetch context
Find email patterns
Fetch analytics
Export analytics
Industries
Search industries
Find similar industries
Lists
Fetch lists
Create list
Fetch companies
Toggle companies
Locations
Search cities
Search counties
Search countries
Search states
Search continents
Actions
Request action
Fetch actions
Teams
Fetch team
Technologies
Search technologies
Utilities
API health
OpenAPI spec

Enrich a company from a social network url (LinkedIn, Instagram, etc.)

Transform any social network URL into a comprehensive company profile with over 80 data points.
GET
https://api.thecompaniesapi.com/v2/companies/by-social
1 credit per request

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

Query parameters
dribbblestring (optional)

The company's Dribbble URL.

/companies/by-social?dribbble=https://dribbble.com/microsoft

facebookstring (optional)

The company's Facebook URL.

/companies/by-social?facebook=https://www.facebook.com/microsoft

githubstring (optional)

The company's GitHub URL.

/companies/by-social?github=https://github.com/microsoft

instagramstring (optional)

The company's Instagram URL.

/companies/by-social?instagram=https://www.instagram.com/microsoft

linkedinstring (optional)

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

pintereststring (optional)

The company's Pinterest URL.

/companies/by-social?pinterest=https://www.pinterest.com/microsoft

snapchatstring (optional)

The company's Snapchat URL.

/companies/by-social?snapchat=https://www.snapchat.com/add/microsoft

tiktokstring (optional)

The company's TikTok URL.

/companies/by-social?tiktok=https://www.tiktok.com/@microsoft

twitterstring (optional)

The company's Twitter URL.

/companies/by-social?twitter=https://twitter.com/microsoft

wellfoundstring (optional)

The company's Wellfound URL.

/companies/by-social?wellfound=https://wellfound.com/company/microsoft

youtubestring (optional)

The company's YouTube URL.

/companies/by-social?youtube=https://www.youtube.com/@microsoft

refreshboolean (optional)

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

Response schema
companyobject

The company profile from our database.

Browse all datapoints
Code examples
Select your favorite language:
C#

Go

Java

JavaScript
SDK

PHP

Python

Ruby

Rust

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

Enrich a company from an email

Transform any email address into a comprehensive company profile with over 80 data points.

Count companies matching your query

Count the number of companies matching your query in our database.

A glowing background image to highlight the titleA glowing background image to highlight the title
© 2025 The Companies API
  • Updates
  • Terms
  • Privacy
  • FAQ
  • Status

Fast-growing SaaS companies with remote teams