LinkedIn Companies
A public LinkedIn company page presents an organization's description, website, industry, size, headquarters, locations, specialties, and visible follower and employee counts. These attributes support account enrichment, company segmentation, market mapping, and comparison of public company information over time.
Features
- Public company page inputProcess one or more LinkedIn /company/{slug} URLs without mixing in personal profiles, posts, or job listings.
- Company identity and web presenceReturn the public company name, description, website, logo, and LinkedIn page URL in one normalized record.
- Structured company attributesExpose industry, company size, headquarters, founding year, locations, and specialties as fields ready for filtering and comparison.
- Visible follower and employee countsReturn available follower and employee counts as separate metrics alongside the company attributes.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Required list of public LinkedIn company page URLs. Every URL must use the /company/{slug} path on linkedin.com or a LinkedIn subdomain. |
How to Use
Submit the company pages you already know, wait for the dataset task, and page through the resulting firmographic records.
- Prepare public company links that follow the /company/{slug} pattern.
- POST the urls list to /v1/linkedin/companies and keep its task_id.
- Follow the task at /v1/tasks/{task_id} until company processing finishes or fails.
- Consume data.results.items, using next_cursor to retrieve any additional result pages.
curl -X POST "https://api.socq.ai/v1/linkedin/companies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/company/microsoft/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Account and CRM enrichment: Add company descriptions, websites, logos, industries, size, and headquarters to records linked to known company pages.
- Company segmentation: Group organizations by industry, company size, locations, and specialties for research or account planning.
- Market and location mapping: Use headquarters and location arrays to compare where selected companies operate.
- Public company monitoring: Compare saved company records to identify changes in descriptions, locations, specialties, or visible scale indicators.
Pro Tips
- Normalize and deduplicate the company slug before submission so alternate /company/ URL forms do not create repeated records.
- Keep industries, locations, and specialties as arrays so multi-value company attributes remain intact.
- Keep collected_at with each stored record when comparing company attributes or visible counts over time.
Related APIs
Use these APIs when you need a different type of public LinkedIn data.
- LinkedIn Profiles API — Normalize public profile identity, roles, location, visible audience counts, experience, education, and skills from profile URLs.
- LinkedIn Posts API — Collect public post text, authors, visible engagement, media, publication time, type, and hashtags from supported URLs.
- LinkedIn Jobs API — Normalize public job titles, companies, descriptions, locations, qualifications, employment details, application links, and available salary fields.
- LinkedIn Company Jobs API — Discover public job listings from prepared LinkedIn /jobs/ URLs with normalized role, company, location, employment, experience, remote, salary, and timing fields.
- LinkedIn Company Posts API — Discover public posts from LinkedIn company-page URLs with text, author context, media, hashtags, timestamps, and visible engagement.
- LinkedIn Post Comments API — Collect public comments exposed with a known LinkedIn post, including text, author context, timestamps, relationship IDs, and visible likes and reply counts.
- LinkedIn Profile Posts API — Discover public posts associated with LinkedIn profile URLs, with author context, media, hashtags, timestamps, and visible engagement.
- LinkedIn Search Jobs API — Search public LinkedIn jobs from a required location and optional filters, returning normalized role, company, place, employment, experience, remote, salary, and timing fields.
- LinkedIn Search People API — Discover candidate public profiles from LinkedIn people-search URLs, returning normalized identity, description, images, location, website, account signals, and available metrics.
- LinkedIn Search Posts API — Discover Google-indexed public LinkedIn posts by keyword and optional date string, returning normalized content, authors, media, tags, timestamps, and visible engagement.