Dokumentation der X/Twitter-API

X/Twitter API: Suche — Beiträge nach Suchanfrage

Finden Sie Suche-Daten auf X/Twitter anhand einer Nutzeranfrage und binden Sie die Ergebnisse an Such-, Katalog- oder Rechercheoberflächen an.

Nutzen Sie „Beiträge nach Suchanfrage“, wenn Sie die genaue Objekt-ID nicht kennen und zuerst relevante Kandidaten finden müssen.

Methode GET
Entität Suche
Versionen 2
Was dieser Endpunkt macht

Was Sie mit dieser API-Methode bauen können

Prüfen Sie zuerst das Ergebnis und die typischen Abläufe und gehen Sie dann zu den Parametern und einem funktionierenden Anfragebeispiel über.

Wobei dieser Endpunkt hilft

Die Antwort enthält passende Suche, öffentlichen Kontext und Paginierungsdaten, wenn weitere Ergebnisse vorhanden sind.

Wann er sinnvoll ist

Nutzen Sie „Beiträge nach Suchanfrage“, wenn Sie die genaue Objekt-ID nicht kennen und zuerst relevante Kandidaten finden müssen.

Typische Anwendungsfälle

Suche im Produkt

Ergänzen Sie Kunden- und interne Oberflächen um die Suche in X/Twitter-Daten.

Aufbau von Katalogen

Finden Sie Kandidaten per Anfrage und speichern Sie relevante Objekte für die spätere Anreicherung.

Marktforschung

Sammeln Sie Ergebnissätze für Analysen von Themen, Creatorn und Wettbewerb.

Verfügbare Versionen

Antwortversion

Beide Versionen lösen dieselbe Aufgabe und akzeptieren dieselben Parameter. Vergleichen Sie mit dem Umschalter die Antwortstruktur und wählen Sie die Version, die Ihr Client erwartet.

Antwortversion V2

Wechseln Sie auf dieser Seite die Version, um die Antwortstrukturen unter derselben Dokumentations-URL zu vergleichen.

Was gleich bleibt

Authentifizierung, Pflichtparameter und Anfrageform sind in V1 und V2 identisch. In der Praxis wählen Sie die Version beim Aufbau des Endpunktpfads und bei der Auswertung der Antwort.

Was sich zwischen den Versionen ändert

Der Hauptunterschied liegt in der Antwort-Hülle. Verwenden Sie V2 für neue Integrationen und behalten Sie V1 nur, wenn Sie Kompatibilität mit einem bestehenden Client-Vertrag benötigen.

So verwenden Sie ihn

So rufen Sie die Methode auf

Verwenden Sie in beiden Versionen denselben API-Schlüssel-Header und dieselben Query-Parameter. Diese Dokumentation zeigt zuerst den gemeinsamen Parametersatz und danach die Pfade und Codeausschnitte jeder Version.

Eingabeparameter

Gemeinsame Parameter
Parameter Pflicht Typ Beispiel Beschreibung
query Ja str technology Vom Nutzer eingegebene Suchanfrage.
all_of_these_words Nein str | None AI robotics Optional words that must all appear in matching Twitter/X posts. Example: AI robotics.
any_of_these_words Nein str | None launch release Optional words where any one may appear in matching Twitter/X posts. Example: launch release.
cursor Nein str | None DAABCgABF4ABCD... Cursor der nächsten Seite aus der vorherigen Antwort. Für die erste Seite weglassen.
exact_phrase Nein str | None machine learning Optional exact phrase that must appear in matching Twitter/X posts. Example: machine learning.
from_accounts Nein str | None technews xai Optional source accounts without or with @, separated by spaces or commas. Example: technews xai.
hashtags Nein str | None #TechNews #AI Optional hashtags to require, separated by spaces or commas. Example: #TechNews #AI.
language Nein str | None en Optional Twitter/X language code. Use 'any' to omit language filtering. Example: en.
link_filter Nein include | only | exclude | None only Optional link filter: include all posts, only posts with links, or exclude links. Example: only.
mentioning_accounts Nein str | None technews elonmusk Optional mentioned accounts without or with @, separated by spaces or commas. Example: technews elonmusk.
min_likes Nein int | None 100 Optional minimum like count. Example: 100.
min_replies Nein int | None 10 Optional minimum reply count. Example: 10.
min_retweets Nein int | None 25 Optional minimum repost/retweet count. Example: 25.
none_of_these_words Nein str | None rumor leak Optional words to exclude from matching Twitter/X posts. Example: rumor leak.
reply_filter Nein include | only | exclude | None exclude Optional reply filter: include all posts, only replies, or exclude replies. Example: exclude.
since_date Nein date | None 2026-01-01 Optional earliest post date in ISO YYYY-MM-DD format. Example: 2026-01-01.
tag Nein Top | Latest | People | Photos | Videos | None Latest Optional Twitter/X search product filter. Example: Latest.
to_accounts Nein str | None technews Optional reply target accounts without or with @, separated by spaces or commas. Example: technews.
until_date Nein date | None 2026-01-31 Optional latest post date in ISO YYYY-MM-DD format. Example: 2026-01-31.

