Zurück zu den APIs
Öffentliche X-Daten

X Public Data API

Erfassen Sie öffentliche Profile, Follower- und Gefolgten-Beziehungen, Posts, Antworten, Zitat-Posts, Reposter, Suchergebnisse und aktuelle Trends. Nutzen Sie einheitliche Ergebnisse für Recherche und Monitoring.

Verfügbare X-APIs

Wählen Sie die API, die zu Ihrem Ausgangspunkt passt: ein Benutzername, die URL eines Posts, eine Kontoliste, eine Suchanfrage oder eine bekannte numerische WOEID.

Welche X-Daten können Sie abrufen?

Bauen Sie einen Datensatz rund um Kontoidentität, bekannte Inhalte, aktuelle Veröffentlichungsaktivität, die Suche nach Posts oder aktuelle Themen je Standort auf.

Öffentliche Kontoprofile

Machen Sie aus Benutzernamen Profilidentität, Bio, visuelle Elemente, Kontostatus, Reichweitenkennzahlen, Follower-Listen, Gefolgten-Listen und den Erfassungszeitpunkt.

Details bekannter Posts

Lösen Sie öffentliche Status-URLs in Post-Details, Antworten, Zitat-Posts, Profile von Repostern, Medien, Beziehungen und sichtbare Interaktion auf.

Aktuelle Posts je Konto

Erfassen Sie aktuelle öffentliche Posts ausgewählter Benutzernamen ohne Antworten und vergleichen Sie die Aktivität über eine Kontoliste hinweg.

Post-Suche und Entdeckung

Durchsuchen Sie öffentliche Posts mit einer Suchanfrage, wählen Sie die Sortierung nach neuesten oder Top und behalten Sie die Anfrage bei jedem Treffer bei.

Aktuelle Trends per WOEID

Erfassen Sie eine standortbezogene Momentaufnahme mit Trendnamen, Rängen aus der Quelle, Suchanfragen, Beschreibungen und Beobachtungszeiten.

SocQ vs Entwicklerprodukte von X

SocQ ist für einheitliche Recherche-Workflows mit öffentlichen Daten gebaut. Die Entwicklerprodukte von X unterstützen von X verwaltete Integrationen im Rahmen ihrer eigenen Produkte und Autorisierungsanforderungen.

WorkflowSocQ-X-EndpunkteEntwicklerprodukte von X
Passt am besten fürProfilanreicherung, Post-Recherche, Monitoring und das Entdecken öffentlicher ThemenVon X verwaltete Anwendungs- und Kontointegrationen
AusgangseingabeBenutzernamen, Status-URLs, Kontolisten, ein Suchausdruck oder bekannte WOEIDsProduktspezifische Anfragen und autorisierter Kontokontext
AuthentifizierungSocQ-API-SchlüsselEntwicklerzugangsdaten von X und die jeweilige Autorisierung
DatenformNormalisierte Datensätze zu Profilen, Posts und TrendsProduktspezifische native X-Antworten
VerarbeitungsmodellAsynchrone Aufgabe, danach Paginierung der ErgebnisseProduktspezifischer Ablauf von Anfrage und Antwort

So funktioniert die X API

Jede X-API folgt demselben Muster: senden, verfolgen, abrufen.

  1. 1. Eingabe senden

    Senden Sie Benutzernamen, Status-URLs, eine Kontoliste, eine Suchanfrage oder numerische WOEIDs an die passende API.

  2. 2. Aufgabe verfolgen

    Fragen Sie mit task_id den Endpunkt /v1/tasks/{task_id} ab, bis die Verarbeitung abgeschlossen ist.

  3. 3. Ergebnisse abrufen

    Lesen Sie data.results.items und nutzen Sie next_cursor, solange has_more den Wert true hat.

Mit einer API-Anfrage beginnen

