Skip to content

docs: document new search engagement operators and retweet behavior #94

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mintlify wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: document new search engagement operators and retweet behavior #94

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
16 changes: 16 additions & 0 deletions x-api/posts/search/integrate/operators.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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` |

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

---

## Logical Operators

| Operator | Summary | Example |
Expand Down
4 changes: 4 additions & 0 deletions x-api/posts/search/introduction.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,10 @@ Build queries using operators that match on Post attributes:

---

<Note>
Keyword-based search results do not include retweets. To match retweets, use the [Filtered Stream](/x-api/posts/filtered-stream/introduction) endpoints.
</Note>

## Recent Search

Search Posts from the **last 7 days**. Available to all developers.
Expand Down