مرجع نقاط نهاية 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)

اقرأ ملفات الأعضاء والشركات والمنشورات وتفاصيل الوظائف ونتائج البحث عن الوظائف والتعليقات عبر 13 نقطة نهاية LinkedIn Web V2 تتطلب المصادقة.

المصادقة

أرسل مفتاح API Hop API في ترويسة Authorization. يعتمد الوصول على البوابات المفعلة وصلاحيات مفتاحك؛ والوثائق لا تؤكد الإتاحة في الإنتاج.

الطلبات

تستخدم العمليات المتزامنة معاملات استعلام GET دون جسم. ترفض الحقول المجهولة والحقول المفردة المكررة. تقبل الحقول المعلمة كمصفوفات وحدها المفاتيح المتكررة، مثلا company_ids=1035&company_ids=1441. احفظ المعرفات والمؤشرات كسلاسل نصية؛ ولا تحول المعرفات الكبيرة إلى أرقام JavaScript. تحذف القيم الاختيارية الفارغة.

الفوترة

للعمليات المتزامنة: تكلف ملفات الأعضاء والشركات وتفاصيل المنشورات $0.008 (8000 رصيد) لكل طلب ناجح. وتكلف العمليات الخمس الأخرى $0.05 (50000 رصيد). هذه أسعار العملاء الافتراضية؛ ولأسعار الحساب الخاصة الأولوية. تحتسب كل صفحة مطلوبة بصورة مستقلة، وليس لكل عنصر. تحرر إخفاقات المزود المبلغ المحجوز. ولا تطلق إخفاقات التسوية استدعاء آخر إلى المزود.

ترقيم الصفحات والحدود

للعمليات المتزامنة: تعيد منشورات الأعضاء أحدث 50 عنصرا فقط؛ ولا يؤثر start وpagination_token حتى عندما تتضمن الاستجابة رمزا. تستخدم منشورات الشركات start=0, 50, 100, ...؛ ولا يؤثر pagination_token. يستخدم البحث عن الوظائف start=0, 25, 50, .... تدعم التعليقات page (بدءا من 1) وpagination_token. لا يوجد جلب تلقائي للصفحات. تنتهي مهلة الطلبات بعد 60 ثانية دون إعادة محاولات تلقائية. يحذر المزود من أن قيود الموارد قد تسبب إخفاقات متقطعة.

النطاق

تتوفر ثماني عمليات Web V2 متزامنة وخمس عمليات مهام غير متزامنة. أنشئ مهام الملفات أو الشركات أو المنشورات باستخدام POST وحقل url في JSON. يعيد الإنشاء HTTP 202 ومعرف مهمة المنصة العشري كسلسلة نصية. تتطلب قراءات الحالة والنتيجة بطريقة GET المستأجر نفسه وهي مجانية؛ وتعيد المهام المجهولة أو التابعة لمستأجر آخر أو منتج آخر 404. تحذف الحالة result؛ وتكون result بقيمة null قبل COMPLETED. تحجز كل مهمة سعرها عند الإنشاء وتحتسب مرة واحدة عند النجاح ($0.008 / 8000 رصيد افتراضيا). يحرر الإخفاق أو انتهاء مهلة 30 دقيقة المبلغ المحجوز. يجري الاستطلاع في الخلفية كل 5 ثوان؛ وتتضمن الاستجابات المعلقة Retry-After: 5. تخزن النتائج في مهمة المنصة. استخدم معرف المنصة، ولا تستخدم مطلقا معرف مهمة المزود. لا يعاد الإرسال غير المؤكد تلقائيا. تعيد المهمة المكتملة result.records. تخزن الأعداد الصحيحة التي تتجاوز نطاق JavaScript الآمن وتعاد كسلاسل عشرية. الأمثلة توضيحية، وليست نتائج قبول مباشرة.

ملف العضو

web_v2-get_user_profile

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

السعر لكل طلب ناجح: $0.008 (8000 رصيد).

الحقل	مطلوب	العقد
`url`	نعم	عنوان LinkedIn الكامل; `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 رصيد).

الحقل	مطلوب	العقد
`url`	نعم	عنوان LinkedIn الكامل; `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 رصيد).

الحقل	مطلوب	العقد
`url`	نعم	عنوان LinkedIn الكامل; `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 رصيد).

الحقل	مطلوب	العقد
`url`	نعم	عنوان LinkedIn الكامل; `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 رصيد).

الحقل	مطلوب	العقد
`url`	نعم	عنوان LinkedIn الكامل; `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 رصيد).

الحقل	مطلوب	العقد
`keywords`	لا	كلمات البحث; `string`
`geo_code`	لا	المعرف الجغرافي; 92000000 تعني العالم كله; `integer`; معرف عدد صحيح دقيق
`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`	لا	معرفات الشركات; `integer[]`; مفتاح استعلام متكرر; معرف عدد صحيح دقيق
`title_ids`	لا	معرفات المسميات الوظيفية; `integer[]`; مفتاح استعلام متكرر; معرف عدد صحيح دقيق
`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 رصيد).

الحقل	مطلوب	العقد
`url`	نعم	عنوان LinkedIn الكامل; `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 رصيد).

الحقل	مطلوب	العقد
`urn`	نعم	URN نشاط المنشور; `string`
`sort_by`	لا	ترتيب الفرز; `string`; `Most relevant`, `Most recent`
`page`	لا	رقم الصفحة، بدءا من 1; `integer`; >= 1
`pagination_token`	لا	رمز ترقيم الصفحات; تطبق حدود نقطة النهاية; `string`
`share_urn`	لا	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 رصيد).

الحقل	مطلوب	العقد
`url`	نعم	عنوان LinkedIn الكامل; `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 رصيد).

الحقل	مطلوب	العقد
`url`	نعم	عنوان LinkedIn الكامل; `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 رصيد).

الحقل	مطلوب	العقد
`url`	نعم	عنوان LinkedIn الكامل; `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 رصيد).

الحقل	مطلوب	العقد
`task_id`	نعم	معرف مهمة المنصة في مسار URL; سلسلة عشرية، وليست معرف المزود; `string`; معرف عدد صحيح دقيق

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 رصيد).

الحقل	مطلوب	العقد
`task_id`	نعم	معرف مهمة المنصة في مسار URL; سلسلة عشرية، وليست معرف المزود; `string`; معرف عدد صحيح دقيق

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 · الأسعار