مرجع نقاط نهاية Lemon8 | وثائق API

# Lemon8 endpoint reference

Read Lemon8 profiles, posts, comments, followers, discovery, topics and search results, and resolve shared links through 16 authenticated endpoints.

Use your API Hop API key. Availability depends on enabled gateways and key permissions; these documents do not confirm production availability.

GET operations accept query parameters without a body. The two POST batch endpoints accept a JSON array of 1 to 10 nonempty share-link strings, with no query parameters. Use Content-Type: application/json. The body limit is 64 KiB. Unknown or repeated query fields are rejected. Preserve IDs and cursors as strings. Search uses query, not keyword. Requests time out after 60 seconds and are not retried automatically.

The default price is $0.001 (1000 credits) per successful request, including one batch request of up to 10 links. Account-specific prices take precedence. Each page is a separate request; use the cursor from the preceding response. There is no automatic pagination. Failed upstream requests release the reservation. Settlement failures do not repeat the upstream request.

## User profile

`app-fetch_user_profile`

`GET https://api.apihop.ai/v1/lemon8/app/users/profile`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Description | Default | Example |
| --- | --- | --- | --- | --- |
| `user_id` | Yes | User ID; `string` | - | `"7217844966059656197"` |

```bash
curl --get "https://api.apihop.ai/v1/lemon8/app/users/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=7217844966059656197"
```

## Post detail

`app-fetch_post_detail`

`GET https://api.apihop.ai/v1/lemon8/app/posts/detail`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Description | Default | Example |
| --- | --- | --- | --- | --- |
| `item_id` | Yes | Post ID; `string` | - | `"7361926875709129222"` |

```bash
curl --get "https://api.apihop.ai/v1/lemon8/app/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "item_id=7361926875709129222"
```

## User followers

`app-fetch_user_follower_list`

`GET https://api.apihop.ai/v1/lemon8/app/users/followers`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Description | Default | Example |
| --- | --- | --- | --- | --- |
| `user_id` | Yes | User ID; `string` | - | `"7428056850216862763"` |
| `cursor` | No | Pagination cursor from the previous response; `string` | `""` | `""` |

```bash
curl --get "https://api.apihop.ai/v1/lemon8/app/users/followers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=7428056850216862763"
```

## User following

`app-fetch_user_following_list`

`GET https://api.apihop.ai/v1/lemon8/app/users/following`

Price per successful request: **$0.001** (1000 credits).

```bash
curl --get "https://api.apihop.ai/v1/lemon8/app/users/following" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=7428056850216862763"
```

## Post comments

`app-fetch_post_comment_list`

`GET https://api.apihop.ai/v1/lemon8/app/posts/comments`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Description | Default | Example |
| --- | --- | --- | --- | --- |
| `group_id` | Yes | Post group ID; `string` | - | `"7361926875709129222"` |
| `item_id` | Yes | Post ID; `string` | - | `"7361926875709129222"` |
| `media_id` | Yes | Post media ID; `string` | - | `"7428056850216862763"` |
| `offset` | No | Pagination offset; `string` | `"0"` | `"0"` |

```bash
curl --get "https://api.apihop.ai/v1/lemon8/app/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "group_id=7361926875709129222" \
  --data-urlencode "item_id=7361926875709129222" \
  --data-urlencode "media_id=7428056850216862763"
```

## Discover banners

`app-fetch_discover_banners`

`GET https://api.apihop.ai/v1/lemon8/app/discover/banners`

Price per successful request: **$0.001** (1000 credits).

No query parameters.

```bash
curl --get "https://api.apihop.ai/v1/lemon8/app/discover/banners" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Discover content

`app-fetch_discover_tab`

`GET https://api.apihop.ai/v1/lemon8/app/discover`

Price per successful request: **$0.001** (1000 credits).

No query parameters.

```bash
curl --get "https://api.apihop.ai/v1/lemon8/app/discover" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Editor’s picks

`app-fetch_discover_tab_information_tabs`

`GET https://api.apihop.ai/v1/lemon8/app/discover/editors-picks`

