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 Key。可用性取決於已啟用閘道與金鑰權限；文件存在不代表正式環境已開放。

GET 介面只接受查詢參數，不接受請求本文。兩個批次 POST 介面接受包含 1 至 10 個非空分享連結字串的 JSON 陣列，不接受查詢參數。請設定 Content-Type: application/json。本文上限為 64 KiB。未知或重複查詢欄位會被拒絕。ID 與游標必須保留為字串。搜尋參數是 query，不是 keyword。請求逾時為 60 秒，不自動重試。

預設每次成功請求 $0.001（1000 credits），一次最多 10 個連結的批次請求也按一次計費。租戶專屬價格優先。每一頁都是獨立請求，分頁時使用上一回應的游標，不自動翻頁。上游失敗會釋放預留額度；結算失敗不會重複呼叫上游。

使用者資料

app-fetch_user_profile

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

每次成功請求價格: $0.001 (1000 credits).

欄位	必填	說明	預設值	範例
`user_id`	是	使用者 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 credits).

欄位	必填	說明	預設值	範例
`item_id`	是	作品 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 credits).

欄位	必填	說明	預設值	範例
`user_id`	是	使用者 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 credits).

欄位	必填	說明	預設值	範例
`user_id`	是	使用者 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 credits).

欄位	必填	說明	預設值	範例
`group_id`	是	作品群組 ID; `string`	-	`"7361926875709129222"`
`item_id`	是	作品 ID; `string`	-	`"7361926875709129222"`
`media_id`	是	作品媒體 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 credits).

無查詢參數。

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

無查詢參數。

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

無查詢參數。

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

無查詢參數。

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

欄位	必填	說明	預設值	範例
`forum_id`	是	話題 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 credits).

欄位	必填	說明	預設值	範例
`category`	是	話題分類 ID; `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 credits).

欄位	必填	說明	預設值	範例
`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 credits).

欄位	必填	說明	預設值	範例
`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 credits).

欄位	必填	說明	預設值	範例
`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 credits).

body: 包含 1 至 10 個分享連結字串的 JSON 陣列.

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

body: 包含 1 至 10 個分享連結字串的 JSON 陣列.

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 個操作與價格已於 2026-10-31 對照官方 OpenAPI 及即時端點價格核驗。文件涵蓋全部介面不等於每個介面都已通過實際呼叫測試。

TikHub · OpenAPI · TikHub 端點價格