Anfragepfad nach Version

V2

Wählen Sie eine Version, wenn Sie den genauen Endpunktpfad, die Beispiel-URL und den Codeausschnitt kopieren. Die Parameterliste oben ändert sich nicht.

GET /api/v2/twitter.com/search/tweets-by-query

Normalisiertes Format

Codebeispiele

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/twitter.com/search/tweets-by-query" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'query=technology' \
  # Optional parameters:
  # --data-urlencode 'all_of_these_words=AI robotics'
  # --data-urlencode 'any_of_these_words=launch release'
  # --data-urlencode 'cursor=DAABCgABF4ABCD...'
  # --data-urlencode 'exact_phrase=machine learning'
  # --data-urlencode 'from_accounts=technews xai'
  # --data-urlencode 'hashtags=#TechNews #AI'
  # --data-urlencode 'language=en'
  # --data-urlencode 'link_filter=only'
  # --data-urlencode 'mentioning_accounts=technews elonmusk'
  # --data-urlencode 'min_likes=100'
  # --data-urlencode 'min_replies=10'
  # --data-urlencode 'min_retweets=25'
  # --data-urlencode 'none_of_these_words=rumor leak'
  # --data-urlencode 'reply_filter=exclude'
  # --data-urlencode 'since_date=2026-01-01'
  # --data-urlencode 'tag=Latest'
  # --data-urlencode 'to_accounts=technews'
  # --data-urlencode 'until_date=2026-01-31'
Antwortbeispiel

Live-Antwort nach Version

Die Vorschau enthält die wichtigsten Felder und die ersten Elemente der Sammlung, damit Sie die Form der Antwort schnell prüfen können. Beim Wechsel der Version ändert sich das JSON-Format.

Antwortbeispiel

V2 Antwort-JSON

Verifiziertes Beispiel

