Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 19 additions & 1 deletion enterprise-api/posts/search/integrate/operators.mdx
Original file line number Diff line number Diff line change
@@ -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"]
---

Expand Down Expand Up @@ -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` |

<Note>
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).
</Note>

---

## Logical Operators

| Operator | Summary | Example |
Expand Down
20 changes: 19 additions & 1 deletion x-api/posts/search/integrate/operators.mdx
Original file line number Diff line number Diff line change
@@ -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"]
---

Expand Down Expand Up @@ -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` |

<Note>
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).
</Note>

---

## Logical Operators

| Operator | Summary | Example |
Expand Down
14 changes: 13 additions & 1 deletion x-api/posts/search/introduction.mdx
Original file line number Diff line number Diff line change
@@ -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"]
---

Expand Down Expand Up @@ -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 |
</Accordion>

<Accordion title="Engagement operators">
| 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 |
</Accordion>
</AccordionGroup>

<Note>
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.
</Note>

<Card title="Full operator reference" icon="list-check" href="/x-api/posts/search/integrate/operators">
See all available operators and their access requirements
</Card>
Expand Down