API dữ liệu LinkedIn | Tài liệu API

# LinkedIn Data API

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.

```http
Authorization: Bearer YOUR_API_KEY
```

## 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.

```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/"
```

## 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.

[Complete reference](https://apihop.ai/en/docs/api-reference/linkedin/reference)

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

Đọc hồ sơ thành viên và công ty, bài đăng, chi tiết việc làm, kết quả tìm việc và bình luận qua 13 điểm cuối LinkedIn Web V2 có xác thực.

Xác thực

Gửi khóa API API Hop trong tiêu đề Authorization. Quyền truy cập phụ thuộc cổng đã bật và quyền của khóa; tài liệu không xác nhận khả dụng trên môi trường sản xuất.

http

Authorization: Bearer YOUR_API_KEY

Yêu cầu

Thao tác đồng bộ dùng tham số truy vấn GET, không có thân. Trường không rõ và trường vô hướng trùng lặp bị từ chối. Chỉ trường được đánh dấu là mảng chấp nhận khóa lặp lại, ví dụ company_ids=1035&company_ids=1441. Giữ ID và con trỏ dưới dạng chuỗi; không chuyển mã định danh lớn thành số JavaScript. Giá trị tùy chọn rỗng bị bỏ qua.

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/"

Tính phí

Với thao tác đồng bộ: Hồ sơ thành viên, hồ sơ công ty và chi tiết bài đăng có giá $0.008 (8000 tín dụng) mỗi yêu cầu thành công. Năm thao tác còn lại có giá $0.05 (50000 tín dụng). Đây là giá mặc định cho khách hàng; giá riêng của tài khoản được ưu tiên. Mỗi trang được yêu cầu tính phí riêng, không theo từng mục. Lỗi thượng nguồn giải phóng khoản giữ chỗ. Lỗi quyết toán không kích hoạt lời gọi thượng nguồn khác.

Phân trang và giới hạn

Với thao tác đồng bộ: Bài đăng thành viên chỉ trả 50 mục mới nhất: start và pagination_token không có tác dụng, ngay cả khi phản hồi chứa token. Bài đăng công ty dùng start=0, 50, 100, ...; pagination_token không có tác dụng. Tìm việc dùng start=0, 25, 50, .... Bình luận hỗ trợ page (bắt đầu từ 1) và pagination_token. Không có phân trang tự động. Yêu cầu hết thời gian sau 60 giây, không tự động thử lại. Nhà cung cấp cảnh báo giới hạn tài nguyên có thể gây lỗi gián đoạn.

Phạm vi

Có tám thao tác Web V2 đồng bộ và năm thao tác tác vụ bất đồng bộ. Tạo tác vụ hồ sơ, công ty hoặc bài đăng bằng POST và trường url trong JSON. Tạo tác vụ trả HTTP 202 và ID tác vụ nền tảng dạng chuỗi thập phân. Đọc trạng thái và kết quả bằng GET yêu cầu cùng bên thuê và miễn phí; tác vụ không rõ, thuộc bên thuê khác hoặc sản phẩm khác trả 404. Trạng thái bỏ trường result; result là null trước COMPLETED. Mỗi tác vụ giữ chỗ mức giá lúc tạo và tính phí một lần khi thành công (mặc định $0.008 / 8000 tín dụng). Thất bại hoặc hết thời gian 30 phút giải phóng khoản giữ chỗ. Truy vấn nền chạy mỗi 5 giây; phản hồi đang chờ có Retry-After: 5. Kết quả được lưu trong công việc nền tảng. Dùng ID nền tảng, không bao giờ dùng ID tác vụ nhà cung cấp. Lần gửi không chắc chắn không được tự động lặp lại. Tác vụ hoàn tất trả result.records. Số nguyên vượt phạm vi an toàn JavaScript được lưu và trả dưới dạng chuỗi thập phân. Ví dụ chỉ minh họa, không phải kết quả nghiệm thu trực tiếp.

Tham chiếu đầy đủ

Phản hồi

Với thao tác đồng bộ: Lớp bao JSON code/data gốc và độ chính xác số được giữ nguyên. Cấu trúc phản hồi khác nhau theo thao tác. Chỉ HTTP 200 không có nghĩa thành công: lỗi nghiệp vụ, gồm bản ghi error/error_code, bị từ chối. Kết quả rỗng thành công vẫn tính phí. Đây là phản hồi minh họa, không phải kết quả nghiệm thu trực tiếp.

json

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

Lỗi

HTTP 400: tham số không hợp lệ; 401: xác thực không hợp lệ; 402: thiếu tín dụng; 403: truy cập cổng bị từ chối; 405: phương thức không được hỗ trợ; 408: hủy; 429: giới hạn tốc độ; 502/503/504: lỗi nhà cung cấp, cấu hình không khả dụng hoặc hết thời gian. Giữ X-Request-Id để khắc phục.

Nguồn

Đã đối chiếu ngày 2026-10-31 với OpenAPI V5.3.2 chính thức và giá điểm cuối hiện hành. Các nguồn này mô tả hợp đồng và giá, không xác nhận mọi điểm cuối đã được kiểm chứng trực tiếp thành công.

TikHub · OpenAPI · Giá