Price per successful request: **$0.001** (1000 credits).

No query parameters.

```bash
curl --get "https://api.apihop.ai/v1/lemon8/app/discover/editors-picks" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Trending search terms

`app-fetch_hot_search_keywords`

`GET https://api.apihop.ai/v1/lemon8/app/search/trending`

Price per successful request: **$0.001** (1000 credits).

No query parameters.

```bash
curl --get "https://api.apihop.ai/v1/lemon8/app/search/trending" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Topic information

`app-fetch_topic_info`

`GET https://api.apihop.ai/v1/lemon8/app/topics/info`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Description | Default | Example |
| --- | --- | --- | --- | --- |
| `forum_id` | Yes | Topic ID; `string` | - | `"7174447913778593798"` |

```bash
curl --get "https://api.apihop.ai/v1/lemon8/app/topics/info" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "forum_id=7174447913778593798"
```

## Topic posts

`app-fetch_topic_post_list`

`GET https://api.apihop.ai/v1/lemon8/app/topics/posts`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Description | Default | Example |
| --- | --- | --- | --- | --- |
| `category` | Yes | Topic category ID; `string` | - | `"590"` |
| `max_behot_time` | No | Pagination cursor from the previous response; `string` | `""` | `""` |
| `category_parameter` | Yes | Topic category parameter; `string` | - | `"7174447913778593798"` |
| `hashtag_name` | Yes | Hashtag name; `string` | - | `"lemon8christmas"` |
| `sort_type` | No | Sort type; `string`; `enum`: `"0"` | `"0"` | - |

```bash
curl --get "https://api.apihop.ai/v1/lemon8/app/topics/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "category=590" \
  --data-urlencode "category_parameter=7174447913778593798" \
  --data-urlencode "hashtag_name=lemon8christmas"
```

## Search

`app-fetch_search`

`GET https://api.apihop.ai/v1/lemon8/app/search`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Description | Default | Example |
| --- | --- | --- | --- | --- |
| `query` | Yes | Search keyword; `string` | - | `"lemon8"` |
| `max_cursor` | No | Pagination cursor from the previous response; `string` | `""` | `""` |
| `filter_type` | No | Search filter; `string`; `enum`: `""`, `"video"`, `"posts"` | `""` | `""` |
| `order_by` | No | Search order; `string`; `enum`: `""`, `"popular"`, `"recent"` | `""` | `""` |
| `search_tab` | No | Search tab; `string`; `enum`: `"main"`, `"user"`, `"hashtag"`, `"article"` | `"main"` | `"main"` |

```bash
curl --get "https://api.apihop.ai/v1/lemon8/app/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=lemon8"
```

## Post ID from share link

`app-get_item_id`

`GET https://api.apihop.ai/v1/lemon8/app/posts/id`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Description | Default | Example |
| --- | --- | --- | --- | --- |
| `share_text` | Yes | Share link; `string` | - | `"https://v.lemon8-app.com/al/OghwFTppx"` |

```bash
curl --get "https://api.apihop.ai/v1/lemon8/app/posts/id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "share_text=https://v.lemon8-app.com/al/OghwFTppx"
```

## User ID from share link

`app-get_user_id`

`GET https://api.apihop.ai/v1/lemon8/app/users/id`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Description | Default | Example |
| --- | --- | --- | --- | --- |
| `share_text` | Yes | Share link; `string` | - | `"https://v.lemon8-app.com/al/OgZrsUppx"` |

```bash
curl --get "https://api.apihop.ai/v1/lemon8/app/users/id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "share_text=https://v.lemon8-app.com/al/OgZrsUppx"
```

## Post IDs from share links

`app-get_item_ids`

`POST https://api.apihop.ai/v1/lemon8/app/posts/ids`

Price per successful request: **$0.001** (1000 credits).

`body`: JSON array of 1 to 10 share-link strings.

