Tweets nach Keyword suchen

X/Twitter nach Tweets durchsuchen, die Keywords oder Hashtags entsprechen

GET /listen/keyword

cURL

curl \
  -H "Authorization: Bearer API_KEY" \
  -H "x-twitter-oauth1-api-key: YOUR_TWITTER_API_KEY" \
  -H "x-twitter-oauth1-api-secret: YOUR_TWITTER_API_SECRET" \
  -X GET "https://api.ayrshare.com/api/listen/keyword?query=ayrshare%20OR%20%23socialmedia&platform=twitter&limit=15"

200: Success

{
  "status": "success",
  "platform": "twitter",
  "query": "ayrshare OR #socialmedia",
  "tweets": [
    {
      "id": "1234567890",
      "text": "Just discovered @ayrshare for managing social media APIs!",
      "createdAt": "2026-03-22T14:30:00.000Z",
      "user": {
        "id": "987654321",
        "name": "Jane Doe",
        "screenName": "janedoe",
        "profileImageUrl": "https://pbs.twimg.com/profile_images/..."
      },
      "metrics": {
        "retweetCount": 5,
        "favoriteCount": 12
      },
      "entities": {
        "hashtags": ["socialmedia"],
        "mentions": ["ayrshare"],
        "urls": []
      },
      "inReplyToStatusId": null,
      "isRetweet": false,
      "lang": "en"
    }
  ],
  "meta": {
    "pagination": {
      "hasMore": true,
      "next": "b26v89c19zqg8o3fpds7h...",
      "limit": 15
    }
  }
}

Durchsuchen Sie X/Twitter nach Tweets, die Keywords, Hashtags und erweiterten Suchoperatoren entsprechen. Gibt normalisierte Tweet-Daten zurück, einschließlich Nutzerinformationen, Engagement-Metriken und Entitäten.

Dieser Endpunkt erfordert Bring Your Own Keys (BYOK) für X/Twitter.

Wichtige Einschränkungen

• Es sind nur Tweets aus den letzten ~7 Tagen verfügbar (Einschränkung der X-API).
• Standardmäßiges Tageslimit von 25 Aufrufen.
• BYOK-Schlüssel für X/Twitter sind erforderlich.

​

Header-Parameter

​

Query-Parameter

query · string · erforderlich

Keyword-Suchanfrage. Unterstützt X/Twitter-Suchoperatoren (siehe Tabelle unten).

Beispiele: ayrshare, #socialmedia, ayrshare OR #socialmedia, from:ayrshare.

platform · string · erforderlich

Muss twitter sein.

limit · integer · Standard: 15

Maximale Anzahl der zurückzugebenden Tweets. Muss zwischen 10 und 100 liegen.

sinceId · string

Gibt Tweets mit einer ID zurück, die größer (neuer) als dieser Wert ist. Nützlich, um nur neue Tweets seit einer vorherigen Anfrage abzurufen.

untilId · string

Gibt Tweets mit einer ID zurück, die kleiner (älter) als dieser Wert ist. Nützlich, um rückwärts durch Ergebnisse zu paginieren.

next · string

Paginierungstoken aus dem meta.pagination.next einer vorherigen Antwort. Verwenden Sie dies, um die nächste Ergebnisseite abzurufen.

​

Suchoperatoren

Der Parameter query unterstützt die folgenden X/Twitter-Suchoperatoren:

Operator	Beschreibung	Beispiel
AND	Beide Begriffe müssen vorkommen (Standardverhalten)	social AND media
OR	Einer der Begriffe muss vorkommen	ayrshare OR socialmedia
from:	Tweets von einem bestimmten Nutzer	from:ayrshare
to:	Tweets, die an einen bestimmten Nutzer gerichtet sind	to:ayrshare
#	Übereinstimmung mit einem Hashtag	#socialmedia
@	Übereinstimmung mit einer Erwähnung	@ayrshare
-	Einen Begriff ausschließen	social -spam
lang:	Nach Sprache filtern	ayrshare lang:en
filter:	Nach Inhaltstyp filtern	ayrshare filter:links
url:	Übereinstimmung mit einer URL	url:ayrshare.com

cURL

curl \
  -H "Authorization: Bearer API_KEY" \
  -H "x-twitter-oauth1-api-key: YOUR_TWITTER_API_KEY" \
  -H "x-twitter-oauth1-api-secret: YOUR_TWITTER_API_SECRET" \
  -X GET "https://api.ayrshare.com/api/listen/keyword?query=ayrshare%20OR%20%23socialmedia&platform=twitter&limit=15"

200: Success

{
  "status": "success",
  "platform": "twitter",
  "query": "ayrshare OR #socialmedia",
  "tweets": [
    {
      "id": "1234567890",
      "text": "Just discovered @ayrshare for managing social media APIs!",
      "createdAt": "2026-03-22T14:30:00.000Z",
      "user": {
        "id": "987654321",
        "name": "Jane Doe",
        "screenName": "janedoe",
        "profileImageUrl": "https://pbs.twimg.com/profile_images/..."
      },
      "metrics": {
        "retweetCount": 5,
        "favoriteCount": 12
      },
      "entities": {
        "hashtags": ["socialmedia"],
        "mentions": ["ayrshare"],
        "urls": []
      },
      "inReplyToStatusId": null,
      "isRetweet": false,
      "lang": "en"
    }
  ],
  "meta": {
    "pagination": {
      "hasMore": true,
      "next": "b26v89c19zqg8o3fpds7h...",
      "limit": 15
    }
  }
}