Threads 엔드포인트 참조 | API 문서

# Threads endpoint reference

Read profiles, posts, replies, reposts, comments and search results through 12 authenticated Threads endpoints.

Use GET query parameters without a request body. Unknown, duplicate or invalid fields are rejected. Keep IDs as strings, including values beyond the JavaScript safe integer range. Requests time out after 60 seconds and are not automatically retried.

The default price is $0.002 (2000 credits) per successful request, including successful empty arrays or objects, not per item. Account-specific prices take precedence. Failed upstream requests release the reservation. Settlement errors return an error without repeating the upstream request.

User posts, reposts, replies, post comments, top search and recent search do not support pagination. Their end_cursor field is reserved and has no effect; do not use next_cursor or has_more to fetch further pages. User lists return only the available batch (about 25 items), not full history. No endpoint automatically retrieves more data.

### web-fetch_user_info

User profile

`GET https://api.apihop.ai/v1/threads/web/users/profile`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `username` | Yes | `string`; Username |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/users/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "username=jlo"
```

### web-fetch_user_info_by_id

User profile by ID

`GET https://api.apihop.ai/v1/threads/web/users/profile/by-id`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `user_id` | Yes | `string`; Numeric user ID; `^[0-9]+$` |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/users/profile/by-id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=67027868801"
```

### web-fetch_user_posts

User posts

`GET https://api.apihop.ai/v1/threads/web/users/posts`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `user_id` | Yes | `string`; Numeric user ID; `^[0-9]+$` |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/users/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"
```

### web-fetch_user_reposts

User reposts

`GET https://api.apihop.ai/v1/threads/web/users/reposts`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `user_id` | Yes | `string`; Numeric user ID; `^[0-9]+$` |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/users/reposts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"
```

### web-fetch_user_replies

User replies

`GET https://api.apihop.ai/v1/threads/web/users/replies`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `user_id` | Yes | `string`; Numeric user ID; `^[0-9]+$` |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/users/replies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"
```

### web-fetch_post_detail

Post by numeric ID

`GET https://api.apihop.ai/v1/threads/web/posts/by-id`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `post_id` | Yes | `string`; Numeric post ID; `^[0-9]+$` |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/posts/by-id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=3349029093483693129"
```

### web-fetch_post_detail_v2

Post by shortcode or URL

`GET https://api.apihop.ai/v1/threads/web/posts/detail`

Price per successful request: **$0.002** (2000 credits).

At least one: `post_id`, `url`.

