Threads-Endpunktreferenz | API-Dokumentation

# 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 authentifizierte Threads-Endpunkte liefern Profile, Beiträge, Antworten, Reposts, Kommentare und Suchergebnisse.

Verwenden Sie GET-Abfrageparameter ohne Anfragekörper. Unbekannte, doppelte oder ungültige Felder werden abgelehnt. IDs bleiben Zeichenfolgen, auch außerhalb des sicheren JavaScript-Ganzzahlbereichs. Das Zeitlimit beträgt 60 Sekunden; Anfragen werden nicht automatisch wiederholt.

Der Standardpreis beträgt $0.002 (2000 credits) je erfolgreicher Anfrage, einschließlich leerer Arrays oder Objekte, nicht je Datensatz. Individuelle Kontopreise haben Vorrang. Bei Anbieterfehlern wird die Reservierung freigegeben. Abrechnungsfehler führen zu einem Fehler ohne erneuten Anbieteraufruf.

Nutzerbeiträge, Reposts, Antworten, Kommentare sowie Top- und neueste Suche unterstützen keine Seitennavigation. end_cursor ist reserviert und wirkungslos; next_cursor und has_more ermöglichen keine weiteren Seiten. Nutzerlisten liefern nur den verfügbaren Stapel (etwa 25 Einträge), nicht den vollständigen Verlauf. Keine Operation lädt automatisch weitere Daten.

web-fetch_user_info

Nutzerprofil

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

Preis je erfolgreicher Anfrage: $0.002 (2000 credits).

Feld	Erforderlich	Vertrag
`username`	Ja	`string`; Nutzername

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

Nutzerprofil nach ID

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

Preis je erfolgreicher Anfrage: $0.002 (2000 credits).

Feld	Erforderlich	Vertrag
`user_id`	Ja	`string`; Numerische Nutzer-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

Nutzerbeiträge

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

Preis je erfolgreicher Anfrage: $0.002 (2000 credits).

Feld	Erforderlich	Vertrag
`user_id`	Ja	`string`; Numerische Nutzer-ID; `^[0-9]+$`
`end_cursor`	Nein	`string`; Reserviert; keine Seitennavigation

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

Nutzer-Reposts

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

Preis je erfolgreicher Anfrage: $0.002 (2000 credits).

Feld	Erforderlich	Vertrag
`user_id`	Ja	`string`; Numerische Nutzer-ID; `^[0-9]+$`
`end_cursor`	Nein	`string`; Reserviert; keine Seitennavigation

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

Nutzerantworten

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

Preis je erfolgreicher Anfrage: $0.002 (2000 credits).

Feld	Erforderlich	Vertrag
`user_id`	Ja	`string`; Numerische Nutzer-ID; `^[0-9]+$`
`end_cursor`	Nein	`string`; Reserviert; keine Seitennavigation

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

Beitrag nach numerischer ID

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

Preis je erfolgreicher Anfrage: $0.002 (2000 credits).

Feld	Erforderlich	Vertrag
`post_id`	Ja	`string`; Numerische Beitrags-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

Beitrag nach Kurzcode oder URL

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

Preis je erfolgreicher Anfrage: $0.002 (2000 credits).

Mindestens eines: post_id, url.

Feld	Erforderlich	Vertrag
`post_id`	Nein	`string`; Beitragskurzcode
`url`	Nein	`string`; Vollständige Beitrags-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

Beitragskommentare

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

Preis je erfolgreicher Anfrage: $0.002 (2000 credits).

Feld	Erforderlich	Vertrag
`post_id`	Ja	`string`; Numerische Beitrags-ID; `^[0-9]+$`
`end_cursor`	Nein	`string`; Reserviert; keine Seitennavigation

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-Suche

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

Preis je erfolgreicher Anfrage: $0.002 (2000 credits).

Feld	Erforderlich	Vertrag
`query`	Ja	`string`; Suchbegriffe
`end_cursor`	Nein	`string`; Reserviert; keine Seitennavigation

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

Neueste Suche

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

Preis je erfolgreicher Anfrage: $0.002 (2000 credits).

Feld	Erforderlich	Vertrag
`query`	Ja	`string`; Suchbegriffe
`end_cursor`	Nein	`string`; Reserviert; keine Seitennavigation

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

Beitragssuche

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

Preis je erfolgreicher Anfrage: $0.002 (2000 credits).

Feld	Erforderlich	Vertrag
`query`	Ja	`string`; Suchbegriffe

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

Profilsuche

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

Preis je erfolgreicher Anfrage: $0.002 (2000 credits).

Feld	Erforderlich	Vertrag
`query`	Ja	`string`; Suchbegriffe

bash

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

Antworten

Die ursprüngliche JSON-Struktur code/data und Zahlengenauigkeit bleiben erhalten. Erfolg erfordert code=200 und data ungleich null. Geschäftsfehler bei HTTP 200 gelten als Fehler. Die Antwortstruktur variiert; das Beispiel ist illustrativ und keine Live-Antwort.

json

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

Fehler

HTTP 400: ungültige Parameter; 401: Authentifizierungsfehler; 402: unzureichendes Guthaben; 403: Zugriff verweigert; 405: Methode nicht unterstützt; 408: Abbruch; 429: Ratenlimit; 5xx: Dienst- oder Anbieterfehler, darunter 504 bei Zeitüberschreitung. Bewahren Sie X-Request-Id auf.

Quellen

Am 2026-10-31 mit OpenAPI V5.3.2 und offiziellen Endpunktpreisen abgeglichen. fetch_post_id_from_url steht nur in der Preisliste und fehlt in OpenAPI; die Operation ist ausgeschlossen.

TikHub · OpenAPI · Prices