# LinkedIn Profile API. Send a profile link. Company size and industry, or a member's career. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dlinkedin.profile) [Try it free, no sign-up: **LinkedIn Profile Viewer** →](https://socialtap.dev/tools/linkedin-profile-viewer/index.md) ## LinkedIn Profile API at a glance Returns a public LinkedIn company, school or showcase Page, or a member's profile, from its link or its name with a prefix (company/, in/). A Page has its industry, size, headquarters and locations, website, founding year, specialties, exact follower and employee counts, and the affiliated and similar Pages beside it. A member has their headline, about text, location, followers, connections, experience, education, skills, certifications, projects, publications, recommendations and the other sections their public profile lists. GET `/v1/linkedin/profile` [Read the API reference](https://socialtap.dev/docs/reference/linkedin/profile/index.md) - **1 credit** per request, up to 5 credits, $0.75–$1.97 per 1,000 requests - **19 typed fields** null when unknown - **`handle`** is all it needs, e.g. `https://www.linkedin.com/company/microsoft/` - **100 credits** free when you sign up, no card, so you can build before you spend ## Send one request. Get 19 fields back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `handle = https://www.linkedin.com/company/microsoft/` [Open in playground](https://socialtap.dev/playground/?endpoint=linkedin.profile) cURL: ```shell curl -G 'https://socialtap.dev/v1/linkedin/profile' \ --data-urlencode 'handle=https://ca.linkedin.com/company/shopify' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.linkedin.profile.get({ handle: "https://ca.linkedin.com/company/shopify" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ handle: "https://ca.linkedin.com/company/shopify", }); const res = await fetch(`https://socialtap.dev/v1/linkedin/profile?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/linkedin/profile", params={"handle": "https://ca.linkedin.com/company/shopify"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, meta = body["data"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("handle", "https://ca.linkedin.com/company/shopify") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/linkedin/profile?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": { "approximate_fields": [], "avatar_url": "https://media.licdn.com/dms/image/v2/D560BAQG_KjTcNcrLVw/company-logo_200_200/B56ZZolTV.HUAU-/0/1745511331439/shopify_logo?e=2147483647&v=beta&t=D2saVg58cKnwEiDQgFgzvwL24mTRM_cPuU1ndv6kL2U", "banner_url": "https://media.licdn.com/dms/image/v2/D563DAQEzTxxoWnXuew/image-scale_325_1920/B56aE7BBZdKgAI-/0/1791991486349/shopify_cover?e=2147483647&v=beta&t=b2AsimBH6u_xrudtlChar7RG3u83yzSxztJZvnV10HM", "bio": "Shopify is a leading global commerce company, providing trusted tools to start, grow, market, and manage a retail business of any size. Shopify makes commerce better for everyone with a platform and services that are engineered for reliability, while delivering a better shopping …", "category": "Software Development", "country_code": "CA", "created_at": null, "display_name": "Shopify", "external_links": [ { "title": null, "url": "https://www.shopify.com" } ], "id": "784652", "is_private": false, "is_verified": null, "location": "Ottawa, ON", "metrics": { "follower_count": 1119403, "following_count": null, "post_count": null, "total_like_count": null, "total_view_count": null }, "platform": "linkedin", "platform_specific": { "linkedin": { "affiliated_pages": [ { "avatar_url": "https://media.licdn.com/dms/image/v2/D4E0BAQEHykfrk07ZCQ/company-logo_100_100/company-logo_100_100/0/1726856574825?e=2147483647&v=beta&t=40c3dGLlHhLuZvUGFzWKv8ef2JQ6eVEeAv7Q3z54b8A", "category": "Venture Capital and Private Equity Principals", "display_name": "Shopify Ventures", "id": null, "is_verified": null, "location": null, "url": "https://www.linkedin.com/showcase/shopify-ventures", "username": "shopify-ventures" } ], "certifications": [], "company_size": { "lower_bound": 10001, "upper_bound": null }, "connection_count": null, "courses": [], "education": [], "employee_count": 30322, "employees": [ { "avatar_url": "https://media.licdn.com/dms/image/v2/C4E03AQFUruTJfTC02Q/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1516156085586?e=2147483647&v=beta&t=Axi-4iq0uAVwIj4N9E8SUHZwcmX77p9pet5Ri2m1GLM", "display_name": "Sam Ruby", "id": null, "is_verified": null, "url": "https://www.linkedin.com/in/saruby", "username": "saruby" }, { "avatar_url": "https://media.licdn.com/dms/image/v2/C5603AQG6JPHHDSVF_g/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1600306045236?e=2147483647&v=beta&t=SYwM63n268TcHjRQFbsz1EXXcGkXxKnYKNqNVUwDjA8", "display_name": "Joseph Smarr", "id": null, "is_verified": null, "url": "https://www.linkedin.com/in/jsmarr", "username": "jsmarr" }, { "avatar_url": "https://media.licdn.com/dms/image/v2/D5603AQHzy24GWVgpWQ/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1672455361616?e=2147483647&v=beta&t=rxjMeSkOWQYUTo4BYQiTn8CVlNlfbtuRgHO3zDQaSRg", "display_name": "Todd Muchmore", "id": null, "is_verified": null, "url": "https://www.linkedin.com/in/toddmuchmore", "username": "toddmuchmore" } ], "experience": [], "founded_year": 2006, "headline": null, "headquarters": { "city": "Ottawa", "country_code": "CA", "postal_code": null, "region": "ON", "street": null }, "honors": [], "is_creator": null, "is_hiring": null, "is_influencer": null, "is_open_to_work": null, "kind": "company", "languages": [], "locations": [ { "address": "Ottawa, ON, CA", "is_primary": true } ], "organization_type": "Public Company", "organizations": [], "patents": [], "projects": [], "publications": [], "recommendation_count": null, "recommendations": [], "similar_pages": [ { "avatar_url": "https://media.licdn.com/dms/image/v2/D560BAQE2ZfJyfn-VCg/company-logo_100_100/B56ZlyKwpUKIAQ-/0/1758557047806/stripe_logo?e=2147483647&v=beta&t=fRMcaMGPJNFUMq_l1f2zzyX4PaK3yg-MRicyUuY3qSI", "category": "Technology, Information and Internet", "display_name": "Stripe", "id": null, "is_verified": null, "location": "South San Francisco, California", "url": "https://www.linkedin.com/company/stripe", "username": "stripe" }, { "avatar_url": "https://media.licdn.com/dms/image/v2/C560BAQFkDzx_7dqq3A/company-logo_100_100/company-logo_100_100/0/1631377935713?e=2147483647&v=beta&t=AiRi3YW2R5kYKHbxsjkdQ_d1RuH6Yk98ePBwANPPDhc", "category": "Musicians", "display_name": "Spotify", "id": null, "is_verified": null, "location": "Stockholm, Stockholm County", "url": "https://www.linkedin.com/company/spotify", "username": "spotify" }, { "avatar_url": "https://media.licdn.com/dms/image/v2/C560BAQFhfl32crIGIw/company-logo_100_100/company-logo_100_100/0/1630637496980/airbnb_logo?e=2147483647&v=beta&t=idNQqoBZi6dZq6iG78J5GTOsNV_ltJf7ITo7zYZ6VWg", "category": "Software Development", "display_name": "Airbnb", "id": null, "is_verified": null, "location": "San Francisco, CA", "url": "https://www.linkedin.com/company/airbnb", "username": "airbnb" } ], "similar_profiles": [], "skills": [], "specialties": [ "ecommerce", "API", "applications" ], "tagline": "Make commerce better for everyone", "volunteering": [] } }, "type": "organization", "unknown_fields": [], "url": "https://www.linkedin.com/company/shopify", "username": "shopify" }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "linkedin", "source": "page", "is_cached": false, "credits_charged": 1, "latency_ms": 1175, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "profile", "id": "784652", "url": "https://www.linkedin.com/company/shopify" }, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 27 platforms. The [response reference](https://socialtap.dev/docs/reference/linkedin/profile/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/profile/index.md). - ### Null means unknown A field LinkedIn doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts The LinkedIn account: a Page's link (linkedin.com/company/\, /school/\, /showcase/\, any tab of it) or a member's (linkedin.com/in/\), or its name with the prefix that says which (company/google, school/mit, showcase/microsoft-security, in/williamhgates). - ### Write one parser LinkedIn, TikTok, Instagram and 24 more platforms answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform ID (tiktok, youtube, …). - **`id`string**: Platform-native account ID (string; YouTube UC…, Reddit t2_…). - **`username`string**: Handle without the @; null when the account has none. - **`display_name`string**: Display name, channel title or page name; null when empty or not exposed. - **`url`string**: Canonical profile URL. - **`type`string**: Coarse account kind, as the platform labels it; unknown when it does not (TikTok labels organizations only). New values may be added; treat unknown values as unknown. - **`bio`string**: Profile bio, channel description or page about text; null when empty or not exposed. - **`avatar_url`string**: Profile picture URL (largest available). Platform CDN URLs can expire within hours. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the LinkedIn Profile API. - ### Enrich CRM accounts with company firmographics - ### Look up a company's size, industry and headquarters - ### Research a person's current role and career history - ### Track follower growth of companies and creators - ### Map a company's affiliated and similar Pages ## Good to know before you build. - A bare name is looked up as a company. Send a member as a link or with its prefix (in/\). - LinkedIn opens an account by its numeric ID only for signed-in members, so send a link or a name, not an ID. - A member's profile has what they made public to logged-out visitors: sections they hid are \[\] and fields they hid are null. - LinkedIn hides most members' pages from logged-out visitors. A data partner then reads the public profile live and fills it (meta.source vendor), at the vendor price below. follower_count and connection_count are null on those answers, and the lists unknown_fields names are unknown. - When the data partner can't answer, a member's profile is a public search engine's copy of their page: name, headline, about text, current employer, school, location and connections, with meta.source web_search, id their public name, and the lists it can't see named in unknown_fields. It can be days or weeks old. - A member name that doesn't exist returns not_found when the data partner looked it up. Otherwise it returns upstream_blocked, because LinkedIn answers a missing name the way it refuses a request. - connection_count is 500 for every member LinkedIn shows as 500+, listed in approximate_fields. - is_verified is null because LinkedIn doesn't show its verification badge logged out. ## From 1 credit per request. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/linkedin/profile/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful request | Per 1,000 requests | | --- | --- | --- | | Public page `page` | 1 credit | $0.75–$1.97 | | Data partner `vendor` | 5 credits | $3.75–$9.83 | | Web search `web_search` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the LinkedIn Profile API. More in the [API reference](https://socialtap.dev/docs/reference/linkedin/profile/index.md). **Is the employee count exact?** Yes, when the Page shows it. platform_specific.linkedin.employee_count is the exact number of members who list the company as their employer, beside the size range the Page states in company_size. **How much does the LinkedIn Profile API cost?** A request costs 1 credit for public page results (meta.source = page), 5 credits for data partner results (meta.source = vendor) and 1 credit for web search results (meta.source = web_search). SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. Other platforms ## Profiles on 26 more platforms. - [TikTok Profile API](https://socialtap.dev/apis/tiktok/profile/index.md) (1 credit · `GET /v1/tiktok/profile`) - [Instagram Profile API](https://socialtap.dev/apis/instagram/profile/index.md) (1 credit · `GET /v1/instagram/profile`) - [Facebook Profile API](https://socialtap.dev/apis/facebook/profile/index.md) (1 credit · `GET /v1/facebook/profile`) - [YouTube Channel API](https://socialtap.dev/apis/youtube/profile/index.md) (1 credit · `GET /v1/youtube/profile`) - [Reddit Profile API](https://socialtap.dev/apis/reddit/profile/index.md) (1 credit · `GET /v1/reddit/profile`) - [Threads Profile API](https://socialtap.dev/apis/threads/profile/index.md) (1 credit · `GET /v1/threads/profile`) - [Spotify Artist API](https://socialtap.dev/apis/spotify/artist/index.md) (1 credit · `GET /v1/spotify/artist`) - [Amazon Shop API](https://socialtap.dev/apis/amazon/shop/index.md) (1 credit · `GET /v1/amazon/shop`) - [Apple Music Artist API](https://socialtap.dev/apis/applemusic/artist/index.md) (1 credit · `GET /v1/applemusic/artist`) - [Pinterest Profile API](https://socialtap.dev/apis/pinterest/profile/index.md) (1 credit · `GET /v1/pinterest/profile`) - [Rumble Channel API](https://socialtap.dev/apis/rumble/profile/index.md) (1 credit · `GET /v1/rumble/profile`) - [X (Twitter) Profile API](https://socialtap.dev/apis/x/profile/index.md) (1 credit · `GET /v1/x/profile`) - [Bluesky Profile API](https://socialtap.dev/apis/bluesky/profile/index.md) (1 credit · `GET /v1/bluesky/profile`) - [Twitch Profile API](https://socialtap.dev/apis/twitch/profile/index.md) (1 credit · `GET /v1/twitch/profile`) - [Telegram Channel API](https://socialtap.dev/apis/telegram/channel/index.md) (1 credit · `GET /v1/telegram/channel`) - [Kwai Profile API](https://socialtap.dev/apis/kwai/profile/index.md) (1 credit · `GET /v1/kwai/profile`) - [Snapchat Profile API](https://socialtap.dev/apis/snapchat/profile/index.md) (1 credit · `GET /v1/snapchat/profile`) - [SoundCloud Artist API](https://socialtap.dev/apis/soundcloud/artist/index.md) (1 credit · `GET /v1/soundcloud/artist`) - [Truth Social Profile API](https://socialtap.dev/apis/truthsocial/profile/index.md) (1 credit · `GET /v1/truthsocial/profile`) - [Komi Page API](https://socialtap.dev/apis/komi/page/index.md) (1 credit · `GET /v1/komi/page`) - [Lnk.Bio Profile API](https://socialtap.dev/apis/linkbio/profile/index.md) (1 credit · `GET /v1/linkbio/profile`) - [Linkme Profile API](https://socialtap.dev/apis/linkme/profile/index.md) (1 credit · `GET /v1/linkme/profile`) - [Linktree Profile API](https://socialtap.dev/apis/linktree/profile/index.md) (1 credit · `GET /v1/linktree/profile`) - [Pillar Page API](https://socialtap.dev/apis/pillar/page/index.md) (1 credit · `GET /v1/pillar/page`) - [Facebook Ad Library Advertiser Search API](https://socialtap.dev/apis/facebook/search_advertisers/index.md) (1 credit / page · `GET /v1/facebook/search_advertisers`) - [Google Ads Transparency Center Advertiser API](https://socialtap.dev/apis/google/advertiser/index.md) (1 credit · `GET /v1/google/advertiser`) More LinkedIn ## LinkedIn API. 4 endpoints, one key. - [LinkedIn Post API](https://socialtap.dev/apis/linkedin/post/index.md) (1 credit · `GET /v1/linkedin/post`) - [LinkedIn Post Search API](https://socialtap.dev/apis/linkedin/search_posts/index.md) (From 1 credit / page · `GET /v1/linkedin/search_posts`) - [LinkedIn Company and People Search API](https://socialtap.dev/apis/linkedin/search_profiles/index.md) (From 1 credit / page · `GET /v1/linkedin/search_profiles`) ## Try it on a link you already have. Paste it in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/linkedin/profile/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)