Справочник эндпоинтов Lemon8 | Документация 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)

Используйте ключ API API Hop. Доступность зависит от активных шлюзов и разрешений ключа; документация не подтверждает доступность в рабочей среде.

GET принимает параметры запроса без тела. Два пакетных эндпоинта POST принимают JSON-массив из 1–10 непустых строк со ссылками без параметров запроса. Укажите 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: 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 credits).

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