Tham chiếu điểm cuối Lemon8 | Tài liệu API | API Hop

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

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

Dùng khóa API API Hop của bạn. Khả năng truy cập phụ thuộc cổng đã bật và quyền của khóa; các tài liệu này không xác nhận khả dụng trên môi trường sản xuất.

Thao tác GET chấp nhận tham số truy vấn, không có thân. Hai điểm cuối POST theo lô chấp nhận mảng JSON gồm 1 đến 10 chuỗi liên kết chia sẻ không rỗng, không có tham số truy vấn. Dùng Content-Type: application/json. Giới hạn thân là 64 KiB. Trường truy vấn không rõ hoặc lặp lại bị từ chối. Giữ ID và con trỏ dưới dạng chuỗi. Tìm kiếm dùng query, không dùng keyword. Yêu cầu hết thời gian sau 60 giây và không được tự động thử lại.

Giá mặc định là $0.001 (1000 tín dụng) mỗi yêu cầu thành công, gồm một yêu cầu theo lô tối đa 10 liên kết. Giá riêng của tài khoản được ưu tiên. Mỗi trang là một yêu cầu riêng; dùng con trỏ từ phản hồi trước. Không có phân trang tự động. Yêu cầu thượng nguồn thất bại giải phóng khoản giữ chỗ. Lỗi quyết toán không lặp lại yêu cầu thượng nguồn.

Hồ sơ người dùng

app-fetch_user_profile

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

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

Trường	Bắt buộc	Mô tả	Mặc định	Ví dụ
`user_id`	Có	ID người dùng; `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"

Chi tiết bài đăng

app-fetch_post_detail

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

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

Trường	Bắt buộc	Mô tả	Mặc định	Ví dụ
`item_id`	Có	ID bài đăng; `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"

Người theo dõi người dùng

app-fetch_user_follower_list

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

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

Trường	Bắt buộc	Mô tả	Mặc định	Ví dụ
`user_id`	Có	ID người dùng; `string`	-	`"7428056850216862763"`
`cursor`	Không	Con trỏ phân trang từ phản hồi trước; `string`	`""`	`""`

bash

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

Tài khoản người dùng theo dõi

app-fetch_user_following_list

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

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

Trường	Bắt buộc	Mô tả	Mặc định	Ví dụ
`user_id`	Có	ID người dùng; `string`	-	`"7428056850216862763"`
`cursor`	Không	Con trỏ phân trang từ phản hồi trước; `string`	`""`	`""`

bash

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

Bình luận bài đăng

app-fetch_post_comment_list

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

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

Trường	Bắt buộc	Mô tả	Mặc định	Ví dụ
`group_id`	Có	ID nhóm bài đăng; `string`	-	`"7361926875709129222"`
`item_id`	Có	ID bài đăng; `string`	-	`"7361926875709129222"`
`media_id`	Có	ID đa phương tiện bài đăng; `string`	-	`"7428056850216862763"`
`offset`	Không	Độ lệch phân trang; `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"

Biểu ngữ khám phá

app-fetch_discover_banners

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

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

Không có tham số truy vấn.

bash

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

Nội dung khám phá

app-fetch_discover_tab

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

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

Không có tham số truy vấn.

bash

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

Lựa chọn biên tập

app-fetch_discover_tab_information_tabs

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

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

Không có tham số truy vấn.

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

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

Không có tham số truy vấn.

bash

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

Thông tin chủ đề

app-fetch_topic_info

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

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

Trường	Bắt buộc	Mô tả	Mặc định	Ví dụ
`forum_id`	Có	ID chủ đề; `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"

Bài đăng chủ đề

app-fetch_topic_post_list

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

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

Trường	Bắt buộc	Mô tả	Mặc định	Ví dụ
`category`	Có	ID danh mục chủ đề; `string`	-	`"590"`
`max_behot_time`	Không	Con trỏ phân trang từ phản hồi trước; `string`	`""`	`""`
`category_parameter`	Có	Tham số danh mục chủ đề; `string`	-	`"7174447913778593798"`
`hashtag_name`	Có	Tên thẻ chủ đề; `string`	-	`"lemon8christmas"`
`sort_type`	Không	Kiểu sắp xếp; `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"

Tìm kiếm

app-fetch_search

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

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

Trường	Bắt buộc	Mô tả	Mặc định	Ví dụ
`query`	Có	Từ khóa tìm kiếm; `string`	-	`"lemon8"`
`max_cursor`	Không	Con trỏ phân trang từ phản hồi trước; `string`	`""`	`""`
`filter_type`	Không	Bộ lọc tìm kiếm; `string`; `enum`: `""`, `"video"`, `"posts"`	`""`	`""`
`order_by`	Không	Thứ tự tìm kiếm; `string`; `enum`: `""`, `"popular"`, `"recent"`	`""`	`""`
`search_tab`	Không	Tab tìm kiếm; `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

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

Trường	Bắt buộc	Mô tả	Mặc định	Ví dụ
`share_text`	Có	Liên kết chia sẻ; `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

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

Trường	Bắt buộc	Mô tả	Mặc định	Ví dụ
`share_text`	Có	Liên kết chia sẻ; `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

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

body: Mảng JSON gồm 1 đến 10 chuỗi liên kết chia sẻ.

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

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

body: Mảng JSON gồm 1 đến 10 chuỗi liên kết chia sẻ.

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

Phản hồi

Phản hồi JSON gốc và độ chính xác số được giữ nguyên. Thành công yêu cầu code=200 và data không null; cấu trúc dữ liệu phụ thuộc điểm cuối. Mảng hoặc đối tượng rỗng thành công vẫn tính phí. Phản hồi dưới đây chỉ minh họa, không phải kết quả trực tiếp.

json

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

Lỗi

HTTP 400: đầu vào không hợp lệ; 401: yêu cầu xác thực; 402: thiếu tín dụng; 403: truy cập bị từ chối; 405: phương thức không được hỗ trợ; 429: giới hạn tốc độ; 5xx: lỗi dịch vụ hoặc thượng nguồn. HTTP 200 thượng nguồn có mã nghiệp vụ thất bại là thất bại. Giữ X-Request-Id để khắc phục.

Nguồn

Cả 16 thao tác và giá của chúng được đối chiếu với OpenAPI chính thức và siêu dữ liệu giá điểm cuối hiện hành ngày 2026-10-31. Tài liệu bao phủ không có nghĩa mọi thao tác đã vượt qua kiểm thử trực tiếp.

TikHub · OpenAPI · Giá điểm cuối TikHub