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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche öffentliche Status-URLs von x.com oder twitter.com mit einer numerischen Post-ID; mehrere Werte trennen Sie durch Kommas oder Zeilenumbrüche. |
results_limit | Optional | Maximale 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.
- Bereiten Sie eine oder mehrere öffentliche URLs von x.com oder twitter.com vor, deren Pfade /status/{numeric_post_id} enthalten.
- Senden Sie urls mit einem results_limit von 100 bis 2.000 in Schritten von 100 per POST.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
- 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_cursorAnwendungsfä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.
Verwandte APIs
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.
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API