LinkedIn Profile API

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

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

GET /v1/linkedin/profileTry in

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);

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"])

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/linkedin/profile")
uri.query = URI.encode_www_form('handle' => 'https://ca.linkedin.com/company/shopify')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]

<?php

$query = http_build_query([
    'handle' => 'https://ca.linkedin.com/company/shopify',
]);
$ch = curl_init('https://socialtap.dev/v1/linkedin/profile?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
    throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;

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"])
}

curl -G 'https://socialtap.dev/v1/linkedin/profile' \
  --data-urlencode 'handle=https://ca.linkedin.com/company/shopify' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

{
  "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": []
  }
}

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);

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) throws Exception {
        String query = "handle=" + encode("https://ca.linkedin.com/company/shopify");
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/linkedin/profile?" + query))
            .header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        // An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
        if (response.statusCode() >= 400) throw new RuntimeException(response.body());
        System.out.println(response.body());
    }

    static String encode(String value) {
        return URLEncoder.encode(value, StandardCharsets.UTF_8);
    }
}

using System.Text.Json;

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));

var query = string.Join("&",
    "handle=" + Uri.EscapeDataString("https://ca.linkedin.com/company/shopify"));
var res = await http.GetAsync("https://socialtap.dev/v1/linkedin/profile?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
    var error = body.RootElement.GetProperty("error");
    throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));

// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = reqwest::blocking::Client::new()
        .get("https://socialtap.dev/v1/linkedin/profile")
        .query(&[("handle", "https://ca.linkedin.com/company/shopify")])
        .header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
        .send()?;
    let ok = res.status().is_success();
    let body: serde_json::Value = res.json()?;
    if !ok {
        return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
    }
    println!("{} {}", body["data"], body["meta"]["credits_charged"]);
    Ok(())
}

200 OK · GET https://socialtap.dev/v1/linkedin/profileLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 27 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

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/<name>, /school/<name>, /showcase/<name>, any tab of it) or a member's (linkedin.com/in/<name>), 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.

platformstring: Platform ID (tiktok, youtube, …).
idstring: Platform-native account ID (string; YouTube UC…, Reddit t2_…).
usernamestring: Handle without the @; null when the account has none.
display_namestring: Display name, channel title or page name; null when empty or not exposed.
urlstring: Canonical profile URL.
typestring: 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.
biostring: Profile bio, channel description or page about text; null when empty or not exposed.
avatar_urlstring: Profile picture URL (largest available). Platform CDN URLs can expire within hours.

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/<name>).
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 How this endpoint is priced How credits work

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.

Try it on a link you already have.

Paste it in the playground, or copy the request into your code.

free credits

No credit card
Failed requests are free
Works on all 218 endpoints

Start for free Read the docs

LinkedIn Profile API. Send a profile link.