100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
무료로 시작하기
LinkedIn logoLinkedIn API

공개 LinkedIn 데이터 API

SocialCrawl API 키로 공개 LinkedIn 데이터를 구조화 JSON으로 가져옵니다. Post, Comment, Author 스키마는 다른 플랫폼과 같습니다. 호출은 크레딧으로 과금됩니다.

문서 보기동작 방식직접 호출
LinkedIn logo
/v1/linkedin

활성 엔드포인트는 45개입니다.

  • GET /v1/linkedin/profile
  • GET /v1/linkedin/profile/full
  • GET /v1/linkedin/profile/posts
  • GET /v1/linkedin/company
  • GET /v1/linkedin/company/posts
  • GET /v1/linkedin/post
  • GET /v1/linkedin/post/comments
  • GET /v1/linkedin/search/people
  • GET /v1/linkedin/search/posts
  • GET /v1/linkedin/search/jobs

LinkedIn 엔드포인트

공개 LinkedIn 읽기 엔드포인트는 45개입니다. 개인·회사 프로필, 게시물, 댓글, 채용, 검색을 제공합니다. 인물 검색과 회사 재직자, 게시물 반응은 목록의 각 행을 해당 회원의 프로필과 같은 호출에서 연결합니다. 데이터 API만 지원하며 비공개 InMail은 포함되지 않습니다.

프로필

5 크레딧
/v1/linkedin/profile

공개 프로필 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

url

전체 프로필

5 크레딧
/v1/linkedin/profile/full

공개 전체 프로필 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

url, posts, cursor, include

프로필 게시물

5 크레딧
/v1/linkedin/profile/posts

공개 프로필 게시물 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

url, limit, urn

회사

5 크레딧
/v1/linkedin/company

공개 회사 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

url

회사 게시물

5 크레딧
/v1/linkedin/company/posts

공개 회사 게시물 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

company_id, page, sort_by

게시물

5 크레딧
/v1/linkedin/post

공개 게시물 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

url

게시물 댓글

5 크레딧
/v1/linkedin/post/comments

공개 댓글 데이터를 반환합니다. 작성자, 본문, 참여 지표가 포함됩니다.

url, page, post_type, sort_order

인물 검색

10~50 크레딧
/v1/linkedin/search/people

공개 인물 검색 결과를 반환합니다. include=profile을 함께 보내면 각 행에 정확한 팔로워 수와 인맥 수가 채워집니다.

query, page, first_name, last_name, title, include, limit

게시물 검색

5 크레딧
/v1/linkedin/search/posts

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

query or from_member or from_company, page, sort_by, date_posted, content_type

채용 검색

10 크레딧
/v1/linkedin/search/jobs

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

query, page, date_posted, experience_level, job_type

LinkedIn API68개 엔드포인트 지원
문서 보기

LinkedIn 회원의 공개 프로필을 반환합니다. 이름과 헤드라인, 지역, 팔로워·1촌 수, 프로필 사진, 프로필 URL이 담깁니다.

사람을 조회하는 첫 단계로 사용하세요. 경력이나 보유 기술, 게시물은 profile 하위 엔드포인트를 이어서 부르면 됩니다.

5크레딧

GET/v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fwilliamhgates%2F

url · Full URL of the LinkedIn profile page

$ curl https://www.socialcrawl.dev/v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fwilliamhgates%2F \
    -H "x-api-key: sc_YOUR_API_KEY"
대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다

LinkedIn API 동작 방식

LinkedIn도 다른 SocialCrawl 소셜 엔드포인트와 같습니다. API 키로 GET /v1/linkedin/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. 별도 SDK는 없습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. SocialCrawl 카탈로그 전 구간에 같은 키를 사용합니다.

GET과 쿼리 파라미터

라우트는 GET입니다. handle, url, query, cursor를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.

크레딧 과금

