> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Threads API

> Durchsuchen Sie Threads und lesen Sie öffentliche Profile, Beiträge und Antworten als JSON, mit Likes, Antworten, Reposts, Zitaten, Shares und Veröffentlichungszeiten.

Lesen Sie öffentliche Threads-Daten als JSON über die asynchrone Task-API. Senden Sie `taskType` `SOCIAL` mit `platform` `threads` und wählen Sie mit `action`, was gelesen wird. Eine abgeschlossene Anfrage kostet **0.5 Credits**.

## Anfrage

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "SOCIAL", "payload": { "platform": "threads", "action": "search", "query": "running shoes", "limit": 20 } }'
```

Senden Sie den Task und fragen Sie dann `GET /v1/async/task/{id}` ab oder empfangen Sie den Webhook. Siehe [Asynchrone Tasks](https://docs.querying.ai/de/concepts/async-tasks.md).

## Aktionen

| `action` | Liest | Erforderlich |
| - | - | - |
| `search` (Standard) | Beiträge zu einem Stichwort | `query` |
| `profile` | Ein öffentliches Profil und seine neuesten Beiträge | `username` |
| `post` | Ein Beitrag | `postUrl` |
| `replies` | Die Antworten auf einen Beitrag | `postUrl` |

`username` nimmt einen Nutzernamen oder eine Profil-URL. `postUrl` nimmt eine Beitrags-URL, etwa `https://www.threads.com/@natgeo/post/Dfzi22JJSYp`.

## Parameter

* `query`: Erforderlich für `search`.
* `limit`: Optional. `search` und `profile` nehmen 1 bis 50, Standard 10. `replies` nimmt 1 bis 500, Standard 50.

## Antwortbeispiel

```json theme={"theme":"css-variables"}
{
  "platform": "threads",
  "action": "search",
  "query": "running shoes",
  "returnedCount": 1,
  "posts": [
    {
      "id": "4032816753373504516",
      "code": "Df3cXhtEmQE",
      "url": "https://www.threads.com/@bongdgzmn/post/Df3cXhtEmQE",
      "text": "Gave in to the hype as I am also looking for a new pair of daily running shoes.",
      "author": "bongdgzmn",
      "authorVerified": false,
      "publishedAt": "2026-11-18T02:34:01.000Z",
      "mediaType": "carousel",
      "likeCount": 62,
      "replyCount": 42,
      "repostCount": 1,
      "quoteCount": 0,
      "shareCount": 19,
      "isReply": false
    }
  ]
}
```

## Ergebnisfelder

* Jede Antwort wiederholt `platform` und `action`. Listen tragen `returnedCount`.
* Ein Beitrag hat `id`, `code`, `url`, `text`, `author`, `authorVerified`, `publishedAt`, `mediaType` (`text`, `image`, `video` oder `carousel`), `images`, `videoUrl`, `likeCount`, `replyCount`, `repostCount`, `quoteCount`, `shareCount` und `isReply`. Eine Antwort ergänzt `replyTo`, den Nutzernamen, dem sie antwortet.
* `search` liefert `posts` in der Reihenfolge, in der Threads sie zeigt, bis etwa 50.
* `profile` liefert `id`, `username`, `displayName`, `biography`, `bioLinks`, `avatarUrl`, `profileUrl`, `isVerified`, `isPrivate`, `followerCount`, `threadCount` und `recentPosts`, die 4 bis 13 neuesten Beiträge, die eine Profilseite zeigt.
* `post` liefert `post`. `replies` liefert `replies`, etwa 10 pro Beitrag. `availableCount` ist die Antwortzahl des Beitrags, und `partial: true` kennzeichnet eine Liste, die kürzer ist als diese Zahl, etwa wenn der Autor Antworten ausgeblendet hat.
* Ein Profil oder Beitrag, den es nicht gibt oder der nicht öffentlich ist, beendet den Task mit `PAGE_UNAVAILABLE`. Berechnet werden nur abgeschlossene Anfragen.

## Siehe auch

* [Instagram](https://docs.querying.ai/de/engines/instagram.md)
* [YouTube](https://docs.querying.ai/de/engines/youtube.md)
* [Engine-Übersicht](https://docs.querying.ai/de/engines/overview.md)
* [Credits und Limits](https://docs.querying.ai/de/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.