Referência de endpoints do Lemon8 | Documentação de APIs | 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)

Use sua chave API API Hop. A disponibilidade depende dos gateways ativos e das permissões da chave; a documentação não confirma disponibilidade em produção.

GET aceita parâmetros de consulta sem corpo. Os dois endpoints POST em lote aceitam um array JSON com 1 a 10 strings não vazias de links compartilhados, sem parâmetros de consulta. Use Content-Type: application/json. O limite do corpo é 64 KiB. Campos desconhecidos ou duplicados são rejeitados. Mantenha IDs e cursores como strings. A busca usa query, não keyword. O tempo limite é de 60 segundos, sem novas tentativas automáticas.

O preço padrão é $0.001 (1000 credits) por requisição bem-sucedida, incluindo um lote de até 10 links. Preços específicos da conta prevalecem. Cada página é uma requisição separada; use o cursor da resposta anterior. Não há paginação automática. Falhas do fornecedor liberam a reserva. Falhas na liquidação não repetem a chamada ao fornecedor.

Perfil do usuário

app-fetch_user_profile

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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

Campo	Obrigatório	Descrição	Padrão	Exemplo
`user_id`	Sim	ID do usuário; `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"

Detalhes da publicação

app-fetch_post_detail

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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

Campo	Obrigatório	Descrição	Padrão	Exemplo
`item_id`	Sim	ID da publicação; `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"

Seguidores

app-fetch_user_follower_list

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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

Campo	Obrigatório	Descrição	Padrão	Exemplo
`user_id`	Sim	ID do usuário; `string`	-	`"7428056850216862763"`
`cursor`	Não	Cursor da resposta anterior; `string`	`""`	`""`

bash

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

Usuários seguidos

app-fetch_user_following_list

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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

Campo	Obrigatório	Descrição	Padrão	Exemplo
`user_id`	Sim	ID do usuário; `string`	-	`"7428056850216862763"`
`cursor`	Não	Cursor da resposta anterior; `string`	`""`	`""`

bash

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

Comentários

app-fetch_post_comment_list

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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

Campo	Obrigatório	Descrição	Padrão	Exemplo
`group_id`	Sim	ID do grupo da publicação; `string`	-	`"7361926875709129222"`
`item_id`	Sim	ID da publicação; `string`	-	`"7361926875709129222"`
`media_id`	Sim	ID da mídia da publicação; `string`	-	`"7428056850216862763"`
`offset`	Não	Deslocamento de paginação; `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"

Banners de descoberta

app-fetch_discover_banners

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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

Sem parâmetros de consulta.

bash

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

Conteúdo de descoberta

app-fetch_discover_tab

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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

Sem parâmetros de consulta.

bash

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

Seleção editorial

app-fetch_discover_tab_information_tabs

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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

Sem parâmetros de consulta.

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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

Sem parâmetros de consulta.

bash

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

Informações do tópico

app-fetch_topic_info

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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

Campo	Obrigatório	Descrição	Padrão	Exemplo
`forum_id`	Sim	ID do tópico; `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"

Publicações do tópico

app-fetch_topic_post_list

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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

Campo	Obrigatório	Descrição	Padrão	Exemplo
`category`	Sim	ID da categoria do tópico; `string`	-	`"590"`
`max_behot_time`	Não	Cursor da resposta anterior; `string`	`""`	`""`
`category_parameter`	Sim	Parâmetro da categoria; `string`	-	`"7174447913778593798"`
`hashtag_name`	Sim	Nome da hashtag; `string`	-	`"lemon8christmas"`
`sort_type`	Não	Tipo de ordenação; `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"

Busca

app-fetch_search

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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

Campo	Obrigatório	Descrição	Padrão	Exemplo
`query`	Sim	Palavra-chave; `string`	-	`"lemon8"`
`max_cursor`	Não	Cursor da resposta anterior; `string`	`""`	`""`
`filter_type`	Não	Filtro de busca; `string`; `enum`: `""`, `"video"`, `"posts"`	`""`	`""`
`order_by`	Não	Ordem de busca; `string`; `enum`: `""`, `"popular"`, `"recent"`	`""`	`""`
`search_tab`	Não	Aba de busca; `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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

Campo	Obrigatório	Descrição	Padrão	Exemplo
`share_text`	Sim	Link compartilhado; `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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

Campo	Obrigatório	Descrição	Padrão	Exemplo
`share_text`	Sim	Link compartilhado; `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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

body: Array JSON de 1 a 10 strings de links compartilhados.

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

Preço por requisição bem-sucedida: $0.001 (1000 credits).

body: Array JSON de 1 a 10 strings de links compartilhados.

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

Respostas

A resposta JSON nativa e a precisão numérica são preservadas. O sucesso exige code=200 e data diferente de null; a estrutura depende do endpoint. Arrays ou objetos vazios bem-sucedidos são cobrados. A resposta abaixo é ilustrativa, não um resultado real.

json

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

Erros

HTTP 400: entrada inválida; 401: autenticação necessária; 402: saldo insuficiente; 403: acesso negado; 405: método não permitido; 429: limite de requisições; 5xx: falha do serviço ou fornecedor. HTTP 200 do fornecedor com código de negócio de falha é um erro. Guarde X-Request-Id para diagnóstico.

Fontes

As 16 operações e os preços foram verificados em 2026-10-31 com a OpenAPI oficial e os metadados de preços atuais. Cobertura documental não significa que todas as operações passaram por testes reais.

TikHub · OpenAPI · Preços dos endpoints TikHub