From 62869e8731d4eed6c81ca26fa585bb3a80060f00 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 20 May 2026 23:03:12 +0000 Subject: [PATCH 1/2] docs: document new search engagement operators and index migration --- .../posts/search/integrate/operators.mdx | 16 ++++++++++++++++ x-api/posts/search/integrate/operators.mdx | 16 ++++++++++++++++ x-api/posts/search/introduction.mdx | 12 ++++++++++++ 3 files changed, 44 insertions(+) diff --git a/enterprise-api/posts/search/integrate/operators.mdx b/enterprise-api/posts/search/integrate/operators.mdx index 81a52249b..0b0286a1b 100644 --- a/enterprise-api/posts/search/integrate/operators.mdx +++ b/enterprise-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 + +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, surfacing higher-signal content during a real-time event or filtering 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..0b0286a1b 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 + +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, surfacing higher-signal content during a real-time event or filtering 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..a10fce036 100644 --- a/x-api/posts/search/introduction.mdx +++ b/x-api/posts/search/introduction.mdx @@ -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 From 9d2a8fbb979a16b61e39c72c451d00a242f73742 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 20 May 2026 23:06:41 +0000 Subject: [PATCH 2/2] docs: improve SEO descriptions and tighten engagement operator copy --- enterprise-api/posts/search/integrate/operators.mdx | 6 ++++-- x-api/posts/search/integrate/operators.mdx | 6 ++++-- x-api/posts/search/introduction.mdx | 2 +- 3 files changed, 9 insertions(+), 5 deletions(-) diff --git a/enterprise-api/posts/search/integrate/operators.mdx b/enterprise-api/posts/search/integrate/operators.mdx index 0b0286a1b..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"] --- @@ -130,7 +130,9 @@ 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, surfacing higher-signal content during a real-time event or filtering long-tail noise from a broad topic query. +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 | |:---------|:-----|:--------|:--------| diff --git a/x-api/posts/search/integrate/operators.mdx b/x-api/posts/search/integrate/operators.mdx index 0b0286a1b..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"] --- @@ -130,7 +130,9 @@ 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, surfacing higher-signal content during a real-time event or filtering long-tail noise from a broad topic query. +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 | |:---------|:-----|:--------|:--------| diff --git a/x-api/posts/search/introduction.mdx b/x-api/posts/search/introduction.mdx index a10fce036..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"] ---