Zum Inhalt springen
NeuigkeitenNeu

Social: YouTube, Instagram und Threads über die API lesen

Social
Eine SOCIAL-Anfrage an POST /v1/async/task für die YouTube-Suche wireless earbuds review und das erste Video der Antwort mit Kanal, 62.618 Aufrufen und 957 Likes

Durchsuchen Sie YouTube, Instagram und Threads und erhalten Sie Videos, Beiträge, Kommentare, Profile und YouTube-Untertitel als JSON mit jedem API-Schlüssel, für 0,5 Credits pro abgeschlossener Anfrage.

Was Sie erhalten

  • platform youtube: Suchergebnisse, die neuesten Uploads zu einer Suche, die Seite eines Videos, Kommentare mit Antworten, einen Kanal, die Videos, Shorts oder Livestreams eines Kanals und Untertitel.
  • platform instagram: Beiträge und Reels zu einem Stichwort, ein öffentliches Profil mit seinen 12 neuesten Beiträgen, einen Beitrag oder ein Reel und seine Kommentare.
  • platform threads: Beiträge zu einem Stichwort, ein öffentliches Profil mit seinen neuesten Beiträgen, einen Beitrag und seine Antworten.
  • Zähler kommen als Zahlen, etwa viewCount, likeCount, commentCount und followerCount, mit der Zeit publishedAt. So vergleichen Sie Beiträge, ohne Text wie 62K zu zerlegen.

So funktioniert es

Senden Sie taskType SOCIAL an POST /v1/async/task mit einer platform und einer action. search, die Standardaktion, nimmt query. Die anderen Aktionen nehmen videoId, channel, username oder postUrl, und dort können Sie die URL der Seite einfügen.

Social liest öffentliche Seiten. Auf Instagram sind das die 12 neuesten Beiträge eines Profils und etwa ein Dutzend Kommentare pro Beitrag, auf Threads etwa 10 Antworten pro Beitrag. Eine Seite, die es nicht gibt oder die eine Anmeldung verlangt, beendet die Aufgabe mit PAGE_UNAVAILABLE.

Eine YouTube-Videosuche, sortiert nach relevance, liefert nextPageToken für die nächste Seite. transcript liefert den Untertitel-text und zeitgestempelte segments in den angegebenen Sprachen, und translateTo lässt YouTube sie übersetzen. Das Tool read_social auf dem MCP-Server von querying.ai führt dieselben Abfragen aus Claude Code, Codex, Cursor und anderen MCP-Clients aus.

Einsatzbereiche

  • Verfolgen Sie Tag für Tag Aufrufe, Likes und Kommentare der Videos Ihrer Marke und Ihrer Wettbewerber.
  • Lesen Sie Kommentare und Antworten unter einem Launch auf YouTube, Instagram und Threads und sammeln Sie die Fragen.
  • Geben Sie Ihrem Modell das Transkript eines Testvideos mit Zeitstempeln und finden Sie die Stelle, an der es Ihr Produkt nennt.
  • Stellen Sie, was Creator auf YouTube und Threads sagen, neben die Antworten von ChatGPT und Google AI Mode auf dieselbe Suche.

Anfrage senden

Senden Sie die Anfrage mit Ihrem API-Schlüssel im Header Authorization.

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": "youtube",
      "action": "search",
      "query": "wireless earbuds review",
      "limit": 10
    }
  }'

Felder der Anfrage

taskTypestringPflicht
Die Engine, die die Aufgabe ausführt, etwa CHATGPT oder GOOGLE.
payload.platformstringPflicht
Die Plattform, die gelesen wird: youtube, instagram oder threads.
payload.actionstring
Was gelesen wird, etwa search, video, comments oder transcript. Standardwert search. Jede Plattform listet ihre Aktionen in der Dokumentation.
payload.querystring
Die Suchanfrage für search und recent, so formuliert, wie ein Nutzer sie in das Suchfeld der Plattform tippt.
payload.limitinteger
Anzahl der zurückgegebenen Ergebnisse. Eine YouTube-Suche nimmt 1 bis 50, Standardwert 10.
webhook.urlstring
Eine HTTPS-Adresse Ihres Servers. Die fertige Aufgabe wird dorthin gesendet, sobald sie abgeschlossen ist.

Antwort

So sieht eine fertige Aufgabe aus, für die Lesbarkeit gekürzt.

JSON
{
  "success": true,
  "task": {
    "id": "…",
    "taskType": "SOCIAL",
    "status": "COMPLETED",
    "createdAt": "…"
  },
  "credits": { "creditsToCharge": 0.5, "creditsCharged": 0.5 },
  "response": {
    "platform": "youtube",
    "action": "search",
    "query": "wireless earbuds review",
    "order": "relevance",
    "returnedCount": 10,
    "videos": [
      {
        "position": 1,
        "videoId": "YdJh6QdOGME",
        "url": "https://www.youtube.com/watch?v=YdJh6QdOGME",
        "title": "Earbuds Awards 2026 - Best Bluetooth Earbuds by Category!",
        "channelTitle": "Mike O'Brien",
        "channelHandle": "@MikeOBrienMedia",
        "publishedAt": "2026-11-17T15:39:37Z",
        "durationSeconds": 995,
        "viewCount": 62618,
        "likeCount": 957
      },
      "…"
    ],
    "nextPageToken": "eyJyIjpbIllkSmg2UWRPR01FIl19"
  }
}
task.statusstring
QUEUED, PROCESSING, dann COMPLETED mit der Antwort oder FAILED mit error.
credits.creditsChargedinteger
Für die fertige Aufgabe berechnete Credits. Eine fehlgeschlagene Aufgabe kostet 0.
response.returnedCountinteger
Die Anzahl der Produkte in products.
response.videosarray
Die Videos in der Reihenfolge von YouTube: position, videoId, url, title, der Kanal, publishedAt, durationSeconds, viewCount und likeCount.

Ergebnis abholen

Die Anfrage liefert sofort die Aufgabe mit status QUEUED. Fragen Sie GET /v1/async/task/{id} ab, bis status COMPLETED oder FAILED ist, oder geben Sie webhook.url an, dann kommt die fertige Aufgabe mit denselben task, credits und response auf Ihrem Server an. Ergebnisse bleiben 24 Stunden nach Abschluss abrufbar.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Preis

Jede abgeschlossene Anfrage kostet 0,5 Credits, auf jeder Plattform und für jede Aktion. Berechnet werden nur abgeschlossene Anfragen. Pläne und Credits: https://querying.ai/pricing

Weitere Updates

Auf dem Laufenden bleiben

Erhalte Produktneuigkeiten per E-Mail.

RSS-Feed