LinkedIn 엔드포인트 참조 | API 문서

# LinkedIn endpoint reference

Read member and company profiles, posts, job details, job search results, and comments through 13 authenticated LinkedIn Web V2 endpoints.

## Authentication

Send your API Hop API key in the Authorization header. Access depends on enabled gateways and your key permissions; documentation does not confirm production availability.

## Requests

Synchronous operations use GET query parameters without a body. Unknown fields and duplicate scalar fields are rejected. Only fields marked as arrays accept repeated keys, for example company_ids=1035&company_ids=1441. Preserve IDs and cursors as strings; do not convert large identifiers to JavaScript numbers. Optional empty values are omitted.

## Billing

For synchronous operations: Member profiles, company profiles, and post details cost $0.008 (8000 credits) per successful request. The other five operations cost $0.05 (50000 credits). These are default customer prices; account-specific prices take precedence. Every requested page is billed separately, not per item. Upstream failures release the reservation. Settlement failures do not trigger another upstream call.

## Pagination and limits

For synchronous operations: Member posts return only the latest 50 items: start and pagination_token have no effect, even when the response contains a token. Company posts use start=0, 50, 100, ...; pagination_token has no effect. Job search uses start=0, 25, 50, .... Comments support page (starting at 1) and pagination_token. There is no automatic pagination. Requests time out after 60 seconds with no automatic retries. The supplier warns that resource constraints can cause intermittent failures.

## Scope

Eight synchronous Web V2 operations and five asynchronous task operations are available. Create profile, company, or post tasks with POST and a JSON url field. Creation returns HTTP 202 and a decimal platform task ID as a string. GET status and result reads require the same tenant and are free; unknown, foreign-tenant, and other-product tasks return 404. Status omits result; result is null before COMPLETED. Each task reserves its price at creation and charges once on success ($0.008 / 8000 credits by default). Failure or a 30-minute timeout releases the reservation. Background polling runs every 5 seconds; pending responses include Retry-After: 5. Results are stored in the platform job. Use the platform ID, never a supplier task ID. An uncertain submission is not automatically repeated. A completed task returns result.records. Integers beyond the JavaScript safe range are stored and returned as decimal strings. Examples are illustrative, not live acceptance results.

### Member profile

`web_v2-get_user_profile`

`GET https://api.apihop.ai/v1/linkedin/web-v2/users/profile`

