API Hop

Tài liệu

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ườngBắt buộcHợp đồng
urlCóURL LinkedIn đầy đủ; 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/"

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ườngBắt buộcHợp đồng
urlCóURL LinkedIn đầy đủ; string
typeKhôngBài đăng, bài đã bình luận hoặc bài đã tương tác; string; posts, comments, reactions; Mặc định: posts
startKhôngĐộ lệch; áp dụng giới hạn điểm cuối; integer; >= 0
pagination_tokenKhôngToken phân trang; áp dụng giới hạn điểm cuối; 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/"

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ườngBắt buộcHợp đồng
urlCóURL LinkedIn đầy đủ; 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/"

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ườngBắt buộcHợp đồng
urlCóURL LinkedIn đầy đủ; string
startKhôngĐộ lệch; áp dụng giới hạn điểm cuối; integer; >= 0
pagination_tokenKhôngToken phân trang; áp dụng giới hạn điểm cuối; string
sort_byKhôngThứ tự sắp xếp; 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/"

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ườngBắt buộcHợp đồng
urlCóURL LinkedIn đầy đủ; string
include_skillsKhôngGồm kỹ năng yêu cầu; boolean; Mặc định: false
include_hiring_teamKhôngGồm nhóm tuyển dụng; boolean; Mặc định: 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

Giá mỗi yêu cầu thành công: $0.05 (50000 tín dụng).

TrườngBắt buộcHợp đồng
keywordsKhôngTừ khóa tìm kiếm; string
geo_codeKhôngID địa lý; 92000000 nghĩa là toàn cầu; integer; Mã định danh số nguyên chính xác
date_postedKhôngBộ lọc ngày đăng; string; Any time, Past month, Past week, Past 24 hours
experience_levelsKhôngMức kinh nghiệm; string[]; Khóa truy vấn lặp lại; Internship, Entry level, Associate, Mid-Senior level, Director, Executive
company_idsKhôngID công ty; integer[]; Khóa truy vấn lặp lại; Mã định danh số nguyên chính xác
title_idsKhôngID chức danh; integer[]; Khóa truy vấn lặp lại; Mã định danh số nguyên chính xác
onsite_remotesKhôngLoại nơi làm việc; string[]; Khóa truy vấn lặp lại; On-site, Remote, Hybrid
functionsKhôngChức năng công việc; string[]; Khóa truy vấn lặp lại
industriesKhôngNgành nghề; string[]; Khóa truy vấn lặp lại
job_typesKhôngLoạ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_byKhôngThứ tự sắp xếp; string; Most relevant, Most recent
easy_applyKhôngChỉ ứng tuyển nhanh; boolean; Mặc định: false
under_10_applicantsKhôngChỉ dưới 10 ứng viên; boolean; Mặc định: false
startKhôngĐộ lệch; áp dụng giới hạn điểm cuối; 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"

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ườngBắt buộcHợp đồng
urlCóURL LinkedIn đầy đủ; 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"

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ườngBắt buộcHợp đồng
urnCóURN hoạt động bài đăng; string
sort_byKhôngThứ tự sắp xếp; string; Most relevant, Most recent
pageKhôngSố trang, bắt đầu từ 1; integer; >= 1
pagination_tokenKhôngToken phân trang; áp dụng giới hạn điểm cuối; string
share_urnKhôngURN chia sẻ cho bài đăng được chia sẻ; string
bash
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ườngBắt buộcHợp đồng
urlCóURL LinkedIn đầy đủ; 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"}

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ườngBắt buộcHợp đồng
urlCóURL LinkedIn đầy đủ; 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"}

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ườngBắt buộcHợp đồng
urlCóURL LinkedIn đầy đủ; 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"}

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ườngBắt buộcHợp đồng
task_idCó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
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"}

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ườngBắt buộcHợp đồng
task_idCó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
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"}

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á