واجهة بيانات Lemon8 | وثائق API

# Lemon8 Data API

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

## Authentication

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

```http
Authorization: Bearer YOUR_API_KEY
```

## Requests

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.

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

```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"]'
```

## Billing and pagination

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.

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

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

اقرأ ملفات Lemon8 والمنشورات والتعليقات والمتابعين والاكتشاف والموضوعات ونتائج البحث، وحلل الروابط المشتركة عبر 16 نقطة نهاية تتطلب المصادقة.

المصادقة

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

http

Authorization: Bearer YOUR_API_KEY

الطلبات

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

bash

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

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"]'

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

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

المرجع الكامل

الاستجابات

تحفظ استجابة 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