diff --git a/enterprise-api/posts/search/integrate/operators.mdx b/enterprise-api/posts/search/integrate/operators.mdx index 81a52249b..216713bb1 100644 --- a/enterprise-api/posts/search/integrate/operators.mdx +++ b/enterprise-api/posts/search/integrate/operators.mdx @@ -1,7 +1,7 @@ --- title: Search Operators sidebarTitle: Operators -description: Complete list of operators for Search queries +description: Reference for Enterprise Search operators — keywords, users, URLs, hashtags, engagement thresholds, language, geo, and Post type filters with examples. keywords: ["search operators", "query operators", "search syntax", "search filters", "operators guide", "query syntax"] --- @@ -128,6 +128,24 @@ Operators are used to match on specific Post attributes. There are two types: --- +## Engagement Operators + +These precision operators filter Posts by minimum engagement counts. They are available on `/2/tweets/search/recent`, `/2/tweets/search/all`, `/2/tweets/counts/recent`, and `/2/tweets/counts/all` following the May 4, 2026 migration to the new X core platform search index. + +Use them to narrow results to Posts that crossed an engagement threshold. For example, surface higher-signal content during a real-time event or filter long-tail noise from a broad topic query. + +| Operator | Type | Summary | Example | +|:---------|:-----|:--------|:--------| +| `min_likes:` | Conjunction required | Matches Posts with at least the specified number of likes | `coffee min_likes:100` | +| `min_replies:` | Conjunction required | Matches Posts with at least the specified number of replies | `from:XDevelopers min_replies:10` | +| `min_reposts:` | Conjunction required | Matches Posts with at least the specified number of reposts | `#launch min_reposts:50` | + + + Engagement counts are evaluated at query time and may lag real-time activity by a short interval. These operators require at least one other standalone operator in the query (they are conjunction-required). + + +--- + ## Logical Operators | Operator | Summary | Example | diff --git a/x-api/posts/search/integrate/operators.mdx b/x-api/posts/search/integrate/operators.mdx index 81a52249b..d82279725 100644 --- a/x-api/posts/search/integrate/operators.mdx +++ b/x-api/posts/search/integrate/operators.mdx @@ -1,7 +1,7 @@ --- title: Search Operators sidebarTitle: Operators -description: Complete list of operators for Search queries +description: Reference for X API v2 Search operators — keywords, users, URLs, hashtags, engagement thresholds, language, geo, and Post type filters with examples. keywords: ["search operators", "query operators", "search syntax", "search filters", "operators guide", "query syntax"] --- @@ -128,6 +128,24 @@ Operators are used to match on specific Post attributes. There are two types: --- +## Engagement Operators + +These precision operators filter Posts by minimum engagement counts. They are available on `/2/tweets/search/recent`, `/2/tweets/search/all`, `/2/tweets/counts/recent`, and `/2/tweets/counts/all` following the May 4, 2026 migration to the new X core platform search index. + +Use them to narrow results to Posts that crossed an engagement threshold. For example, surface higher-signal content during a real-time event or filter long-tail noise from a broad topic query. + +| Operator | Type | Summary | Example | +|:---------|:-----|:--------|:--------| +| `min_likes:` | Conjunction required | Matches Posts with at least the specified number of likes | `coffee min_likes:100` | +| `min_replies:` | Conjunction required | Matches Posts with at least the specified number of replies | `from:XDevelopers min_replies:10` | +| `min_reposts:` | Conjunction required | Matches Posts with at least the specified number of reposts | `#launch min_reposts:50` | + + + Engagement counts are evaluated at query time and may lag real-time activity by a short interval. These operators require at least one other standalone operator in the query (they are conjunction-required). + + +--- + ## Logical Operators | Operator | Summary | Example | diff --git a/x-api/posts/search/introduction.mdx b/x-api/posts/search/introduction.mdx index 7870cad1b..4d93fa99f 100644 --- a/x-api/posts/search/introduction.mdx +++ b/x-api/posts/search/introduction.mdx @@ -1,7 +1,7 @@ --- title: Search Posts sidebarTitle: Introduction -description: Search the full X archive or recent Posts using advanced operators for keywords, hashtags, users, geo, language, engagement metrics, and more. Supports both 7-day recent search and full-archive historical search. +description: Search recent Posts or the full X archive using query operators for keywords, hashtags, users, geo, language, and engagement thresholds. keywords: ["search tweets", "search posts", "recent search", "full archive search", "tweet search", "search API", "search queries", "search operators", "historical search"] --- @@ -86,8 +86,20 @@ Build queries using operators that match on Post attributes: | `-is:reply` | `-is:reply` | Exclude replies | | `is:verified` | `is:verified` | Posts by verified users | + + + | Operator | Example | Description | + |:---------|:--------|:------------| + | `min_likes:` | `coffee min_likes:100` | Posts with at least N likes | + | `min_replies:` | `from:XDevelopers min_replies:10` | Posts with at least N replies | + | `min_reposts:` | `#launch min_reposts:50` | Posts with at least N reposts | + + + As of May 4, 2026, the keyword-based search endpoints (`/2/tweets/search/recent`, `/2/tweets/search/all`, `/2/tweets/counts/recent`, `/2/tweets/counts/all`) run on the new X core platform search index. Retweets are no longer returned in keyword-based search results — use the `retweets_of:` operator, `GET /2/tweets/:id/retweets`, or the [Filtered Stream](/x-api/posts/filtered-stream/introduction) (unchanged) if you need retweet coverage. + + See all available operators and their access requirements