Die X-Endpunkte von SocQ lieferten bereits öffentliche Profile, Beiträge, Timelines, Suche, Antworten, Zitate, Follower und Trends; der Leitfaden zur Datenerfassung auf X/Twitter behandelt diese. Am 2026-11-17 gingen 14 weitere auf der X-Plattformseite live. Sie erreichen Bereiche von X, die die grundlegenden Endpunkte nicht abdeckten: das Feld „Über dieses Konto“, Listen, Mitglieder und Moderatoren von Communities, die Tabs „Medien“ und „Antworten“ eines Nutzers, lange Artikel, Spaces und das Gesprochene in Videos.
Dieser Leitfaden gruppiert sie nach Aufgabe, zeigt für jeden eine Anfrage und nennt den Preis.
Kurze Antwort: Senden Sie einen JSON-Body an
POST https://api.socq.ai/v1/x/<endpoint>. Speichern Sie die zurückgegebenetask_id, fragen SieGET /v1/tasks/{task_id}ab, bisstatusden Wertsucceededhat, und lesen Sie danndata.results.items. Alle 14 Endpunkte kosten 0,7 Credits ($0,0035) pro Ergebnis, mit einer Ausnahme für lange Videos bei Video Transcript.
Die neuen X-Endpunkte im Überblick
1 SocQ-Credit = $0,005. Es gibt keine Grundgebühr, ein leeres Ergebnis kostet also nichts.
| Endpunkt | Rückgabe | Preis |
|---|---|---|
| X Account Location API | Land, in dem ein Konto ansässig ist, wie es sich mit X verbindet, Beitrittsdatum, Änderungen des Nutzernamens | 0,7 Credits ($0,0035) pro Konto |
| X Verified Followers API | Verifizierte Konten, die einem Profil folgen | 0,7 Credits ($0,0035) pro Follower |
| Twitter Follow Checker API | Kennzeichen für „folgt“, „wird gefolgt“ und „gegenseitig“ für bis zu 100 Paare | 0,7 Credits ($0,0035) pro Paar |
| X List Tweets API | Timeline einer Liste, neueste zuerst, mit gekennzeichneten Reposts | 0,7 Credits ($0,0035) pro Beitrag |
| Twitter List Members API | Konten auf einer Liste, als vollständige Profile | 0,7 Credits ($0,0035) pro Mitglied |
| Twitter List Followers API | Konten, die einer Liste folgen, als vollständige Profile | 0,7 Credits ($0,0035) pro Follower |
| X Communities Search API | Communities zu einem Keyword, mit Mitgliederzahl und URL | 0,7 Credits ($0,0035) pro Community |
| X Community Members API | Mitglieder einer Community, als vollständige Profile | 0,7 Credits ($0,0035) pro Mitglied |
| X Community Moderators API | Admins und Moderatoren einer Community | 0,7 Credits ($0,0035) pro Moderator |
| Twitter Media Scraper API | Beiträge aus dem Medien-Tab eines Kontos, mit Dateien in voller Qualität | 0,7 Credits ($0,0035) pro Beitrag |
| X User Replies API | Antworten, die ein Konto geschrieben hat, jeweils mit dem beantworteten Beitrag | 0,7 Credits ($0,0035) pro Antwort |
| X Articles API | Titel, Vorschauzeile, vollständiger Text, Cover und Interaktionen eines Artikels | 0,7 Credits ($0,0035) pro Artikel |
| X Spaces API | Status, Zeitplan, Hosts, Sprecher, Zuhörer und Aufzeichnungen eines Space | 0,7 Credits ($0,0035) pro Space |
| Twitter Video Transcript API | Gesprochener Text im Video eines Beitrags, mit Länge | 0,7 Credits ($0,0035) pro Video bis 2 Minuten |
Authentifizierung und der asynchrone Aufgabenablauf
Alle Anfragen authentifizieren sich mit einem API-Schlüssel. Derselbe Header wird für Übermittlung, Aufgabenstatus und Ergebnisabruf verwendet:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Jede Erfassung läuft als Hintergrundaufgabe:
submit -> task_id -> queued -> running -> succeeded
\-> failed
Der Übermittlungsaufruf antwortet sofort mit data.task_id und data.status. Fragen Sie die Aufgabe mit dieser ID ab:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Hat status den Wert succeeded, enthält die Antwort result_count, credits_amount und die erste Seite normalisierter Datensätze in data.results.items. limit ist standardmäßig 50 und reicht bis 500. Wenn results.has_more true ist, übergeben Sie results.next_cursor als cursor, um die nächste Seite zu lesen. Eine fehlgeschlagene Aufgabe enthält error_message.
Jeder der folgenden Endpunkte akzeptiert außerdem eine optionale callback_url. SocQ sendet nach Abschluss der Aufgabe einen einzelnen POST mit einer Zusammenfassung; die Datensätze lesen Sie über den Aufgaben-Endpunkt. Eine Zeitüberschreitung beim Client bricht eine Aufgabe nicht ab. Setzen Sie daher mit derselben Aufgaben-ID fort, statt erneut zu übermitteln. Ein 402 bedeutet, dass das Konto keine Credits mehr hat, und ein 429, dass der Schlüssel ein Raten- oder Credit-Limit erreicht hat.
Ein Hinweis zu results_limit: Bei Verified Followers sowie den Mitglieder-Endpunkten für Listen und Communities gilt es pro Eingabe, ist standardmäßig 100 und muss ein Vielfaches von 20 zwischen 20 und 2000 sein. Bei Communities Search muss es ein Vielfaches von 10 zwischen 10 und 500 sein.
Konten und Beziehungen prüfen
Account Location liest das Feld „Über dieses Konto“ aus: country, connected_via (zum Beispiel United States App Store oder Web), Beitrittsdatum, username_changes_count und affiliate_username. Nutzen Sie es, um Influencer zu prüfen und koordinierte Konten zu erkennen. Manche Konten, etwa viele Regierungskonten, haben kein Land; sie liefern trotzdem eine Zeile mit country: null. (Doku)
curl -X POST "https://api.socq.ai/v1/x/user-about" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames": ["elonmusk", "BBCWorld"]}'
Verified Followers liefert die Liste, die X im Tab „Verifizierte Follower“ anzeigt. Jede Zeile ist ein verifizierter Follower (actor), verknüpft mit dem abgefragten Konto (related_actor). Nutzen Sie es, um den einflussreichen Teil eines Publikums zu beziffern oder aus den Followern eines Wettbewerbers eine Outreach-Liste aufzubauen. (Doku)
curl -X POST "https://api.socq.ai/v1/x/verified-followers" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames": ["NASA"], "results_limit": 20}'
Follow Checker vergleicht einen username mit bis zu 100 usernames. Jedes Paar liefert is_following, is_followed_by und is_mutual. Prüfen Sie damit, ob Kampagnenteilnehmer Ihrer Marke folgen. (Doku)
curl -X POST "https://api.socq.ai/v1/x/check-follow" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "elonmusk", "usernames": ["SpaceX", "NASA"]}'
X-Listen lesen
Alle drei erwarten öffentliche Listen-URLs im Format /i/lists/{numeric_id}.
List Tweets liefert die Timeline der Liste, neueste zuerst. Reposts bleiben enthalten und sind mit is_repost sowie reposted_post_id und reposted_author gekennzeichnet, sodass Sie sie herausfiltern können. Eine einzige Anfrage beobachtet eine ganze Nische. (Doku)
curl -X POST "https://api.socq.ai/v1/x/list-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'
List Members exportiert die Konten auf einer Liste als vollständige Profile mit Bio, Standort, Website, Verifizierung sowie Follower-, Following- und Beitragszahlen. Eine handverlesene Liste ist ein fertiger Ausgangspunkt für die Akquise. (Doku)
curl -X POST "https://api.socq.ai/v1/x/list-members" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'
List Followers liefert die Konten, die eine Liste abonniert haben, in derselben Profilstruktur. Wer einer Liste folgt, bekundet Interesse an ihrem Thema. Das macht diese Konten zu einem präzisen Recherchesegment. (Doku)
curl -X POST "https://api.socq.ai/v1/x/list-followers" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'
X Communities kartieren
Communities Search findet Communities per Keyword, mit Name, Mitgliederzahl, Banner, is_nsfw und der Community-URL. (Doku)
curl -X POST "https://api.socq.ai/v1/x/search-communities" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "bitcoin", "results_limit": 20}'
Übergeben Sie eine Community-URL (/i/communities/{numeric_id}) an Community Members, um ihre Mitglieder als vollständige Profile zu erhalten. (Doku)
curl -X POST "https://api.socq.ai/v1/x/community-members" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 20}'
Community Moderators liefert das vollständige Team, einschließlich Admins, in einer Anfrage. Das sind die Ansprechpartner für ein Sponsoring oder ein AMA. (Doku)
curl -X POST "https://api.socq.ai/v1/x/community-moderators" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/communities/1493446837214187523"]}'
Beschreibung und Regeln einer Community behandelt der Leitfaden zu Community-Details, ihre Beiträge der Leitfaden zu Community-Beiträgen.
Medien und Antworten eines Kontos erfassen
Beide erwarten einen username; results_limit ist standardmäßig 20 und akzeptiert 1 bis 1000.
Media Scraper liefert die Beiträge aus dem Medien-Tab eines Kontos, neueste zuerst, mit Text, Interaktionen, Aufrufen und den Mediendateien. Videos verweisen auf die MP4-Datei in der höchsten verfügbaren Qualität. (Doku)
curl -X POST "https://api.socq.ai/v1/x/user-media" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "NASA", "results_limit": 20}'
User Replies liefert den Antworten-Tab des Kontos, neueste zuerst. Jede Antwort enthält in_reply_to mit Text, Autor, Link und Zeit des beantworteten Beitrags, sodass jede Zeile als vollständiger Austausch lesbar ist. (Doku)
curl -X POST "https://api.socq.ai/v1/x/user-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "elonmusk", "results_limit": 20}'
Für ganze Unterhaltungen siehe den Leitfaden zum Thread-Kontext.
Artikel, Spaces und Gesprochenes in Videos lesen
Articles nimmt die URL des Beitrags entgegen, der einen Artikel veröffentlicht (/{username}/status/{post_id}), und liefert title, die Vorschauzeile als summary, den vollständigen Text in text, Coverbild, Autor sowie Likes, Antworten, Zitate und Aufrufe. Ein Beitrag, der kein Artikel ist, liefert keine Zeile; ist keine der URLs ein Artikel, schlägt die Aufgabe fehl und wird nicht berechnet. (Doku)
curl -X POST "https://api.socq.ai/v1/x/article" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/USDOL/status/2119796255089947070"]}'
Spaces erwartet Links im Format /i/spaces/{space_id}. Jeder Space liefert Titel, status (geplant, live oder beendet), scheduled_start_at, Hosts, Sprecher, Live-Zuhörer, Aufrufe der Aufzeichnung und is_replay_available. (Doku)
curl -X POST "https://api.socq.ai/v1/x/space" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]}'
Video Transcript wandelt das Gesprochene im Video eines Beitrags in reinen Text um, mit duration_seconds. Ein Video bis 2 Minuten kostet 0,7 Credits. Ein längeres Video kostet 4 Credits ($0,02) für jede angefangene Minute seiner Gesamtlänge, ein 3-minütiges Video kostet also 12 Credits ($0,06). Beiträge ohne Video liefern keine Zeile und werden nicht berechnet. (Doku)
curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/NASA/status/2119833829389041896"]}'
Verwandte X-Leitfäden
Für einen Vergleich von SocQ mit anderen X-Datenanbietern und der offiziellen API lesen Sie Twitter API Preise und die besten Alternativen zur X API, Die 7 besten Twitter/X-Scraper-APIs und TwitterAPI.io-Alternativen.
FAQ
Was liefert die X Account Location API, wenn X kein Land angibt?
Eine Zeile mit country auf null. Die anderen Felder, etwa connected_via und das Beitrittsdatum, werden trotzdem geliefert.
Warum muss results_limit ein Vielfaches von 20 sein?
Das ist die Regel für Verified Followers, List Tweets, List Members, List Followers und Community Members: 20 bis 2000 in Schritten von 20, pro Eingabe. Communities Search verwendet Schritte von 10 zwischen 10 und 500.
Wird mir etwas für Beiträge berechnet, die keine Artikel sind oder kein Video haben?
Nein. Solche Beiträge liefern keine Zeile, und Sie bezahlen nur für zurückgegebene Zeilen. Ist keine der an die Articles API gesendeten URLs ein Artikel, schlägt die Aufgabe fehl und wird nicht berechnet.
Was kostet das Transkript eines langen Videos?
Bis 2 Minuten: 0,7 Credits. Länger: 4 Credits pro angefangener Minute der Gesamtlänge, also 12 Credits für 3 Minuten und 20 Credits ($0,10) für 5 Minuten.
Kann ich viele Follow-Beziehungen auf einmal prüfen?
Ja. Follow Checker vergleicht ein Konto in einer Anfrage mit bis zu 100 anderen und berechnet 0,7 Credits pro Paar.
X API
Workflow mit einer öffentlichen X-URL testen
Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.
X-APIs ansehen