```bash
curl -X POST "https://api.apihop.ai/v1/lemon8/app/posts/ids" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '["https://www.lemon8-app.com/@deathlabs_/7445613324903006766","https://v.lemon8-app.com/al/OghwFTppx"]'
```

## User IDs from share links

`app-get_user_ids`

`POST https://api.apihop.ai/v1/lemon8/app/users/ids`

Price per successful request: **$0.001** (1000 credits).

`body`: JSON array of 1 to 10 share-link strings.

```bash
curl -X POST "https://api.apihop.ai/v1/lemon8/app/users/ids" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '["https://www.lemon8-app.com/lemon8cars?region=us","https://v.lemon8-app.com/al/OgZrsUppx"]'
```

## Responses

The native JSON response and numeric precision are preserved. Success requires code=200 and non-null data; the data structure depends on the endpoint. Successful empty arrays or objects are billable. The response below is illustrative, not a live result.

```json
{"code":200,"data":{"user_id":"7217844966059656197"}}
```

## Errors

HTTP 400: invalid input; 401: authentication required; 402: insufficient credit; 403: access denied; 405: unsupported method; 429: rate limit; 5xx: service or upstream failure. An upstream HTTP 200 with a failed business code is a failure. Keep X-Request-Id for troubleshooting.

## Sources

All 16 operations and their prices were checked against the official OpenAPI and current endpoint price metadata on 2026-10-31. Documentation coverage does not mean every operation has passed a live test.

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

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

تقبل عمليات GET معاملات الاستعلام دون جسم. تقبل نقطتا نهاية الدفعات POST مصفوفة JSON من 1 إلى 10 سلاسل روابط مشاركة غير فارغة، دون معاملات استعلام. استخدم Content-Type: application/json. حد الجسم 64 KiB. ترفض حقول الاستعلام المجهولة أو المكررة. احفظ المعرفات والمؤشرات كسلاسل نصية. يستخدم البحث query، وليس keyword. تنتهي مهلة الطلبات بعد 60 ثانية ولا تعاد تلقائيا.

السعر الافتراضي $0.001 (1000 رصيد) لكل طلب ناجح، بما فيه طلب دفعة واحد يصل إلى 10 روابط. لأسعار الحساب الخاصة الأولوية. كل صفحة طلب مستقل؛ استخدم المؤشر من الاستجابة السابقة. لا يوجد جلب تلقائي للصفحات. تحرر طلبات المزود الفاشلة المبلغ المحجوز. ولا تكرر إخفاقات التسوية طلب المزود.

ملف المستخدم

app-fetch_user_profile

GET https://api.apihop.ai/v1/lemon8/app/users/profile

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

الحقل	مطلوب	الوصف	القيمة الافتراضية	مثال
`user_id`	نعم	معرف المستخدم; `string`	-	`"7217844966059656197"`

bash

curl --get "https://api.apihop.ai/v1/lemon8/app/users/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=7217844966059656197"

تفاصيل المنشور

app-fetch_post_detail

GET https://api.apihop.ai/v1/lemon8/app/posts/detail

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

الحقل	مطلوب	الوصف	القيمة الافتراضية	مثال
`item_id`	نعم	معرف المنشور; `string`	-	`"7361926875709129222"`

bash

curl --get "https://api.apihop.ai/v1/lemon8/app/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "item_id=7361926875709129222"

متابعو المستخدم

app-fetch_user_follower_list

GET https://api.apihop.ai/v1/lemon8/app/users/followers

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

الحقل	مطلوب	الوصف	القيمة الافتراضية	مثال
`user_id`	نعم	معرف المستخدم; `string`	-	`"7428056850216862763"`
`cursor`	لا	مؤشر الصفحات من الاستجابة السابقة; `string`	`""`	`""`

bash

curl --get "https://api.apihop.ai/v1/lemon8/app/users/followers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=7428056850216862763"

الحسابات التي يتابعها المستخدم

app-fetch_user_following_list