Price per successful request: **$0.008** (8000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/users/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/in/williamhgates/"
```

### Member posts

`web_v2-get_user_posts`

`GET https://api.apihop.ai/v1/linkedin/web-v2/users/posts`

Price per successful request: **$0.05** (50000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |
| `type` | No | Posts, commented posts, or reacted posts; `string`; `posts`, `comments`, `reactions`; Default: `posts` |
| `start` | No | Offset; endpoint limits apply; `integer`; >= 0 |
| `pagination_token` | No | Pagination token; endpoint limits apply; `string` |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/users/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/in/williamhgates/"
```

### Company profile

`web_v2-get_company_profile`

`GET https://api.apihop.ai/v1/linkedin/web-v2/companies/profile`

Price per successful request: **$0.008** (8000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/companies/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/company/microsoft/"
```

### Company posts

`web_v2-get_company_posts`

`GET https://api.apihop.ai/v1/linkedin/web-v2/companies/posts`

Price per successful request: **$0.05** (50000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |
| `start` | No | Offset; endpoint limits apply; `integer`; >= 0 |
| `pagination_token` | No | Pagination token; endpoint limits apply; `string` |
| `sort_by` | No | Sort order; `string`; `top`, `recent` |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/companies/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/company/microsoft/"
```

### Job details

`web_v2-get_job_detail`

`GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail`

Price per successful request: **$0.05** (50000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |
| `include_skills` | No | Include required skills; `boolean`; Default: `false` |
| `include_hiring_team` | No | Include hiring team; `boolean`; Default: `false` |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/jobs/view/software-engineer-at-pave-4310512612/"
```

### Job search

`web_v2-search_jobs`

`GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/search`

Price per successful request: **$0.05** (50000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `keywords` | No | Search keywords; `string` |
| `geo_code` | No | Geographic ID; 92000000 means worldwide; `integer`; Exact integer identifier |
| `date_posted` | No | Posting date filter; `string`; `Any time`, `Past month`, `Past week`, `Past 24 hours` |
| `experience_levels` | No | Experience levels; `string[]`; Repeated query key; `Internship`, `Entry level`, `Associate`, `Mid-Senior level`, `Director`, `Executive` |
| `company_ids` | No | Company IDs; `integer[]`; Repeated query key; Exact integer identifier |
| `title_ids` | No | Job title IDs; `integer[]`; Repeated query key; Exact integer identifier |
| `onsite_remotes` | No | Workplace types; `string[]`; Repeated query key; `On-site`, `Remote`, `Hybrid` |
| `functions` | No | Job functions; `string[]`; Repeated query key |
| `industries` | No | Industries; `string[]`; Repeated query key |
| `job_types` | No | Employment types; `string[]`; Repeated query key; `Full-time`, `Part-time`, `Contract`, `Temporary`, `Internship`, `Volunteer` |
| `sort_by` | No | Sort order; `string`; `Most relevant`, `Most recent` |
| `easy_apply` | No | Easy Apply only; `boolean`; Default: `false` |
| `under_10_applicants` | No | Fewer than 10 applicants only; `boolean`; Default: `false` |
| `start` | No | Offset; endpoint limits apply; `integer`; >= 0 |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/jobs/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keywords=data analyst" \
  --data-urlencode "company_ids=1035" \
  --data-urlencode "company_ids=1441"
```

### Post details

`web_v2-get_post_detail`

`GET https://api.apihop.ai/v1/linkedin/web-v2/posts/detail`

Price per successful request: **$0.008** (8000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN"
```

### Post comments

`web_v2-get_post_comments`

`GET https://api.apihop.ai/v1/linkedin/web-v2/posts/comments`

Price per successful request: **$0.05** (50000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `urn` | Yes | Post activity URN; `string` |
| `sort_by` | No | Sort order; `string`; `Most relevant`, `Most recent` |
| `page` | No | Page number, starting at 1; `integer`; >= 1 |
| `pagination_token` | No | Pagination token; endpoint limits apply; `string` |
| `share_urn` | No | Share URN for shared posts; `string` |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "urn=7267273010393358336"
```

### Create member profile task

`web_v2-create_user_profile_task`

`POST https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks`

Price per successful request: **$0.008** (8000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |

```bash
curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/in/williamhgates/"}'
```

```http
HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}
```

### Create company profile task

`web_v2-create_company_profile_task`

`POST https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks`

Price per successful request: **$0.008** (8000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |

```bash
curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/company/microsoft/"}'
```

```http
HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}
```

### Create post detail task

`web_v2-create_post_detail_task`

`POST https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks`

Price per successful request: **$0.008** (8000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `url` | Yes | Full LinkedIn URL; `string` |

```bash
curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN"}'
```

```http
HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}
```

### Task status

`web_v2-get_task_status`

`GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id`

Price per successful request: **$0** (0 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `task_id` | Yes | Platform task ID in the URL path; decimal string, not a supplier ID; `string`; Exact integer identifier |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```http
HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING"},"requestId":"example-request"}
```

### Task result

`web_v2-get_task_result`

`GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id/result`

Price per successful request: **$0** (0 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `task_id` | Yes | Platform task ID in the URL path; decimal string, not a supplier ID; `string`; Exact integer identifier |

```bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080/result" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```http
HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}
```

```json
{"success":true,"data":{"id":"3850699893338385742","status":"COMPLETED","result":{"records":[]}},"requestId":"example-request"}
```

## Responses

For synchronous operations: The native JSON code/data envelope and numeric precision are preserved. Response shapes vary by operation. HTTP 200 alone is not success: business errors, including error/error_code records, are rejected. A successful empty result is billable. This is an illustrative response, not a live acceptance result.

```json
{"code":200,"data":[]}
```

## Errors

HTTP 400: invalid parameters; 401: invalid authentication; 402: insufficient credit; 403: denied gateway access; 405: unsupported method; 408: cancellation; 429: rate limit; 502/503/504: supplier failure, unavailable configuration, or timeout. Keep X-Request-Id for troubleshooting.

## Sources

Checked on 2026-10-31 against the official OpenAPI V5.3.2 and current endpoint prices. These sources describe the contract and prices, not successful live verification of every endpoint.

[TikHub](https://docs.tikhub.io/4592766m0) · [OpenAPI](https://api.tikhub.io/openapi.json) · [Prices](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info)

인증이 필요한 LinkedIn Web V2 엔드포인트 13개에서 회원·기업 프로필, 게시물, 채용 공고, 검색 결과 및 댓글을 조회합니다.

인증

Authorization 헤더에 API Hop API 키를 보내세요. 접근 가능 여부는 활성 게이트웨이와 키 권한에 따라 달라지며, 이 문서는 운영 환경 제공 여부를 보장하지 않습니다.

요청

동기 작업은 본문 없이 GET 쿼리 매개변수를 사용합니다. 알 수 없는 필드와 중복된 스칼라 필드는 거부됩니다. 배열로 표시된 필드만 company_ids=1035&company_ids=1441처럼 같은 키를 반복할 수 있습니다. ID와 커서를 문자열로 보존하고 큰 ID를 JavaScript 숫자로 변환하지 마세요. 선택 항목의 빈 값은 생략됩니다.

과금

동기 작업: 회원 프로필, 기업 프로필 및 게시물 상세는 성공한 요청당 $0.008(8000 credits)이며 나머지 5개 작업은 $0.05(50000 credits)입니다. 이는 기본 고객 가격이며 계정별 가격이 우선합니다. 항목별이 아니라 요청한 각 페이지별로 과금합니다. 공급자 호출 실패 시 예약 금액을 해제하며 정산 오류 시 공급자를 다시 호출하지 않습니다.

페이지 처리 및 제한

동기 작업: 회원 게시물은 최신 50개만 반환합니다. 응답에 토큰이 있어도 start와 pagination_token은 효과가 없습니다. 기업 게시물은 start=0, 50, 100, ...을 사용하며 pagination_token은 효과가 없습니다. 채용 검색은 start=0, 25, 50, ...을 사용합니다. 댓글은 1부터 시작하는 page와 pagination_token을 지원합니다. 자동 페이지 처리와 자동 재시도는 없으며 시간 제한은 60초입니다. 공급자의 자원 부족으로 간헐적 오류가 발생할 수 있습니다.

범위

동기식 Web V2 작업 8개와 비동기 작업 기능 5개를 제공합니다. url이 포함된 JSON을 POST하여 회원 프로필, 기업 프로필 또는 게시물 상세 작업을 생성합니다. HTTP 202와 문자열 형식의 플랫폼 10진수 작업 ID를 반환합니다. 상태 및 결과 GET 조회는 같은 테넌트에 한해 무료입니다. 존재하지 않거나 다른 테넌트 또는 제품의 작업은 404를 반환합니다. 상태에는 result가 없으며 COMPLETED 전 결과는 null입니다. 생성 시 요금을 예약하고 성공 시 한 번만 정산합니다(기본 $0.008 / 8000 credits). 실패 또는 30분 시간 초과 시 예약을 해제합니다. 백그라운드에서 5초마다 조회하며 처리 중 응답에는 Retry-After: 5가 포함됩니다. 결과는 플랫폼 작업에 저장됩니다. 공급자 ID를 사용하지 마세요. 제출 결과가 불확실하면 자동 재제출하지 않습니다. 완료된 작업은 result.records를 반환합니다. JavaScript 안전 범위를 벗어나는 정수는 10진수 문자열로 저장하고 반환합니다. 예시는 설명용이며 실제 검증 결과가 아닙니다.

회원 프로필

web_v2-get_user_profile

GET https://api.apihop.ai/v1/linkedin/web-v2/users/profile

성공한 요청당 가격: $0.008 (8000 credits).

필드	필수	규격
`url`	예	전체 LinkedIn URL; `string`

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/users/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/in/williamhgates/"

회원 게시물

web_v2-get_user_posts

GET https://api.apihop.ai/v1/linkedin/web-v2/users/posts

성공한 요청당 가격: $0.05 (50000 credits).

필드	필수	규격
`url`	예	전체 LinkedIn URL; `string`
`type`	아니요	작성한 게시물, 댓글을 단 게시물 또는 반응한 게시물; `string`; `posts`, `comments`, `reactions`; 기본값: `posts`
`start`	아니요	오프셋; 엔드포인트별 제한 적용; `integer`; >= 0
`pagination_token`	아니요	페이지 토큰; 엔드포인트별 제한 적용; `string`

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/users/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/in/williamhgates/"

기업 프로필

web_v2-get_company_profile

GET https://api.apihop.ai/v1/linkedin/web-v2/companies/profile

성공한 요청당 가격: $0.008 (8000 credits).

필드	필수	규격
`url`	예	전체 LinkedIn URL; `string`

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/companies/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/company/microsoft/"

기업 게시물

web_v2-get_company_posts

GET https://api.apihop.ai/v1/linkedin/web-v2/companies/posts

성공한 요청당 가격: $0.05 (50000 credits).

필드	필수	규격
`url`	예	전체 LinkedIn URL; `string`
`start`	아니요	오프셋; 엔드포인트별 제한 적용; `integer`; >= 0
`pagination_token`	아니요	페이지 토큰; 엔드포인트별 제한 적용; `string`
`sort_by`	아니요	정렬 순서; `string`; `top`, `recent`

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/companies/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/company/microsoft/"

채용 공고 상세

web_v2-get_job_detail

GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail

성공한 요청당 가격: $0.05 (50000 credits).

필드	필수	규격
`url`	예	전체 LinkedIn URL; `string`
`include_skills`	아니요	필수 기술 포함; `boolean`; 기본값: `false`
`include_hiring_team`	아니요	채용팀 포함; `boolean`; 기본값: `false`

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/jobs/view/software-engineer-at-pave-4310512612/"

채용 검색

web_v2-search_jobs

GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/search

성공한 요청당 가격: $0.05 (50000 credits).

필드	필수	규격
`keywords`	아니요	검색 키워드; `string`
`geo_code`	아니요	지역 ID; 92000000은 전 세계; `integer`; 정확한 정수 ID
`date_posted`	아니요	게시일 필터; `string`; `Any time`, `Past month`, `Past week`, `Past 24 hours`
`experience_levels`	아니요	경력 수준; `string[]`; 반복 쿼리 키; `Internship`, `Entry level`, `Associate`, `Mid-Senior level`, `Director`, `Executive`
`company_ids`	아니요	기업 ID; `integer[]`; 반복 쿼리 키; 정확한 정수 ID
`title_ids`	아니요	직무명 ID; `integer[]`; 반복 쿼리 키; 정확한 정수 ID
`onsite_remotes`	아니요	근무 장소 유형; `string[]`; 반복 쿼리 키; `On-site`, `Remote`, `Hybrid`
`functions`	아니요	직무 기능; `string[]`; 반복 쿼리 키
`industries`	아니요	업종; `string[]`; 반복 쿼리 키
`job_types`	아니요	고용 형태; `string[]`; 반복 쿼리 키; `Full-time`, `Part-time`, `Contract`, `Temporary`, `Internship`, `Volunteer`
`sort_by`	아니요	정렬 순서; `string`; `Most relevant`, `Most recent`
`easy_apply`	아니요	간편 지원만; `boolean`; 기본값: `false`
`under_10_applicants`	아니요	지원자 10명 미만만; `boolean`; 기본값: `false`
`start`	아니요	오프셋; 엔드포인트별 제한 적용; `integer`; >= 0

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/jobs/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keywords=data analyst" \
  --data-urlencode "company_ids=1035" \
  --data-urlencode "company_ids=1441"

게시물 상세

web_v2-get_post_detail

GET https://api.apihop.ai/v1/linkedin/web-v2/posts/detail

성공한 요청당 가격: $0.008 (8000 credits).

필드	필수	규격
`url`	예	전체 LinkedIn URL; `string`

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN"

게시물 댓글

web_v2-get_post_comments

GET https://api.apihop.ai/v1/linkedin/web-v2/posts/comments

성공한 요청당 가격: $0.05 (50000 credits).

필드	필수	규격
`urn`	예	게시물 activity URN; `string`
`sort_by`	아니요	정렬 순서; `string`; `Most relevant`, `Most recent`
`page`	아니요	1부터 시작하는 페이지 번호; `integer`; >= 1
`pagination_token`	아니요	페이지 토큰; 엔드포인트별 제한 적용; `string`
`share_urn`	아니요	공유 게시물의 share URN; `string`

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "urn=7267273010393358336"

회원 프로필 작업 생성

web_v2-create_user_profile_task

POST https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks

성공한 요청당 가격: $0.008 (8000 credits).

필드	필수	규격
`url`	예	전체 LinkedIn URL; `string`

bash

curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/in/williamhgates/"}'

http

HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}

기업 프로필 작업 생성

web_v2-create_company_profile_task

POST https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks

성공한 요청당 가격: $0.008 (8000 credits).

필드	필수	규격
`url`	예	전체 LinkedIn URL; `string`

bash

curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/company/microsoft/"}'

http

HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}

게시물 상세 작업 생성

web_v2-create_post_detail_task

POST https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks

성공한 요청당 가격: $0.008 (8000 credits).

필드	필수	규격
`url`	예	전체 LinkedIn URL; `string`

bash

curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN"}'

http

HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}

작업 상태

web_v2-get_task_status

GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id

성공한 요청당 가격: $0 (0 credits).

필드	필수	규격
`task_id`	예	URL 경로의 플랫폼 작업 ID. 10진수 문자열이며 공급자 ID는 사용할 수 없음; `string`; 정확한 정수 ID

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080" \
  -H "Authorization: Bearer YOUR_API_KEY"

http

HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING"},"requestId":"example-request"}

작업 결과

web_v2-get_task_result

GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id/result

성공한 요청당 가격: $0 (0 credits).

필드	필수	규격
`task_id`	예	URL 경로의 플랫폼 작업 ID. 10진수 문자열이며 공급자 ID는 사용할 수 없음; `string`; 정확한 정수 ID

bash

curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080/result" \
  -H "Authorization: Bearer YOUR_API_KEY"

http

HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}

json

{"success":true,"data":{"id":"3850699893338385742","status":"COMPLETED","result":{"records":[]}},"requestId":"example-request"}

응답

동기 작업: 원본 JSON code/data 구조와 숫자 정밀도를 보존합니다. 응답 구조는 작업마다 다릅니다. HTTP 200만으로 성공을 판단하지 않습니다. 업무 오류 및 error/error_code가 있는 오류 레코드는 거부됩니다. 성공한 빈 결과도 과금됩니다. 아래 예시는 설명용이며 실제 검증 결과가 아닙니다.

json

{"code":200,"data":[]}

오류

HTTP 400: 잘못된 매개변수; 401: 인증 실패; 402: 잔액 부족; 403: 게이트웨이 접근 거부; 405: 지원하지 않는 메서드; 408: 취소; 429: 요청 제한; 502/503/504: 공급자 오류, 설정 사용 불가 또는 시간 초과. 문제 해결을 위해 X-Request-Id를 보관하세요.

출처

2026-10-31에 공식 OpenAPI V5.3.2와 현재 엔드포인트 가격을 대조했습니다. 출처는 계약과 가격을 설명하며 모든 엔드포인트의 실제 호출 성공을 증명하지 않습니다.

TikHub · OpenAPI · 가격