v2

latestOpenAPI 3.1.02026-08-075421692.0 MB

Twitter Engagement

Search recent tweets

Search public tweets from the last 7 days matching an X search query, e.g. to discover tweets to reply to. The query string is passed through to X unchanged and supports X's search operators (from:user, -is:retweet, is:reply, lang:en, "exact phrase", conversation_id:123, boolean OR, ...). Note that standalone operators like is: / has: / lang: must be combined with a keyword or from: clause.

To reply to a found tweet, pass its id as the twitter platform entry's platformSpecificData.replyToTweetId when creating a post.

Rate limit: 300 requests per 15-min window per connected account.

get/v1/twitter/search

Query parameters

accountIdstring required

The social account ID

querystring required

X search query, max 512 characters. Operators are passed through unchanged; X rejects malformed queries with a 400.

limitinteger

Results per page. X requires a minimum of 10; values below 10 are rejected.

sinceIdstring

Only return tweets with an ID greater than (more recent than) this numeric tweet ID. Non-numeric values are rejected with 400.

untilIdstring

Only return tweets with an ID less than (older than) this numeric tweet ID. Non-numeric values are rejected with 400.

startTimestring date-time

Oldest UTC timestamp (ISO 8601, inclusive), within the last 7 days

endTimestring date-time

Newest UTC timestamp (ISO 8601, exclusive), within the last 7 days

cursorstring

Pagination cursor from a previous response

sortOrder'recency' | 'relevancy'

Response

Matching tweets

statusstring

Example response

{
  "status": "success",
  "tweets": [
    {
      "platform": "twitter"
    }
  ],
  "meta": {
    "platform": "twitter"
  }
}