# 링크드인 회사 조회 링크드인 회사 주소로 회사명·소개·업종·규모·본사·팔로워·임직원 수·특기·최근 소식을 조회합니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/linkedin_company 응답 필드 - `data` (object): 조회 데이터. 실패하면 error 에 안내 문구가 담깁니다. - `data.company_id` (string): 회사 아이디 - `data.name` (string): 회사명 - `data.about` (string): 소개 - `data.description` (string): 설명 - `data.website` (string): 홈페이지 - `data.industries` (string): 업종 - `data.company_size` (string): 규모 구간 - `data.organization_type` (string): 조직 형태 - `data.founded` (integer): 설립 연도 - `data.followers` (integer): 팔로워 수 - `data.employees_on_linkedin` (integer): 링크드인 등록 임직원 수 - `data.headquarters` (string): 본사 - `data.locations` (array): 지역 목록 - `data.specialties` (string): 특기·전문 분야 - `data.logo` (string): 로고 주소 - `data.url` (string): 회사 페이지 주소 - `data.updates` (array): 최근 소식(title·link·date·text) - `api` (object): API 호출 공통 데이터 - `api.success` (boolean): API 서버 정상 응답 여부 - `api.cost` (integer): 차감된 포인트. 실패한 응답은 0 - `api.pl_id` (integer): API 결제 로그 ID - `api.ms` (integer): API 응답 시간(밀리초) ## API 요청: POST /rest/linkedin_company ### 입력 - `url` (string, 필수): 링크드인 회사 주소 (예: https://www.linkedin.com/company/{아이디}) ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "company_id": { "type": "string", "description": "회사 아이디" }, "name": { "type": "string", "description": "회사명" }, "about": { "type": "string", "description": "소개" }, "description": { "type": "string", "description": "설명" }, "website": { "type": "string", "description": "홈페이지" }, "industries": { "type": "string", "description": "업종" }, "company_size": { "type": "string", "description": "규모 구간" }, "organization_type": { "type": "string", "description": "조직 형태" }, "founded": { "type": "integer", "description": "설립 연도" }, "followers": { "type": "integer", "description": "팔로워 수" }, "employees_on_linkedin": { "type": "integer", "description": "링크드인 등록 임직원 수" }, "headquarters": { "type": "string", "description": "본사" }, "locations": { "type": "array", "items": { "type": "string" }, "description": "지역 목록" }, "specialties": { "type": "string", "description": "특기·전문 분야" }, "logo": { "type": "string", "description": "로고 주소" }, "url": { "type": "string", "description": "회사 페이지 주소" }, "updates": { "type": "array", "items": {}, "description": "최근 소식(title·link·date·text)" } }, "description": "조회 데이터. 실패하면 error 에 안내 문구가 담깁니다." }, "api": { "type": "object", "properties": { "success": { "type": "boolean", "description": "API 서버 정상 응답 여부" }, "cost": { "type": "integer", "description": "차감된 포인트. 실패한 응답은 0" }, "pl_id": { "type": "integer", "description": "API 결제 로그 ID" }, "ms": { "type": "integer", "description": "API 응답 시간(밀리초)" } }, "description": "API 호출 공통 데이터" } } } ``` ### 정적 응답 예시 ```json { "data": { "company_id": "microsoft", "name": "Microsoft", "about": "Every company has a mission. What's ours? To empower every person and every organization to achieve more.", "description": "Every company has a mission...", "website": "https://www.microsoft.com", "industries": "Software Development", "company_size": "10,001+ employees", "organization_type": "Public Company", "founded": 1975, "followers": 25000000, "employees_on_linkedin": 250000, "headquarters": "Redmond, Washington, US", "locations": [ "1 Microsoft Way Redmond, Washington 98052, US" ], "specialties": "Business Software, Cloud Computing", "logo": "https://media.licdn.com/...", "url": "https://www.linkedin.com/company/microsoft", "updates": [] }, "api": { "success": true, "cost": 30, "pl_id": 1595635, "ms": 4100 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/linkedin_company' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form-string 'url=https://www.linkedin.com/company/microsoft' ``` ### Node.js (서버 ESM) ```javascript const form = new FormData(); form.append("url", "https://www.linkedin.com/company/microsoft"); const response = await fetch("https://apick.app/rest/linkedin_company", { method: "POST", headers: { Authorization: "Bearer " + process.env.APICK_API_KEY }, body: form, signal: AbortSignal.timeout(120_000), }); if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`); const result = await response.json(); console.log(result); ``` ### python ```python import os import requests parts = [ ("url", (None, "https://www.linkedin.com/company/microsoft")), ] response = requests.request("POST", "https://apick.app/rest/linkedin_company", headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, files=parts, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php 'https://www.linkedin.com/company/microsoft', ]; $curl = curl_init('https://apick.app/rest/linkedin_company'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => $headers, CURLOPT_POSTFIELDS => $form, CURLOPT_RETURNTRANSFER => true, CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120, ]); $body = curl_exec($curl); if ($body === false) { throw new RuntimeException(curl_error($curl)); } $status = curl_getinfo($curl, CURLINFO_HTTP_CODE); curl_close($curl); if ($status >= 400) { throw new RuntimeException($body); } $result = json_decode($body, true, 512, JSON_THROW_ON_ERROR); print_r($result); ``` ## 코드·오류 ## 상세 기능·요금 Method URL POST https://apick.app/rest/linkedin_company 실패한 호출(입력 오류, 시간 초과, 대상 없음)은 과금하지 않습니다. 공개 회사 페이지 정보만 제공합니다. 보통 5~15초가 걸립니다. 최대 100초까지 기다립니다. 같은 요청은 최대 10분 동안 같은 결과가 반환될 수 있습니다. API 호출 요청 요청하기 Key Value url 응답 ## 상세 요청 Header 이름 필수 설명 Authorization O Bearer 인증키 ## 상세 응답 Body 이름 타입 설명 data Object 조회 데이터. 실패하면 error 에 안내 문구가 담깁니다. company_id String 회사 아이디 name String 회사명 about String 소개 description String 설명 website String 홈페이지 industries String 업종 company_size String 규모 구간 organization_type String 조직 형태 founded Integer 설립 연도 followers Integer 팔로워 수 employees_on_linkedin Integer 링크드인 등록 임직원 수 headquarters String 본사 locations Array 지역 목록 specialties String 특기·전문 분야 logo String 로고 주소 url String 회사 페이지 주소 updates Array 최근 소식(title·link·date·text) api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer 차감된 포인트. 실패한 응답은 0 ms Integer API 응답 시간(밀리초) pl_id Integer API 결제 로그 ID ## 상세 예제 요청 예시 form-data 전체 예제 보기 응답 예시 { "data": { "company_id": "microsoft", "name": "Microsoft", "about": "Every company has a mission. What's ours? To empower every person and every organization to achieve more.", "description": "Every company has a mission...", "website": "https://www.microsoft.com", "industries": "Software Development", "company_size": "10,001+ employees", "organization_type": "Public Company", "founded": 1975, "followers": 25000000, "employees_on_linkedin": 250000, "headquarters": "Redmond, Washington, US", "locations": [ "1 Microsoft Way Redmond, Washington 98052, US" ], "specialties": "Business Software, Cloud Computing", "logo": "https://media.licdn.com/...", "url": "https://www.linkedin.com/company/microsoft", "updates": [] }, "api": { "success": true, "cost": 30, "pl_id": 1595635, "ms": 4100 } }