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은 본문 없이 쿼리 매개변수를 받습니다. 두 일괄 POST 엔드포인트는 쿼리 없이 비어 있지 않은 공유 링크 문자열 1~10개의 JSON 배열을 받습니다. Content-Type: application/json을 사용하세요. 본문은 최대 64 KiB입니다. 알 수 없거나 중복된 필드는 거부됩니다. ID와 커서는 문자열로 유지하세요. 검색은 keyword가 아닌 query를 사용합니다. 제한 시간은 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를 보관하세요.

출처

2026-10-31에 전체 16개 작업과 가격을 공식 OpenAPI 및 최신 가격 메타데이터와 대조했습니다. 모든 작업의 문서화가 모든 실제 호출 테스트의 통과를 뜻하지는 않습니다.

TikHub · OpenAPI · TikHub 엔드포인트 요금