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 は本文なしのクエリパラメーターを受け取ります。2 つの一括 POST はクエリを受け取らず、空でない共有リンク文字列 1～10 個の JSON 配列を受け取ります。Content-Type: application/json を指定してください。本文の上限は 64 KiB です。未知または重複したフィールドは拒否されます。ID とカーソルは文字列で保持してください。検索パラメーターは keyword ではなく query です。タイムアウトは 60 秒で、自動再試行はありません。

既定料金は成功したリクエストごとに $0.001（1000 credits）で、最大 10 リンクの一括リクエストも 1 件として扱います。アカウント固有の料金が優先されます。各ページは別のリクエストです。前の応答のカーソルを使用してください。自動ページングはありません。供給元の失敗時は予約額を解放し、精算失敗時は供給元への呼び出しを繰り返しません。

ユーザープロフィール

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 と null でない data が必要です。データ構造は操作ごとに異なります。成功した空の配列やオブジェクトも課金対象です。以下は説明用の例であり、実際の応答ではありません。

json

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

エラー

HTTP 400：入力不正、401：認証が必要、402：残高不足、403：アクセス拒否、405：未対応のメソッド、429：レート制限、5xx：サービスまたは供給元の障害。供給元が HTTP 200 を返しても業務コードが失敗ならエラーです。調査のため X-Request-Id を保存してください。

出典

2026-10-31 に全 16 操作と料金を公式 OpenAPI および最新の料金メタデータと照合しました。全操作の文書化は、すべての実通信テストの合格を意味しません。

TikHub · OpenAPI · TikHub エンドポイント料金