| Field | Required | Contract |
| --- | --- | --- |
| `post_id` | No | `string`; Post shortcode |
| `url` | No | `string`; Full post URL |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=DPVUglOjOUu"
```

### web-fetch_post_comments

Post comments

`GET https://api.apihop.ai/v1/threads/web/posts/comments`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `post_id` | Yes | `string`; Numeric post ID; `^[0-9]+$` |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=3390920896561588969"
```

### web-search_top

Top search

`GET https://api.apihop.ai/v1/threads/web/search/top`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `query` | Yes | `string`; Search terms |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/search/top" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"
```

### web-search_recent

Recent search

`GET https://api.apihop.ai/v1/threads/web/search/recent`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `query` | Yes | `string`; Search terms |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/search/recent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"
```

### web-search_posts

Post search

`GET https://api.apihop.ai/v1/threads/web/search/posts`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `query` | Yes | `string`; Search terms |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/search/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"
```

### web-search_profiles

Profile search

`GET https://api.apihop.ai/v1/threads/web/search/profiles`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `query` | Yes | `string`; Search terms |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/search/profiles" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=mark"
```

## Responses

The native JSON code/data envelope and numeric precision are preserved. Success requires code=200 and non-null data. An HTTP 200 business error is a failure. Response shapes vary by endpoint; this example is illustrative, not a live response.

```json
{"code":200,"data":{"post":{"code":"DPVUglOjOUu"},"replies":[]}}
```

## Errors

HTTP 400: invalid parameters; 401: authentication failure; 402: insufficient credit; 403: access denied; 405: unsupported method; 408: cancellation; 429: rate limit; 5xx: service or upstream failure, including 504 timeout. Keep X-Request-Id for diagnosis.

## Sources

Checked against official OpenAPI V5.3.2 and endpoint prices on 2026-10-31. The price-only fetch_post_id_from_url operation is excluded because it is absent from OpenAPI.

[TikHub](https://docs.tikhub.io/4592766m0) · [OpenAPI](https://api.tikhub.io/openapi.json) · [Prices](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info)

인증이 필요한 12개 Threads 엔드포인트로 프로필, 게시물, 답글, 재게시물, 댓글 및 검색 결과를 조회합니다.

본문 없이 GET 쿼리 매개변수를 사용합니다. 알 수 없거나 중복되거나 잘못된 필드는 거부됩니다. JavaScript 안전 정수 범위를 넘는 값도 ID를 문자열로 유지하세요. 제한 시간은 60초이며 자동 재시도하지 않습니다.

기본 가격은 성공한 요청당 $0.002(2000 credits)이며 빈 배열이나 객체의 성공 응답도 포함합니다. 항목 수 기준이 아닙니다. 계정별 가격이 우선합니다. 공급자 요청이 실패하면 예약 금액을 해제합니다. 정산 오류가 발생해도 공급자 요청을 반복하지 않습니다.

사용자 게시물, 재게시물, 답글, 게시물 댓글, 인기 검색 및 최신 검색은 페이지 처리를 지원하지 않습니다. end_cursor는 예약 필드이며 효과가 없습니다. next_cursor나 has_more로 다음 페이지를 가져올 수 없습니다. 사용자 목록은 전체 기록이 아닌 현재 가능한 묶음(약 25개)만 반환합니다. 어떤 엔드포인트도 추가 데이터를 자동으로 가져오지 않습니다.

web-fetch_user_info

사용자 프로필

GET https://api.apihop.ai/v1/threads/web/users/profile

성공한 요청당 가격: $0.002 (2000 credits).

필드	필수	규격
`username`	예	`string`; 사용자 이름

bash

curl --get "https://api.apihop.ai/v1/threads/web/users/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "username=jlo"

web-fetch_user_info_by_id

ID로 프로필 조회

GET https://api.apihop.ai/v1/threads/web/users/profile/by-id

성공한 요청당 가격: $0.002 (2000 credits).

필드	필수	규격
`user_id`	예	`string`; 숫자 사용자 ID; `^[0-9]+$`

bash

curl --get "https://api.apihop.ai/v1/threads/web/users/profile/by-id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=67027868801"

web-fetch_user_posts

사용자 게시물

GET https://api.apihop.ai/v1/threads/web/users/posts

성공한 요청당 가격: $0.002 (2000 credits).

필드	필수	규격
`user_id`	예	`string`; 숫자 사용자 ID; `^[0-9]+$`
`end_cursor`	아니요	`string`; 예약 필드; 페이지 처리 미지원

bash

curl --get "https://api.apihop.ai/v1/threads/web/users/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"

web-fetch_user_reposts

사용자 재게시물

GET https://api.apihop.ai/v1/threads/web/users/reposts

성공한 요청당 가격: $0.002 (2000 credits).

필드	필수	규격
`user_id`	예	`string`; 숫자 사용자 ID; `^[0-9]+$`
`end_cursor`	아니요	`string`; 예약 필드; 페이지 처리 미지원

bash

curl --get "https://api.apihop.ai/v1/threads/web/users/reposts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"

web-fetch_user_replies

사용자 답글

GET https://api.apihop.ai/v1/threads/web/users/replies

성공한 요청당 가격: $0.002 (2000 credits).

필드	필수	규격
`user_id`	예	`string`; 숫자 사용자 ID; `^[0-9]+$`
`end_cursor`	아니요	`string`; 예약 필드; 페이지 처리 미지원

bash

curl --get "https://api.apihop.ai/v1/threads/web/users/replies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"

web-fetch_post_detail

숫자 ID로 게시물 조회

GET https://api.apihop.ai/v1/threads/web/posts/by-id

성공한 요청당 가격: $0.002 (2000 credits).

필드	필수	규격
`post_id`	예	`string`; 숫자 게시물 ID; `^[0-9]+$`

bash

curl --get "https://api.apihop.ai/v1/threads/web/posts/by-id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=3349029093483693129"

web-fetch_post_detail_v2

단축 코드 또는 URL로 게시물 조회

GET https://api.apihop.ai/v1/threads/web/posts/detail

성공한 요청당 가격: $0.002 (2000 credits).

최소 하나: post_id, url.

필드	필수	규격
`post_id`	아니요	`string`; 게시물 단축 코드
`url`	아니요	`string`; 전체 게시물 URL

bash

curl --get "https://api.apihop.ai/v1/threads/web/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=DPVUglOjOUu"

web-fetch_post_comments

게시물 댓글

GET https://api.apihop.ai/v1/threads/web/posts/comments

성공한 요청당 가격: $0.002 (2000 credits).

필드	필수	규격
`post_id`	예	`string`; 숫자 게시물 ID; `^[0-9]+$`
`end_cursor`	아니요	`string`; 예약 필드; 페이지 처리 미지원

bash

curl --get "https://api.apihop.ai/v1/threads/web/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=3390920896561588969"

web-search_top

web-search_recent

최신 검색

GET https://api.apihop.ai/v1/threads/web/search/recent

성공한 요청당 가격: $0.002 (2000 credits).

필드	필수	규격
`query`	예	`string`; 검색어
`end_cursor`	아니요	`string`; 예약 필드; 페이지 처리 미지원

bash

curl --get "https://api.apihop.ai/v1/threads/web/search/recent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"

web-search_posts

게시물 검색

GET https://api.apihop.ai/v1/threads/web/search/posts

성공한 요청당 가격: $0.002 (2000 credits).

필드	필수	규격
`query`	예	`string`; 검색어

bash

curl --get "https://api.apihop.ai/v1/threads/web/search/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"

web-search_profiles

프로필 검색

GET https://api.apihop.ai/v1/threads/web/search/profiles

성공한 요청당 가격: $0.002 (2000 credits).

필드	필수	규격
`query`	예	`string`; 검색어

bash

curl --get "https://api.apihop.ai/v1/threads/web/search/profiles" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=mark"

응답

원본 JSON code/data 구조와 숫자 정밀도를 보존합니다. 성공하려면 code=200이고 data가 null이 아니어야 합니다. HTTP 200 안의 업무 오류도 실패입니다. 구조는 작업마다 다르며 아래는 설명용 예시로, 실제 응답이 아닙니다.

json

{"code":200,"data":{"post":{"code":"DPVUglOjOUu"},"replies":[]}}

오류

HTTP 400: 잘못된 매개변수; 401: 인증 실패; 402: 잔액 부족; 403: 접근 거부; 405: 지원하지 않는 메서드; 408: 취소; 429: 요청 제한; 5xx: 서비스 또는 공급자 오류(504는 시간 초과). 진단을 위해 X-Request-Id를 보관하세요.

출처

2026-10-31에 공식 OpenAPI V5.3.2 및 가격을 확인했습니다. 가격표에만 있는 fetch_post_id_from_url은 OpenAPI에 없어 제외했습니다.

TikHub · OpenAPI · Prices