GET https://api.apihop.ai/v1/lemon8/app/users/following

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

الحقل	مطلوب	الوصف	القيمة الافتراضية	مثال
`user_id`	نعم	معرف المستخدم; `string`	-	`"7428056850216862763"`
`cursor`	لا	مؤشر الصفحات من الاستجابة السابقة; `string`	`""`	`""`

bash

curl --get "https://api.apihop.ai/v1/lemon8/app/users/following" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=7428056850216862763"

تعليقات المنشور

app-fetch_post_comment_list

GET https://api.apihop.ai/v1/lemon8/app/posts/comments

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

الحقل	مطلوب	الوصف	القيمة الافتراضية	مثال
`group_id`	نعم	معرف مجموعة المنشور; `string`	-	`"7361926875709129222"`
`item_id`	نعم	معرف المنشور; `string`	-	`"7361926875709129222"`
`media_id`	نعم	معرف وسائط المنشور; `string`	-	`"7428056850216862763"`
`offset`	لا	إزاحة الصفحات; `string`	`"0"`	`"0"`

bash

curl --get "https://api.apihop.ai/v1/lemon8/app/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "group_id=7361926875709129222" \
  --data-urlencode "item_id=7361926875709129222" \
  --data-urlencode "media_id=7428056850216862763"

لافتات الاكتشاف

app-fetch_discover_banners

GET https://api.apihop.ai/v1/lemon8/app/discover/banners

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

لا توجد معاملات استعلام.

bash

curl --get "https://api.apihop.ai/v1/lemon8/app/discover/banners" \
  -H "Authorization: Bearer YOUR_API_KEY"

محتوى الاكتشاف

app-fetch_discover_tab

GET https://api.apihop.ai/v1/lemon8/app/discover

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

لا توجد معاملات استعلام.

bash

curl --get "https://api.apihop.ai/v1/lemon8/app/discover" \
  -H "Authorization: Bearer YOUR_API_KEY"

اختيارات المحرر

app-fetch_discover_tab_information_tabs

GET https://api.apihop.ai/v1/lemon8/app/discover/editors-picks

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

لا توجد معاملات استعلام.

bash

curl --get "https://api.apihop.ai/v1/lemon8/app/discover/editors-picks" \
  -H "Authorization: Bearer YOUR_API_KEY"

app-fetch_hot_search_keywords

GET https://api.apihop.ai/v1/lemon8/app/search/trending

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

لا توجد معاملات استعلام.

bash

curl --get "https://api.apihop.ai/v1/lemon8/app/search/trending" \
  -H "Authorization: Bearer YOUR_API_KEY"

معلومات الموضوع

app-fetch_topic_info

GET https://api.apihop.ai/v1/lemon8/app/topics/info

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

الحقل	مطلوب	الوصف	القيمة الافتراضية	مثال
`forum_id`	نعم	معرف الموضوع; `string`	-	`"7174447913778593798"`

bash

curl --get "https://api.apihop.ai/v1/lemon8/app/topics/info" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "forum_id=7174447913778593798"

منشورات الموضوع

app-fetch_topic_post_list

GET https://api.apihop.ai/v1/lemon8/app/topics/posts

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

الحقل	مطلوب	الوصف	القيمة الافتراضية	مثال
`category`	نعم	معرف فئة الموضوع; `string`	-	`"590"`
`max_behot_time`	لا	مؤشر الصفحات من الاستجابة السابقة; `string`	`""`	`""`
`category_parameter`	نعم	معامل فئة الموضوع; `string`	-	`"7174447913778593798"`
`hashtag_name`	نعم	اسم الوسم; `string`	-	`"lemon8christmas"`
`sort_type`	لا	نوع الفرز; `string`; `enum`: `"0"`	`"0"`	-

bash

curl --get "https://api.apihop.ai/v1/lemon8/app/topics/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "category=590" \
  --data-urlencode "category_parameter=7174447913778593798" \
  --data-urlencode "hashtag_name=lemon8christmas"

