x/
post-retweeters

Normalisierte öffentliche Profile von Konten erfassen, die bekannte X- oder Twitter-Posts repostet haben – mit Deduplizierung innerhalb der Aufgabe, sichtbaren Kontosignalen und Profilkennzahlen.

X Post Retweeters API

Repost-Zielgruppen
Öffentliche Profile
Deduplizierung pro Aufgabe
0,5 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

X Post Retweeters

Datensätze von X Post Retweeters identifizieren öffentliche Konten, bei denen beobachtet wurde, dass sie bekannte X- oder Twitter-Status-URLs repostet haben, und normalisieren deren Profilidentität, öffentliche Kontosignale, sichtbare Zähler und Erfassungszeitpunkt. Mehrere Quellposts werden unabhängig voneinander durchlaufen, danach werden die gespeicherten Profile über die gesamte Aufgabe hinweg dedupliziert, ohne dass die Zuordnung zum Quellpost in jedem Ergebnis erhalten bleibt.

Funktionen der X Post Retweeters API

  • Auflösung von Status-URLsNimmt öffentliche Status-URLs von x.com und twitter.com entgegen und ermittelt die numerische Post-Kennung, die zum Erfassen der sichtbaren Reposter-Liste nötig ist.
  • Normalisierte KontoprofileLiefert Profil-ID, Benutzername, Anzeigename, kanonische Profil-URL, Biografie, Avatar, Titelbild und öffentliche Kontomerkmale, sofern verfügbar.
  • Sichtbare ProfilkennzahlenErfasst die verfügbaren Zahlen zu Followern, Gefolgten, Posts, Medien und Likes zusammen mit den Zeitstempeln von Kontoerstellung und Erfassung.
  • Eindeutige Ergebnismenge über mehrere PostsDurchläuft jeden übergebenen Post mit eigener Ergebnisobergrenze und speichert jedes normalisierte Profil über die abgeschlossene Aufgabe hinweg nur einmal.

Parameter der X Post Retweeters API

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche öffentliche Status-URLs von x.com oder twitter.com mit einer numerischen Post-ID; mehrere Werte trennen Sie durch Kommas oder Zeilenumbrüche.
results_limitOptionalMaximale Anzahl Profile, die für jeden Quellpost unabhängig angefordert werden; Standard ist 100, zulässig sind Vielfache von 100 von 100 bis 2.000.

So verwenden Sie die X Post Retweeters API

Senden Sie bekannte öffentliche Status-URLs als asynchrone Aufgabe, fragen Sie ihren Status ab und blättern Sie anschließend durch die eindeutigen normalisierten Profilergebnisse.

  1. Bereiten Sie eine oder mehrere öffentliche URLs von x.com oder twitter.com vor, deren Pfade /status/{numeric_post_id} enthalten.
  2. Senden Sie urls mit einem results_limit von 100 bis 2.000 in Schritten von 100 per POST.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
  4. Lesen Sie /v1/tasks/{task_id}?limit=50 und geben Sie results.next_cursor weiter, solange results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/x/post-retweeters" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursor

Anwendungsfälle der X Post Retweeters API

  • Zielgruppen der Verbreitung entdecken: Bauen Sie ein eindeutiges Verzeichnis öffentlicher Konten auf, bei denen beobachtet wurde, dass sie ausgewählte Posts verbreiten, für Recherche, Prüfung oder die Vorbereitung von Kontaktaufnahmen.
  • Anreicherung von Reposter-Profilen: Ergänzen Sie einen Datensatz zur Verbreitung um kanonische Profile, Biografien, Bilder, öffentliche Kontomerkmale, Standorte, Websites und sichtbare Kennzahlen.
  • Überschneidung von Zielgruppen über mehrere Posts: Führen Sie pro Aufgabe einen Quellpost aus und vergleichen Sie stabile Profil-IDs über abgeschlossene Ergebnismengen hinweg, wenn die Überschneidung oder Zuordnung pro Post wichtig ist.