Authentifizieren Sie sich mit Ihrem SocQ-API-Schlüssel und senden Sie einen oder mehrere X-Benutzernamen. Posts, User Posts, Search und Trends folgen demselben Aufgabenablauf.

curl -X POST "https://api.socq.ai/v1/x/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["nasa","@OpenAI"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Typische Anwendungsfälle der X API

Creator- und Partnerrecherche

Reichern Sie bekannte Benutzernamen an, vergleichen Sie öffentliche Kontosignale und bauen Sie einheitliche Creator-Profile auf.

Marken- und Marktbeobachtung

Verfolgen Sie ausgewählte Konten, wiederholen Sie stabile Suchen oder erfassen Sie Trends für bekannte WOEIDs, um Datensätze mit Zeitstempel zu Marken, Wettbewerbern und Themen aufzubauen.

Reporting zu Kampagneninhalten

Lösen Sie die URLs von Kampagnen-Posts auf und ordnen Sie Inhalte, Autoren, Medien, Beziehungen und die Interaktion zum Erfassungszeitpunkt.

Recherche und Datenprodukte

Nutzen Sie einheitliche Profil- und Post-Datensätze in Data Warehouses, Klassifikatoren, Suchindizes, Prüfwerkzeugen und Dashboards.

Grenzen und Richtlinie für öffentliche Daten

SocQ liefert öffentlich zugängliche X-Daten so, wie sie bei der Ausführung der Aufgabe erscheinen.

  • Profilzähler und Post-Interaktion sind Momentaufnahmen, die an collected_at gebunden sind.
  • Suchergebnisse folgen der gewählten Sortierung nach neuesten oder Top zum Zeitpunkt der Erfassung.
  • Trendränge und Beschreibungen stammen aus der Quelle und gelten für die angeforderte WOEID zum Zeitpunkt der Erfassung.
  • results_limit legt ein Maximum fest, aber die Anzahl der zurückgegebenen Datensätze hängt von den geeigneten öffentlichen Datensätzen ab, die während der Aufgabe verfügbar sind.
  • Die APIs lesen ausschließlich öffentliche Daten; sie veröffentlichen keine Posts und verwalten keine X-Konten.

Häufige Fragen zur X API

Was kann ich mit der X API erfassen?

Sie können öffentliche Profile, Follower- und Gefolgten-Listen, bekannte Posts, aktuelle Posts, Antworten, Zitat-Posts, Profile von Repostern, Suchergebnisse und aktuelle Trends für bekannte numerische WOEIDs abrufen.

Welche X-API sollte ich wählen?

Verwenden Sie Profiles, Followers List oder Following List für Konten; Posts, Post Replies, Post Quotes oder Post Retweeters für Status-URLs; User Posts für die aktuelle Aktivität eines Kontos; Search für die Suche per Anfrage und Trends für bekannte numerische WOEIDs.

Wie läuft die Verarbeitung der Aufgaben ab?

Senden Sie eine POST-Anfrage, fragen Sie /v1/tasks/{task_id} ab, lesen Sie dann data.results.items und fahren Sie mit next_cursor fort, solange has_more den Wert true hat.

Was enthält jedes Ergebnis?

Die Ergebnisse enthalten die Felder, die für die jeweilige API verfügbar sind, zum Beispiel Profilidentität, Inhalt und Medien eines Posts oder Trendname, Rang aus der Quelle, WOEID, Suchanfrage, Beschreibung und Erfassungszeitpunkt.

Sind X-Kennzahlen in Echtzeit?

Nein. Kontozähler, Post-Interaktion und Trendränge sind Momentaufnahmen. Verwenden Sie collected_at als Beobachtungszeitpunkt, wenn Sie Ergebnisse vergleichen.

Wie wird die Erfassung von X-Daten abgerechnet?

Profiles kosten 0,6 Credits pro Ergebnis, direkte Posts, User Posts und Trends kosten 0,5 und Suchergebnisse kosten 0,7.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.