Dieses kompakte JSON-Beispiel stammt aus dem letzten erfolgreichen Verifizierungslauf von V2.

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "query": "Python code",
    "tag": "Top"
  },
  "data": {
    "tweets": {
      "count": 20,
      "items": [
        {
          "url": "https://x.com/freeCodeCamp/status/2078389573567050090",
          "tweet_id": "2078389573567050090",
          "text": "Learning to code can feel overwhelming when you don't know where to start.\n\nSo here's a course for you: Sunny teaches you Python from the ground up.\n\nYou'll install Python, writ…",
          "hashtags": [],
          "emails": [],
          "created_at": "2026-07-18T08:01:03Z",
          "language": "en",
          "source": "Buffer",
          "author": {
            "url": "https://x.com/freeCodeCamp",
            "user_id": "1668100142",
            "username": "freeCodeCamp",
            "display_name": "freeCodeCamp.org",
            "description": "We're a community of millions of people who are building new skills and getting new jobs together. A 501(c)(3) public charity. Tweets by @abbeyrenn.",
            "emails": [],
            "external_links": [],
            "location": "Just here on Earth... for now",
            "created_at": "2013-08-13T15:27:51Z",
            "is_verified": false,
            "is_blue_verified": true,
            "is_protected": false,
            "possibly_sensitive": false,
            "default_profile": false,
            "default_profile_image": false,
            "followers_count": 1204998,
            "following_count": 159,
            "tweet_count": 36772,
            "media_count": 5153,
            "listed_count": 6833,
            "like_count": 72305,
            "professional_type": null,
            "professional_category_name": null,
            "affiliated_account": null,
            "_more_fields": "5 more fields"
          },
          "is_from_automated_account": null,
          "media": {
            "images": [
              "…"
            ],
            "videos": [],
            "gifs": []
          },
          "external_links": [],
          "user_mentions": [],
          "is_reply": false,
          "reply": null,
          "is_quote": false,
          "quote_tweet_id": null,
          "is_retweet": false,
          "retweeted_tweet_id": null,
          "reply_count": 4,
          "retweet_count": 108,
          "quote_count": 3,
          "like_count": 599,
          "bookmark_count": 455,
          "_more_fields": "2 more fields"
        },
        {
          "url": "https://x.com/PythonPr/status/2078910492068786514",
          "tweet_id": "2078910492068786514",
          "text": "Pyramids in Python Code Examples for Beginners ⭐ https://t.co/QngwbiMVkb",
          "hashtags": [],
          "emails": [],
          "created_at": "2026-07-19T18:31:00Z",
          "language": "en",
          "source": "Twitter Web App",
          "author": {
            "url": "https://x.com/PythonPr",
            "user_id": "855384627975831553",
            "username": "PythonPr",
            "display_name": "Python Programming",
            "description": "#python #programming",
            "emails": [],
            "external_links": [],
            "location": "United States",
            "created_at": "2017-04-21T11:36:02Z",
            "is_verified": false,
            "is_blue_verified": true,
            "is_protected": false,
            "possibly_sensitive": false,
            "default_profile": true,
            "default_profile_image": false,
            "followers_count": 208924,
            "following_count": 1162,
            "tweet_count": 9883,
            "media_count": 4108,
            "listed_count": 1243,
            "like_count": 20597,
            "professional_type": null,
            "professional_category_name": null,
            "affiliated_account": null,
            "_more_fields": "5 more fields"
          },
          "is_from_automated_account": null,
          "media": {
            "images": [
              "…"
            ],
            "videos": [],
            "gifs": []
          },
          "external_links": [],
          "user_mentions": [],
          "is_reply": false,
          "reply": null,
          "is_quote": false,
          "quote_tweet_id": null,
          "is_retweet": false,
          "retweeted_tweet_id": null,
          "reply_count": 3,
          "retweet_count": 8,
          "quote_count": 0,
          "like_count": 62,
          "bookmark_count": 39,
          "_more_fields": "2 more fields"
        },
        {
          "_more_items": 18
        }
      ]
    }
  }
}
Nächste Schritte

Setzen Sie die Bewertung fort

Nutzen Sie diese Dokumentation als ersten Entscheidungspunkt und prüfen Sie dann Preise, Plattformabdeckung und Integrationsregeln, bevor Sie den Endpunkt für die wiederkehrende Nutzung anbinden.

Öffnen Sie die Plattformseite X/Twitter

Vergleichen Sie verwandte Entitäten, Gruppen von API-Methoden und die zugehörige Dokumentation vor der Implementierung.

Plattformseite öffnen

Vergleichen Sie die Preise der API-Methoden

Prüfen Sie, wo diese Methode in der öffentlichen Preistabelle steht, bevor Sie die Nutzung skalieren.

Preise ansehen

Prüfen Sie die Integrationsregeln

Bestätigen Sie mit der Einstiegsdokumentation Authentifizierung, Versionen, Wiederholungen und die Unterschiede zwischen Test und Produktion.

Dokumentation öffnen
Häufige Fragen

Fragen, die Teams vor der Implementierung stellen

Nutzen Sie diese Antworten, um zu entscheiden, ob diese API-Methode zu Ihrem Ablauf, Ihrer Versionswahl und Ihrem Einführungsplan passt.

Welche Daten gibt diese Methode der X/Twitter-API zurück?

Die Methode führt „Beiträge nach Suchanfrage“ für Suche aus. Das kompakte Antwortbeispiel unten zeigt die genaue Struktur der Felder.

Soll ich V1 oder V2 wählen?

Wählen Sie V2 für neue Integrationen, da sie eine normalisierte Struktur bietet. Verwenden Sie V1 nur zur Kompatibilität mit Clients, die bereits das native Format der Plattform verarbeiten.

Was brauche ich für die erste Anfrage?

Erstellen Sie einen API-Schlüssel, senden Sie ihn im Header der Anfrage und geben Sie die Pflichtparameter aus der Tabelle an. Die Codebeispiele enthalten bereits den korrekten Pfad und die richtige Anfragestruktur.