البحث

app-fetch_search

GET https://api.apihop.ai/v1/lemon8/app/search

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

الحقل	مطلوب	الوصف	القيمة الافتراضية	مثال
`query`	نعم	كلمة البحث; `string`	-	`"lemon8"`
`max_cursor`	لا	مؤشر الصفحات من الاستجابة السابقة; `string`	`""`	`""`
`filter_type`	لا	مرشح البحث; `string`; `enum`: `""`, `"video"`, `"posts"`	`""`	`""`
`order_by`	لا	ترتيب البحث; `string`; `enum`: `""`, `"popular"`, `"recent"`	`""`	`""`
`search_tab`	لا	تبويب البحث; `string`; `enum`: `"main"`, `"user"`, `"hashtag"`, `"article"`	`"main"`	`"main"`

bash

curl --get "https://api.apihop.ai/v1/lemon8/app/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=lemon8"

app-get_item_id

GET https://api.apihop.ai/v1/lemon8/app/posts/id

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

الحقل	مطلوب	الوصف	القيمة الافتراضية	مثال
`share_text`	نعم	رابط المشاركة; `string`	-	`"https://v.lemon8-app.com/al/OghwFTppx"`

bash

curl --get "https://api.apihop.ai/v1/lemon8/app/posts/id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "share_text=https://v.lemon8-app.com/al/OghwFTppx"

app-get_user_id

GET https://api.apihop.ai/v1/lemon8/app/users/id

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

الحقل	مطلوب	الوصف	القيمة الافتراضية	مثال
`share_text`	نعم	رابط المشاركة; `string`	-	`"https://v.lemon8-app.com/al/OgZrsUppx"`

bash

curl --get "https://api.apihop.ai/v1/lemon8/app/users/id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "share_text=https://v.lemon8-app.com/al/OgZrsUppx"

app-get_item_ids

POST https://api.apihop.ai/v1/lemon8/app/posts/ids

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

body: مصفوفة JSON من 1 إلى 10 سلاسل روابط مشاركة.

bash

curl -X POST "https://api.apihop.ai/v1/lemon8/app/posts/ids" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '["https://www.lemon8-app.com/@deathlabs_/7445613324903006766","https://v.lemon8-app.com/al/OghwFTppx"]'

app-get_user_ids

POST https://api.apihop.ai/v1/lemon8/app/users/ids

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

body: مصفوفة JSON من 1 إلى 10 سلاسل روابط مشاركة.

bash

curl -X POST "https://api.apihop.ai/v1/lemon8/app/users/ids" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '["https://www.lemon8-app.com/lemon8cars?region=us","https://v.lemon8-app.com/al/OgZrsUppx"]'

الاستجابات

تحفظ استجابة JSON الأصلية والدقة العددية. يتطلب النجاح code=200 وdata غير null؛ وتعتمد بنية البيانات على نقطة النهاية. تحتسب رسوم المصفوفات أو الكائنات الفارغة الناجحة. الاستجابة أدناه توضيحية، وليست نتيجة مباشرة.

json

{"code":200,"data":{"user_id":"7217844966059656197"}}

الأخطاء

HTTP 400: مدخل غير صحيح؛ 401: المصادقة مطلوبة؛ 402: رصيد غير كاف؛ 403: رفض الوصول؛ 405: طريقة غير مدعومة؛ 429: حد المعدل؛ 5xx: إخفاق الخدمة أو المزود. HTTP 200 من المزود مع رمز أعمال فاشل يعد إخفاقا. احتفظ بـX-Request-Id للتشخيص.

المصادر

جرى التحقق من جميع العمليات البالغ عددها 16 وأسعارها مقابل OpenAPI الرسمي وبيانات أسعار نقاط النهاية الحالية في 2026-10-31. تغطية الوثائق لا تعني اجتياز كل عملية اختبارا مباشرا.

TikHub · OpenAPI · أسعار نقاط نهاية TikHub