라이브 미스는 라우트 티어를 차감합니다. 캐시 히트는 0입니다. 빈 응답과 하드 실패는 환불됩니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다.

연동 순서

대부분 제품은 계정을 확인한 뒤 목록을 보고 필요한 게시물만 깊게 읽습니다.

01계정
GET /v1/linkedin/profile

Author 형태 프로필입니다.

핸들 또는 id를 한 번 확정합니다.

02목록
GET /v1/linkedin/profile/full

최근 공개 항목의 PostList입니다.

라우트가 지원하면 cursor 또는 after로 페이지를 넘깁니다.

03항목
GET /v1/linkedin/profile/posts

URL 또는 id 기준 전체 Post입니다.

목록 행만으로 부족할 때 사용합니다.

04댓글
GET /v1/linkedin/company

플랫폼이 제공하는 CommentList입니다.

스레드가 중요할 때만 확장합니다.

요청
GET /v1/linkedin/profile
  ?url=https://www.linkedin.com/in/williamhgates/
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
응답 봉투
{
  "success": true,
  "data": { "/* Author | Post | PostList | CommentList | … */": true },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data 형태

archetype이 맞으면 필드 이름은 SocialCrawl 나머지 플랫폼과 같습니다.

Authorprofile

id, username, display_name, avatar_url, bio, followers, url, ext

PostList / Postprofile/full

items[].post에 id, url, content, engagement, author, published_at, ext

CommentListprofile/posts

댓글 라우트가 있을 때 items[]에 author, content.text, engagement, published_at

Search / Mediacompany

검색 결과, 미디어 메타데이터, 대본 등 라우트별 필드

게이트웨이 내부

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명 주기입니다.

  1. 01

    엣지 수신

    Next.js catch-all이 Hono 소셜 API로 연결됩니다. request_id를 발급하고 키를 인증한 뒤 속도 제한과 동시성을 적용합니다.

  2. 02

    검증 후 차감

    레지스트리에서 라우트를 찾습니다. 필수 파라미터를 먼저 검사합니다. 잘못된 입력은 미과금 400입니다. 유효 호출은 upstream 전에 차감합니다.

  3. 03

    캐시 또는 수집

    platform + resource + params로 캐시 키를 만듭니다. 히트는 credits_used 0입니다. 미스는 재시도와 서킷 브레이커로 upstream을 호출합니다.

  4. 04

    정규화 후 반환

    upstream JSON을 Author / Post / PostList / CommentList(또는 라우트 archetype)로 매핑하고 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.

운영에서 중요한 과금 규칙

  • 표준 라이브 미스: 티어 비용(보통 1 크레딧)
  • 고급 읽기: 보통 5 크레딧
  • 프리미엄 읽기: 보통 10 크레딧
  • 종량제 라우트: 문서화된 최소 바닥
  • 캐시 히트: 0 크레딧
  • 빈 응답·하드 실패: 자동 환불
  • 잘못된 파라미터: 400, 미과금
  • 크레딧 부족: 402, 미과금
  • 비활성 라우트: 503, 미과금

데이터 수집 방식

LinkedIn은 SocialCrawl의 공개 읽기 데이터입니다. 공유 스키마로 정규화하므로 별도 OAuth를 배울 필요가 없습니다.

이 API에서의 LinkedIn

레지스트리에 노출된 공개 LinkedIn 표면입니다. 연구·모니터링·제품 작업을 위한 읽기 전용입니다.

SocialCrawl 접근 방식

하나의 게이트웨이 뒤에서 소셜 읽기 upstream을 호출합니다. 등록된 두꺼운 라우트는 Prism 컴포지트로 단계를 묶습니다.

엣지에서 나가는 형태

success, data, credits_used, request_id, cached 통일 JSON 봉투입니다. Author / Post / Comment 리프를 공유합니다.

제공하지 않는 범위

쓰기 엔드포인트와 비공개 수신함은 없습니다. 비활성 라우트는 활성 개수에 넣지 않습니다.

필드 매핑
public profile / channel→ author.*프로필 식별자와 카운터
public post / media→ post.* / items[].post게시물 본문과 참여 지표
comment page / tree→ CommentList items[]댓글 또는 검색 결과

이 API의 활용 분야

이 API가 가장 많이 사용되는 작업입니다.

45active LinkedIn endpoints in the registry
1 / 5 / 10표준·고급·프리미엄 크레딧 단계

B2B 프로스펙팅과 회사 콘텐츠 모니터링

호출은 LinkedIn 프로필, 콘텐츠 목록, 검색, 심화 경로에 집중됩니다. 공유 스키마의 사람·회사·채용·게시물 읽기입니다. 이 공개 읽기에는 LinkedIn 파트너십 앱 대신 크레딧 과금을 사용합니다. 인물 목록은 각 행을 해당 회원의 프로필과 같은 호출에서 연결하므로, LinkedIn이 목록에 싣는 반올림된 구간 대신 정확한 팔로워 수와 인맥 수가 반환됩니다.

상세 읽기는 캐시 미스 기준 수 초 수준입니다. 검색과 두꺼운 컴포지트는 더 느린 경로입니다.

LinkedIn API 활용 사례

LinkedIn 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.

활용 사례

이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.

모니터링 잡

Python, cron, Slack 봇

LinkedIn 프로필과 피드를 폴링합니다. 참여 속도가 뛰면 알립니다.

리서치·VoC

Node, 노트북, BI 적재

LinkedIn에서 검색 후 게시물을 확장해 브랜드·제품·경쟁 언어를 모읍니다.

백엔드 제품 잡

Go, 워커, Explorer

해석-목록-상세를 파이프라인에 연결합니다. 캐시 히트로 반복 비용을 낮춥니다.

두 줄로 호출

라이브 미스는 티어별 크레딧을 사용합니다. 캐시 히트는 무료입니다. 빈 응답과 하드 실패는 환불됩니다.

curl "https://www.socialcrawl.dev/v1/linkedin/profile?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/linkedin/profile/full?url=https://www.linkedin.com/company/microsoft&posts=25" \
  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/linkedin/search/people?query=Bill+Gates&include=profile&limit=10" \
  -H "x-api-key: sc_your_api_key_here"
LinkedIn logoSocialCrawl의 LinkedIn

카탈로그 전 구간과 같은 키

플랫폼 문서API 키 받기
엔드포인트

LinkedIn API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

ProfileGet LinkedIn user profileCompanyGet LinkedIn company page with its full About tabCompany By DomainLook up a LinkedIn company page from its website domainProfile SimilarList LinkedIn members similar to a given profileSearch CompaniesSearch LinkedIn company pagesProfile Posted JobsList jobs a LinkedIn member has postedJob Hiring TeamList the hiring team on a LinkedIn jobProfile ArticlesList Pulse articles a LinkedIn member publishedArticleGet a LinkedIn Pulse articleArticle CommentsList comments on a LinkedIn Pulse articleArticle ReactionsList reactors on a LinkedIn Pulse articleSearch HashtagSearch LinkedIn posts by hashtagProfile ActivityGet when a LinkedIn member was last activeCompany Also ViewedList company pages people also viewedCompany Employees CountGet a company's employee count, optionally by locationProfile Interests SchoolsList schools a LinkedIn member followsProfile Interests NewslettersList newsletters a LinkedIn member followsProfile Interests Top VoicesList Top Voices a LinkedIn member followsProfile Position SkillsList a member's positions with the skills on each roleProfile Top PositionGet the company page of a member's top positionSearch People By UrlSearch LinkedIn people from a search-results URLProfile AllGet a member's entire profile, counts included, in one callProfile CompleteGet a member's profile, experience, education, skills and recommendationsProfile With PostsGet a member profile with follower and connection counts and recent postsPost With CommentsGet a LinkedIn post together with its commentsPostGet LinkedIn post detailsSearch PeopleSearch LinkedIn peopleCompany PeopleList people at a LinkedIn companyPost CommentsGet LinkedIn post commentsProfile PostsList a LinkedIn member's postsProfile ReactionsList posts a LinkedIn member reacted toPost RepostsList reposts of a LinkedIn postGroup PostsList posts in a LinkedIn groupCompany Affiliated PagesList a company's affiliated/showcase pagesPost Comments RepliesList replies to a LinkedIn commentProfile ExperiencesList a member's work experiencesProfile EducationsList a member's education historyProfile SkillsList a member's skillsProfile HonorsList a member's honors and awardsProfile CertificationsList a member's licenses and certificationsProfile PublicationsList a member's publicationsProfile VolunteersList a member's volunteer experiencesProfile RecommendationsList recommendations for a memberProfile Interests CompaniesList companies a member followsProfile Interests GroupsList groups a member followsProfile ImagesList a member's image postsProfile VideosList a member's video postsProfile CommentsList a member's commentsPost ReactionsList reactors on a LinkedIn postCompany JobsList a company's job postingsSearch JobsSearch LinkedIn jobsSearch LocationResolve a location to a LinkedIn geocode idSearch SchoolsSearch LinkedIn schoolsSearch IndustryResolve an industry name to a LinkedIn industry idProfile AboutGet a member's account freshness signals (NOT the profile About section)Profile ContactGet a member's public contact infoProfile StatsGet a member's follower + connection countsCompany Job CountGet a company's open job countCompany InsightsGet aggregate insights about a company's membersGroupGet LinkedIn group detailsJobGet LinkedIn job detailsCompany PostsList LinkedIn company postsAdGet LinkedIn ad detailsAds SearchSearch LinkedIn adsProfile Posts ArchiveWalk a LinkedIn member's COMPLETE post history, 100 posts a page, with exact publish times and share counts the other lanes cannot return. Metered: 5 credits per post returned, so try the cheaper /v1/linkedin/profile/posts firstSearch PostsSearch public LinkedIn posts by keywordPost TranscriptGet a LinkedIn post video transcriptProfile FullLinkedIn company profile, recent posts, and computed analytics in one call. Company pages only; a member's profile is `/v1/linkedin/profile/all`.
비교

SocialCrawl과 공식 LinkedIn Marketing API, 뭐가 다른가요?

같은 LinkedIn 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.

인증

SocialCrawl
x-api-key 헤더 하나면 충분해요
공식 LinkedIn Marketing API
OAuth 2.0과 회원 동의 화면을 거쳐야 해요

설정·심사

SocialCrawl
가입 후 바로 호출할 수 있어요
공식 LinkedIn Marketing API
개발자 앱 심사에 Marketing Developer Platform 승인까지 필요해요

레이트 리밋

SocialCrawl
크레딧 기반이라 쓴 만큼만 차감돼요
공식 LinkedIn Marketing API
앱·토큰별 일일 호출 한도가 있어요

응답 스키마

SocialCrawl
68개 플랫폼 공통 통합 JSON으로 와요
공식 LinkedIn Marketing API
LinkedIn 전용 응답 구조를 직접 매핑해야 해요

요금

SocialCrawl
스탠다드 1, 어드밴스드 5, 프리미엄 10 크레딧에 100 크레딧 무료예요
공식 LinkedIn Marketing API
무료지만 승인된 파트너 유스케이스에만 열려요

데이터 범위

SocialCrawl
공개 프로필·회사·게시물·광고·검색·트랜스크립트·Ad Library를 읽을 수 있어요
공식 LinkedIn Marketing API
회원이 허용한 데이터와 광고 캠페인 관리, 공식 포스팅까지 가능해요

유지보수

SocialCrawl
LinkedIn 내부가 바뀌어도 스키마가 유지돼요
공식 LinkedIn Marketing API
API 버전과 파트너 프로그램 요건을 직접 챙겨야 해요
자주 묻는 질문

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기
LinkedIn 데이터는 어떻게 수집하나요?
SocialCrawl이 프로필, 회사 페이지, 게시물, 회사 게시물 피드, 게시물 검색, 영상 트랜스크립트, Ad Library를 비롯해 LinkedIn 엔드포인트 68종을 제공해요. x-api-key만 있으면 되고, OAuth 2.0 인증이나 Marketing Developer Platform 앱 심사 없이 바로 호출할 수 있어요.
SocialCrawl은 어떤 LinkedIn 엔드포인트를 지원하나요?
엔드포인트 68종을 지원해요. 프로필(사용자 데이터), 회사 페이지, 게시물 상세, 회사 게시물 피드, 게시물 키워드 검색, 게시물 영상 트랜스크립트, Ad Library 광고 상세를 비롯해 다양하게 써보실 수 있어요.
LinkedIn API 요금은 얼마인가요?
프로필, 회사 페이지, 게시물, 회사 게시물 피드, 게시물 검색은 각각 1 크레딧(스탠다드)이에요. Ad Library 광고 상세는 5 크레딧(어드밴스드), 게시물 영상 트랜스크립트는 10 크레딧(프리미엄)이고, 신규 가입 시 100 크레딧을 무료로 받을 수 있어요. 신용카드는 필요 없어요.
LinkedIn OAuth 앱이나 Marketing API 승인이 필요한가요?
필요 없어요. OAuth 2.0 토큰이나 LinkedIn 개발자 앱, Marketing Developer Platform 승인 절차 없이 SocialCrawl x-api-key와 LinkedIn URL만 있으면 돼요. 모든 응답은 다른 플랫폼과 동일한 통합 스키마로 돌아와서 개발이 쉽고 간편해요.
LinkedIn 데이터를 수집해도 법적으로 괜찮나요?
SocialCrawl은 로그인하지 않은 사용자도 볼 수 있는 LinkedIn 공개 데이터만 가져와요. 다만 사용 목적이 LinkedIn 사용자 계약과 개인정보 관련 법령에 맞는지는 직접 확인해 주세요. SocialCrawl은 GDPR 정당한 이익에 기반한 문서화된 프레임워크로 운영돼요. 로그인 없이 볼 수 있는 공개 데이터만 다루고, 계정 자격 증명은 일절 사용하지 않으며, 캐시는 2~30분만 유지되고 영구 저장하지 않아요. 자신의 공개 정보에 대한 옵트아웃 채널도 운영해요. 자세한 내용은 socialcrawl.dev/legal/public-data-notice에서 확인하실 수 있어요.
경쟁사 광고 분석용으로 Ad Library도 쓸 수 있나요?
네, Ad Library 전용 ad 엔드포인트가 있어요. Ad Library URL 하나로 크리에이티브, 광고 카피, 광고주, 노출량 구간, 공개된 타겟팅 정보까지 광고 전체 레코드를 받아볼 수 있어서 B2B 광고 인텔리전스와 크리에이티브 리서치에 딱 맞아요.
가장 좋은 LinkedIn 스크레이퍼 API는 무엇인가요?
공개 LinkedIn 데이터라면 SocialCrawl이 넓은 범위를 커버해요. 프로필, 회사 페이지, 게시물, 회사 피드, 광고 검색, 게시물 검색, 영상 트랜스크립트, Ad Library를 비롯해 엔드포인트 68종이 있고 스탠다드 호출은 1 크레딧이에요. OAuth 앱이나 파트너 승인 없이 100 크레딧 무료로 바로 시작할 수 있어요.
LinkedIn 스크래핑 API와 공식 LinkedIn API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 LinkedIn 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기Perplexity에 물어보기Gemini에 물어보기Claude에 물어보기Grok에 물어보기

LinkedIn API 레퍼런스 문서 보기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요