Profi-Tipps zur X Post Retweeters API

  • Bringen Sie Status-URLs in eine kanonische Form und deduplizieren Sie sie vor dem Bündeln anhand der numerischen Post-ID, denn unterschiedliche URL-Formen desselben Posts fallen bei der Eingabeprüfung nicht zwingend zusammen.
  • Verstehen Sie results_limit als Obergrenze pro Quellpost und nicht als garantierte Ergebniszahl; öffentliche Sichtbarkeit und verfügbare Paginierung können zu weniger Profilen führen.
  • Verwenden Sie pro Aufgabe nur eine Quell-URL, wenn die Zuordnung zur Quelle wichtig ist, denn normalisierte Profilergebnisse behalten weder die URL noch die ID des ursprünglichen Posts.
  • Folgen Sie dem undurchsichtigen results.next_cursor der Aufgabe unabhängig von der Paginierung der Erfassung; der öffentliche Cursor blättert durch bereits gespeicherte normalisierte Ergebnisse.
  • Nutzen Sie die Profil-ID als dauerhaften Schlüssel zum Zusammenführen über Aufgaben hinweg und verknüpfen Sie sich ändernde öffentliche Zähler mit collected_at.
  • Lassen Sie nullable Profilfelder und leere Ergebnisse zu, denn öffentliche Biografien, Bilder, Kontosignale, Zähler oder die Sichtbarkeit der Reposter können fehlen.

Ergänzend zur X Post Retweeters API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher X-Daten benötigen.

  • Twitter Tweet Scraper API — Öffentliche Post-Texte, Autoren, Interaktionen, Medien, Hashtags, Erwähnungen und Gesprächsbeziehungen aus Status-URLs von x.com oder twitter.com abrufen.
  • Twitter Profile Scraper API — Öffentliche Kontoidentität, Bios, Avatare, Titelbilder, Kontostatus und sichtbare Statistiken zur Zielgruppe per Benutzername abrufen.
  • X Followers List API — Identitäten öffentlicher Follower-Konten und sichtbare Profilkennzahlen zu einem oder mehreren X-Benutzernamen erfassen.
  • X Following List API — Profile erfassen, denen öffentliche X-Konten folgen – mit Identität, Bios, Kontosignalen, sichtbaren Zählern und Quell-Benutzernamen.
  • X Post Quotes API — Öffentliche Zitat-Posts zu bekannten Status-URLs erfassen – mit Kommentar, Autoren, Interaktionen, Medien, Zeitstempeln und Kontext des Quell-Posts.
  • X Community API — Aus Community-Links Beschreibung, Mitgliederzahlen, Regeln und Beitrittsregeln auslesen.

Weitere Plattformen entdecken

Kombinieren Sie X-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

X Post Retweeters API — FAQ

X Post Retweeters API ruft normalisierte öffentliche Profildatensätze zu Konten ab, bei denen beobachtet wurde, dass sie einen oder mehrere bekannte X- oder Twitter-Posts repostet haben.

Senden Sie http- oder https-URLs auf x.com, www.x.com, m.x.com, mobile.x.com, twitter.com, www.twitter.com, m.twitter.com oder mobile.twitter.com mit einem Pfad, der /status/{numeric_post_id} enthält.

Das Limit gilt unabhängig für jeden Quellpost, ist standardmäßig 100 und muss ein Vielfaches von 100 zwischen 100 und 2.000 sein.

Ein Ergebnis kann Profil-ID, Benutzername, Name, kanonische URL, Biografie, Avatar, Titelbild, Signale zu Verifizierung und Datenschutz, sichtbare Kennzahlen, Zeitpunkt der Kontoerstellung, Erfassungszeitpunkt und weitere öffentliche Kontosignale enthalten.

Nein. Die Ergebnisse sind normalisierte Profildatensätze der beobachteten Reposter; sie enthalten weder Repost-Objekte noch hinzugefügte Kommentare oder Inhalte von Zitat-Posts.

Nein. Profile werden über die Aufgabe hinweg dedupliziert, und der normalisierte Datensatz behält weder die URL noch die ID seines Quellposts. Senden Sie pro Aufgabe einen Post, wenn Sie diese Zuordnung brauchen.

results_limit ist eine Obergrenze. Ein Post kann weniger sichtbare Reposter haben, die Paginierung der Erfassung kann enden, nicht verfügbare Konten können fehlen, und dasselbe Profil wird über die Aufgabe hinweg nur einmal gespeichert.

Die endgültige Nutzung beträgt 0,5 Credits pro eindeutig gespeichertem Profil, ohne Grundgebühr. Die vorab belastete Schätzung nutzt die Anzahl der übergebenen URLs und das results_limit pro Post, und ein leeres Ergebnis kostet null Credits.