링크드인 스크래핑, 프로필 URL 하나로 경력과 학력 받기
링크드인 공개 프로필 URL 하나로 경력, 학력, 스킬, 팔로워 수를 JSON으로 받아요. 최근 게시글은 별도 호출이라 크레딧이 한 번 더 나가요.
링크드인 공개 프로필의 경력과 학력은 GET /v1/linkedin/profile/all?url= 한 번으로 받아요. 경력, 학력, 스킬, 받은 추천, 팔로워 수가 한 응답에 들어오고 5크레딧이에요. 이 응답에는 게시글이 없어요. 최근 글은 profile/with-posts로 따로 받아요.
시작하기 전에 필요한 것
- API 키 하나. 가입하면 받아요. 요청 헤더 이름은
x-api-key예요. - 공개 프로필 URL.
https://www.linkedin.com/in/뒤에 회원 슬러그가 붙은 주소예요. - curl이나 HTTP 요청을 보내는 도구. 별도 SDK는 필요 없어요.
코드를 쓰기 전에 비주얼 익스플로러에서 같은 요청을 먼저 눌러 보세요.
링크드인 프로필 스크래핑은 어떤 호출을 써야 하나요?
필요한 데이터에 따라 호출이 달라요. 경력과 학력이면 profile/all, 최근 게시글이면 profile/with-posts, 키워드로 글을 찾을 때는 search/posts예요.
| 필요한 것 | 호출 | 크레딧 |
|---|---|---|
| 헤드라인, 정확한 팔로워 수, 링크드인에 공개된 소개 글과 인증 배지, 현재 직책, 업종 | GET /v1/linkedin/profile | 5 |
| 경력, 학력, 스킬, 받은 추천, 비슷한 프로필, 정확한 팔로워 수 | GET /v1/linkedin/profile/all | 프로필당 5 |
| 위 내용에 작성한 추천까지 | GET /v1/linkedin/profile/complete | 10 |
| 팔로워와 커넥션 수, 최근 게시글 | GET /v1/linkedin/profile/with-posts | 10 |
| 게시글만 | GET /v1/linkedin/profile/posts | 50건까지 5, 넘으면 글당 2 |
| 키워드로 찾은 게시글 | GET /v1/linkedin/search/posts | 페이지당 5, limit을 쓰면 5개당 1 |
프로필 호출과 게시글 호출은 따로 과금돼요. 둘 다 필요하면 두 번 호출하고 크레딧도 각각 나가요. 엔드포인트 전체 목록은 LinkedIn 문서에 있어요.
한 번 호출하면 프로필의 무엇이 오나요?
profile/all은 회원 정보를 author에, 이력을 background에, 섹션별 개수를 section_totals에 담아 돌려줘요.
curl -sS \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
"https://www.socialcrawl.dev/v1/linkedin/profile/all?url=https://www.linkedin.com/in/jane-doe"읽을 값만 남기면 이런 모양이에요.
{
"data": {
"author": {
"display_name": "Jane Doe",
"username": "jane-doe",
"followers": 18250,
"following": 412,
"verified": false,
"joined_at": "2014-03-11",
"ext": { "followers_approximate": false }
},
"background": {
"summary": "이커머스 회사의 데이터 총괄",
"experiences": [
{ "title": "Head of Data", "company": "Example Co", "date": { "start": "2021", "end": "Present" } }
],
"educations": [],
"skills": [],
"recommendations": []
},
"similar_profiles": [],
"section_totals": { "experiences": 3, "educations": 2, "skills": 14, "recommendations": 1 }
}
}파싱하기 전에 알아 둘 필드가 네 개 있어요.
section_totals는 링크드인이 세는 섹션별 개수예요. 긴 섹션은 원본에서 잘려 오니 배열이 합계보다 짧을 때가 있어요. 개수는 배열 길이 말고 이 값으로 세요.author.ext.followers_approximate가 true면 팔로워 수가 반올림돼 온 거예요. 정확한 정수는GET /v1/linkedin/profile로 받아요.background.skills[].endorsements_is_floor가 true면 링크드인이 "99+"처럼 표시한 거라 숫자가 최솟값이에요.background.given_recommendations는 이 호출에 없어요. 회원이 쓴 추천서는profile/complete에 있어요.
같은 응답에 Featured, 자격증, 수상, 언어, 프로젝트, 출판물, 봉사, 수강, 특허, 소속 단체도 들어와요. background.interests는 Top Voices, 회사, 그룹, 학교, 뉴스레터로 나뉘어 와요. similar_profiles에는 "함께 본 프로필"이 최대 20명 담겨요. 배열이 비어 있으면 그 회원이 해당 섹션을 채우지 않은 거예요.
이 중 일곱 섹션은 따로 부를 수도 있어요. profile/languages, profile/projects, profile/patents, profile/organizations, profile/courses, profile/test-scores, profile/featured는 한 페이지에 20행씩 5크레딧이에요. 비어 있는 섹션은 무료예요. 스킬 하나를 추천한 회원 목록은 profile/skills/endorsers로 받아요. 이것도 페이지당 20명, 5크레딧이에요.
링크드인 크롤링으로 최근 게시글은 어떻게 받나요?
같은 URL을 profile/with-posts에 넣으면 팔로워와 커넥션 수, 최근 게시글이 10크레딧으로 와요. background는 profile/all보다 짧아서 소개, 경력, 학력, 스킬만 있어요.
curl -sS \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
"https://www.socialcrawl.dev/v1/linkedin/profile/with-posts?url=https://www.linkedin.com/in/jane-doe"data.posts의 각 행은 post(본문, published_at, 좋아요와 댓글과 공유가 든 engagement)와 computed로 이뤄져요. author.posts_count는 null이라 게시글 수는 data.posts 길이로 세요. 반응 수를 팔로워 수로 나눠 한국 기업과 개인 계정의 참여율을 잰 결과는 한국 링크드인 참여율에 있어요.
키워드로 글을 찾을 때는 search/posts?query=...예요. limit 없이 부르면 10개짜리 한 페이지가 5크레딧이에요. limit을 1에서 200 사이로 주면 페이지를 알아서 넘기고 중복을 없앤 뒤, 돌려받은 게시글 5개당 1크레딧을 받아요. limit은 page, cursor와 같이 쓸 수 없어요. 검색 쪽은 링크드인 포스트 API에 자세히 있어요.
링크드인 프로필 수집, 여러 명을 한 번에 할 수 있나요?
돼요. urls에 전체 프로필 URL을 쉼표로 이어 최대 10개까지 넣으면 {items, total}로 와요. 돌려받은 프로필 하나당 5크레딧이에요. 중복 URL은 호출 전에 하나로 합쳐져요. 못 찾은 프로필은 청구하지 않아요. 중복이나 없는 계정이 섞인 목록은 넣은 개수보다 적게 나와요.
curl -sS \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
"https://www.socialcrawl.dev/v1/linkedin/profile/all?urls=https://www.linkedin.com/in/jane-doe,https://www.linkedin.com/in/john-roe"응답 모양이 한 명 조회와 달라요. url=일 때 data.author와 data.background는 data 바로 아래에 있어요. urls=일 때는 각 프로필이 data.items의 행이에요. 한 명용 코드로 data.author만 읽으면 일괄 응답에서 작성자를 못 찾아요.
없는 회원을 조회하면 어떻게 되나요?
0크레딧으로 404를 돌려줘요. profile, profile/experiences, profile/educations, profile/all 모두 같아요. 빈 경력 배열로 오지 않으니 404를 "경력이 없는 사람"으로 저장하지 말고 "없는 회원"으로 처리하세요. urls로 보냈는데 하나도 조회되지 않았을 때도 0크레딧 404예요.
링크드인 공식 Profile API와는 무엇이 다른가요?
쓰임새가 달라요. Microsoft Profile API는 승인받은 개발자가 로그인한 회원의 토큰으로 쓰는 API예요. 샘플 호출 GET https://api.linkedin.com/v2/me는 그 회원의 이름, 헤드라인, 바니티 네임, id, 사진을 돌려줘요. 공개된 기본 프로필 필드 목록에는 경력, 학력, 스킬, 게시글이 없어요.
공개 URL로 다른 회원을 조회하는 흐름은 그 샘플에 없어요. 같은 문서는 인증한 회원 본인이 아닌 회원의 Profile API 데이터를 저장하지 말라고 안내해요. 승인받은 앱 안에서 회원 본인의 기본 필드만 필요하면 공식 API가 맞아요. 공개 /in/ URL에서 시작해 파싱된 이력을 받고 싶으면 profile/all이에요.
링크드인 프로필 API가 하지 못하는 것은 무엇인가요?
- 공개 프로필 데이터만 읽어요. 쪽지, 커넥션 목록, 회원이 비공개로 둔 정보는 못 읽어요.
profile/all에는 게시글 배열이 없어요. 게시글은profile/with-posts나profile/posts로 따로 받아요.- 긴 섹션은 잘려 와요. 배열이
section_totals보다 짧을 때가 있어요. - 연락처는 회원이 공개한 경우에만 들어와요.
넓게 비교하고 싶다면 링크드인 API 개요와 프로필 게시글 아카이브를 참고하세요.
자주 묻는 질문
링크드인 스크래핑으로 스킬이랑 받은 추천도 같이 오나요?
profile/all에 스킬과 받은 추천이 들어와요. 다만 회원이 직접 쓴 추천서(given_recommendations)는 없고 profile/complete에서 받아요. 배열이 비어 있으면 그 회원이 해당 섹션을 채우지 않은 거예요.
링크드인 프로필 스크래핑 결과에 최근 게시글이 없나요?
profile/all에는 게시글이 없어요. author.posts_count도 null이에요. 최근 게시글은 profile/with-posts(10크레딧)나 profile/posts(50건까지 5크레딧)로 받아요.
여러 명 링크드인 프로필을 한 요청에 넣으면 중복은 어떻게 되나요?
urls는 최대 10개까지 받아요. 같은 URL은 호출 전에 하나로 합쳐져요. 돌려받은 프로필 하나에 5크레딧이에요. 못 찾은 프로필은 청구하지 않아요.
없는 링크드인 회원은 404인가요, 빈 경력인가요?
404예요. profile, profile/experiences, profile/educations, profile/all은 없는 회원이면 0크레딧으로 404를 돌려줘요. 빈 경력과 구분해서 처리하세요.
키워드로 링크드인 게시글을 찾는 건 프로필 호출과 같은가요?
달라요. search/posts?query=...는 회원이 아니라 키워드로 게시글을 찾는 호출이에요. limit을 1에서 200 사이로 주면 5개에 1크레딧, limit 없이 부르면 페이지당 5크레딧이에요.
함께 읽으면 좋은 글
페이스북 댓글 크롤링, 게시물 25개를 한 번에 읽어요
페이스북, 인스타그램, 틱톡, 유튜브 게시물 25개의 댓글을 API 호출 한 번으로 읽어요. since를 넣으면 새 댓글만 읽고 새 댓글이 없으면 크레딧도 들지 않아요.
인플루언서 검색 API: 팔로워가 아니라 조회수로 크리에이터 고르기
인플루언서 검색 API 한 번으로 주제와 국가, 규모에 맞는 크리에이터를 찾아요. 최근 게시물에서 잰 중간 조회수로 순위를 매기고 드라이런으로 비용도 미리 확인해요.
틱톡과 유튜브 이메일 찾기 API, include=contacts 한 줄로
프로필 호출에 include=contacts를 붙이면 크리에이터가 공개한 비즈니스 이메일과 출처가 와요. 결과 상태 다섯 가지와 재시도, 크레딧 규칙까지 담았어요.
