From 2d3fc6f00fe01658c024804d4d3c4f8285b80207 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Wed, 20 May 2026 23:38:32 +0000
Subject: [PATCH] docs: document new search engagement operators and retweet
exclusion
---
x-api/posts/search/integrate/operators.mdx | 16 ++++++++++++++++
x-api/posts/search/introduction.mdx | 4 ++++
2 files changed, 20 insertions(+)
diff --git a/x-api/posts/search/integrate/operators.mdx b/x-api/posts/search/integrate/operators.mdx
index 81a52249b..8fb42f979 100644
--- a/x-api/posts/search/integrate/operators.mdx
+++ b/x-api/posts/search/integrate/operators.mdx
@@ -128,6 +128,22 @@ Operators are used to match on specific Post attributes. There are two types:
---
+## Engagement Operators
+
+Use engagement operators to filter Posts by minimum likes, replies, or reposts. These operators are available on the `/2/tweets/search/recent` and `/2/tweets/search/all` endpoints.
+
+| Operator | Type | Summary | Example |
+|:---------|:-----|:--------|:--------|
+| `min_likes:` | Conjunction required | Matches Posts with at least the specified number of likes | `from:XDevelopers min_likes:100` |
+| `min_replies:` | Conjunction required | Matches Posts with at least the specified number of replies | `#announcement min_replies:50` |
+| `min_reposts:` | Conjunction required | Matches Posts with at least the specified number of reposts | `lang:en min_reposts:25` |
+
+
+ Combine engagement operators to surface high-signal Posts. For example, `from:XDevelopers min_likes:100 min_reposts:25` returns Posts from `@XDevelopers` with at least 100 likes and 25 reposts.
+
+
+---
+
## Logical Operators
| Operator | Summary | Example |
diff --git a/x-api/posts/search/introduction.mdx b/x-api/posts/search/introduction.mdx
index 7870cad1b..2c70f23ae 100644
--- a/x-api/posts/search/introduction.mdx
+++ b/x-api/posts/search/introduction.mdx
@@ -94,6 +94,10 @@ Build queries using operators that match on Post attributes:
---
+
+Keyword-based search results do not include retweets. To match retweets, use the [Filtered Stream](/x-api/posts/filtered-stream/introduction) endpoints.
+
+
## Recent Search
Search Posts from the **last 7 days**. Available to all developers.