Tài liệu API Hop
Tham chiếu điểm cuối LinkedIn
>-
Đọ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.
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.
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.
Hồ sơ thành viên
web_v2-get_user_profile
GET https://api.apihop.ai/v1/linkedin/web-v2/users/profile
Giá mỗi yêu cầu thành công: $0.008 (8000 tín dụng).
| Trường | Bắt buộc | Hợp đồng |
|---|---|---|
url | Có | URL LinkedIn đầy đủ; string |
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/"Bài đăng thành viên
web_v2-get_user_posts
GET https://api.apihop.ai/v1/linkedin/web-v2/users/posts
Giá mỗi yêu cầu thành công: $0.05 (50000 tín dụng).
| Trường | Bắt buộc | Hợp đồng |
|---|---|---|
url | Có | URL LinkedIn đầy đủ; string |
type | Không | Bài đăng, bài đã bình luận hoặc bài đã tương tác; string; posts, comments, reactions; Mặc định: posts |
start | Không | Độ lệch; áp dụng giới hạn điểm cuối; integer; >= 0 |
pagination_token | Không | Token phân trang; áp dụng giới hạn điểm cuối; string |
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/"Hồ sơ công ty
web_v2-get_company_profile
GET https://api.apihop.ai/v1/linkedin/web-v2/companies/profile
Giá mỗi yêu cầu thành công: $0.008 (8000 tín dụng).
| Trường | Bắt buộc | Hợp đồng |
|---|---|---|
url | Có | URL LinkedIn đầy đủ; string |
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/"Bài đăng công ty
web_v2-get_company_posts
GET https://api.apihop.ai/v1/linkedin/web-v2/companies/posts
Giá mỗi yêu cầu thành công: $0.05 (50000 tín dụng).
| Trường | Bắt buộc | Hợp đồng |
|---|---|---|
url | Có | URL LinkedIn đầy đủ; string |
start | Không | Độ lệch; áp dụng giới hạn điểm cuối; integer; >= 0 |
pagination_token | Không | Token phân trang; áp dụng giới hạn điểm cuối; string |
sort_by | Không | Thứ tự sắp xếp; string; top, recent |
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/"Chi tiết việc làm
web_v2-get_job_detail
GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail
Giá mỗi yêu cầu thành công: $0.05 (50000 tín dụng).
| Trường | Bắt buộc | Hợp đồng |
|---|---|---|
url | Có | URL LinkedIn đầy đủ; string |
include_skills | Không | Gồm kỹ năng yêu cầu; boolean; Mặc định: false |
include_hiring_team | Không | Gồm nhóm tuyển dụng; boolean; Mặc định: false |
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/"Tìm việc
web_v2-search_jobs
GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/search
Giá mỗi yêu cầu thành công: $0.05 (50000 tín dụng).
| Trường | Bắt buộc | Hợp đồng |
|---|---|---|
keywords | Không | Từ khóa tìm kiếm; string |
geo_code | Không | ID địa lý; 92000000 nghĩa là toàn cầu; integer; Mã định danh số nguyên chính xác |
date_posted | Không | Bộ lọc ngày đăng; string; Any time, Past month, Past week, Past 24 hours |
experience_levels | Không | Mức kinh nghiệm; string[]; Khóa truy vấn lặp lại; Internship, Entry level, Associate, Mid-Senior level, Director, Executive |
company_ids | Không | ID công ty; integer[]; Khóa truy vấn lặp lại; Mã định danh số nguyên chính xác |
title_ids | Không | ID chức danh; integer[]; Khóa truy vấn lặp lại; Mã định danh số nguyên chính xác |
onsite_remotes | Không | Loại nơi làm việc; string[]; Khóa truy vấn lặp lại; On-site, Remote, Hybrid |
functions | Không | Chức năng công việc; string[]; Khóa truy vấn lặp lại |
industries | Không | Ngành nghề; string[]; Khóa truy vấn lặp lại |
job_types | Không | Loại hình việc làm; string[]; Khóa truy vấn lặp lại; Full-time, Part-time, Contract, Temporary, Internship, Volunteer |
sort_by | Không | Thứ tự sắp xếp; string; Most relevant, Most recent |
easy_apply | Không | Chỉ ứng tuyển nhanh; boolean; Mặc định: false |
under_10_applicants | Không | Chỉ dưới 10 ứng viên; boolean; Mặc định: false |
start | Không | Độ lệch; áp dụng giới hạn điểm cuối; integer; >= 0 |
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"Chi tiết bài đăng
web_v2-get_post_detail
GET https://api.apihop.ai/v1/linkedin/web-v2/posts/detail
Giá mỗi yêu cầu thành công: $0.008 (8000 tín dụng).
| Trường | Bắt buộc | Hợp đồng |
|---|---|---|
url | Có | URL LinkedIn đầy đủ; string |
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"Bình luận bài đăng
web_v2-get_post_comments
GET https://api.apihop.ai/v1/linkedin/web-v2/posts/comments
Giá mỗi yêu cầu thành công: $0.05 (50000 tín dụng).
| Trường | Bắt buộc | Hợp đồng |
|---|---|---|
urn | Có | URN hoạt động bài đăng; string |
sort_by | Không | Thứ tự sắp xếp; string; Most relevant, Most recent |
page | Không | Số trang, bắt đầu từ 1; integer; >= 1 |
pagination_token | Không | Token phân trang; áp dụng giới hạn điểm cuối; string |
share_urn | Không | URN chia sẻ cho bài đăng được chia sẻ; string |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/comments" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "urn=7267273010393358336"Tạo tác vụ hồ sơ thành viên
web_v2-create_user_profile_task
POST https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks
Giá mỗi yêu cầu thành công: $0.008 (8000 tín dụng).
| Trường | Bắt buộc | Hợp đồng |
|---|---|---|
url | Có | URL LinkedIn đầy đủ; string |
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/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"}Tạo tác vụ hồ sơ công ty
web_v2-create_company_profile_task
POST https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks
Giá mỗi yêu cầu thành công: $0.008 (8000 tín dụng).
| Trường | Bắt buộc | Hợp đồng |
|---|---|---|
url | Có | URL LinkedIn đầy đủ; string |
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/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"}Tạo tác vụ chi tiết bài đăng
web_v2-create_post_detail_task
POST https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks
Giá mỗi yêu cầu thành công: $0.008 (8000 tín dụng).
| Trường | Bắt buộc | Hợp đồng |
|---|---|---|
url | Có | URL LinkedIn đầy đủ; string |
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/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"}Trạng thái tác vụ
web_v2-get_task_status
GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id
Giá mỗi yêu cầu thành công: $0 (0 tín dụng).
| Trường | Bắt buộc | Hợp đồng |
|---|---|---|
task_id | Có | ID tác vụ nền tảng trong đường dẫn URL; chuỗi thập phân, không phải ID nhà cung cấp; string; Mã định danh số nguyên chính xác |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080" \
-H "Authorization: Bearer YOUR_API_KEY"HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json
{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING"},"requestId":"example-request"}Kết quả tác vụ
web_v2-get_task_result
GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id/result
Giá mỗi yêu cầu thành công: $0 (0 tín dụng).
| Trường | Bắt buộc | Hợp đồng |
|---|---|---|
task_id | Có | ID tác vụ nền tảng trong đường dẫn URL; chuỗi thập phân, không phải ID nhà cung cấp; string; Mã định danh số nguyên chính xác |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080/result" \
-H "Authorization: Bearer YOUR_API_KEY"HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json
{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}{"success":true,"data":{"id":"3850699893338385742","status":"COMPLETED","result":{"records":[]}},"requestId":"example-request"}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.
{"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.