Zum Hauptinhalt springen
Die v2-Post-Counts-endpoints ermöglichen es Entwicklern, das Volumen der data für eine bestimmte Abfrage zu verstehen und abzurufen. Dies kann aus mehreren Gründen hilfreich sein, unter anderem:
  • Das Post-Volumen für ein Schlüsselwort verstehen, um Visualisierungen wie Trendlinien zu erstellen.
  • Den Zeitraum bestimmen, in dem ein Ereignis oder eine Unterhaltung stattgefunden hat, um sicherzustellen, dass Ihre Abfrage die relevanten data erfasst.
  • Abschätzen, wie viele Posts eine Suchabfrage zurückgibt, um Ihre Abfrage zu verfeinern, bevor Sie die recent search- oder full-archive search-endpoints verwenden. Bitte beachten: Die counts stimmen nicht immer mit den Ergebnissen überein, die von search-endpoints zurückgegeben werden, da die search-endpoints zusätzliche Compliance-Prüfungen durchlaufen, die die counts-endpoints nicht durchlaufen.
  • Die Größe der Unterhaltung zu einem Thema verstehen, ohne die Rohdaten tatsächlich abrufen zu müssen, und Posts gegen Ihr monatliches Post cap rechnen.
Bei der Entwicklung einer Abfrage sind Sie hinsichtlich der Abfragelänge und der verwendbaren Operatoren durch Ihr access level eingeschränkt.
  • Wenn Sie ein Project mit Pro-Zugang verwenden, können Sie alle verfügbaren Operatoren nutzen und Abfragen mit bis zu 1024 Zeichen Länge ausführen.
  • Wenn Sie ein Project mit Enterprise-Zugang verwenden, können Sie alle verfügbaren Operatoren nutzen und Abfragen mit bis zu 4096 Zeichen Länge ausführen.
Sie können außerdem die Granularität (Tag, Stunde oder Minute) sowie den Zeitraum angeben, für den Sie die Post-Counts benötigen (mithilfe der Parameter start_time und end_time). Die standardmäßige Zeitgranularität, die dieses endpoint verwendet, ist Stunde. Das bedeutet: Wenn Sie den granularity-Parameter nicht angeben, liefert das endpoint die Post-Counts pro Stunde für die letzten 7 Tage.
KontoeinrichtungUm auf diese endpoints zuzugreifen, benötigen Sie:Erfahren Sie mehr darüber, wie Sie Zugriff auf die X API v2 endpoints erhalten, in unserem Getting-Started-Leitfaden.

​
Aktuelle Post-Zählungen

Das endpoint für aktuelle Post-Zählungen ermöglicht es Ihnen, programmgesteuert die Anzahl von Posts für eine Abfrage in den letzten sieben Tagen abzurufen. Dieses endpoint steht allen zur Verfügung, die Keys und Tokens verwenden, die mit einer App innerhalb eines Project verknüpft sind, und verwendet OAuth 2.0 App-Only zur Authentifizierung.

​
Post-Zählungen für das Gesamtarchiv

Das endpoint für Post-Zählungen aus dem Gesamtarchiv ermöglicht es Ihnen, programmgesteuert die Anzahl von Posts für eine query aus dem gesamten Archiv öffentlicher Posts abzurufen. Derzeit ist dieses endpoint nur für Nutzer verfügbar, die für den Academic Research- oder Enterprise-Zugang zugelassen wurden und für die Authentifizierung OAuth 2.0 App-Only verwenden. Ein Beispiel: Sie könnten das endpoint für Post-Zählungen aus dem Gesamtarchiv nutzen, um die Anzahl der Posts mit dem Hashtag #SOSHurricaneHarvey pro Tag zwischen August und September 2017 zu ermitteln. Bitte beachten: Das counts-endpoint paginiert mit 31 Tagen pro Antwort. Wenn Sie beispielsweise eine Granularität von day festlegen, wird die Anzahl der Ergebnisse pro Tag für 31 Tage pro Seite zurückgegeben. Wenn Sie eine Granularität von hour festlegen, wird die Anzahl der Ergebnisse pro Stunde für 744 Stunden (31 Tage × 24 Stunden) pro Seite zurückgegeben. Wenn Sie die Granularität und den Zeitraum nicht angeben, liefert dieses endpoint Post-Zählungen für eine query pro Stunde für die letzten 30 Tage.
⌘I