From 24013b6bfb0c02c4fbe6bf281635c9ab9bdd9e3a Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 26 Aug 2026 13:21:47 +0000 Subject: [PATCH] docs: add url: operator index-miss caveat to search operators page --- x-api/posts/search/integrate/operators.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/x-api/posts/search/integrate/operators.mdx b/x-api/posts/search/integrate/operators.mdx index d56334c28..2b6a4fb37 100644 --- a/x-api/posts/search/integrate/operators.mdx +++ b/x-api/posts/search/integrate/operators.mdx @@ -52,6 +52,10 @@ Operators are used to match on specific Post attributes. There are two types: |:---------|:-----|:--------|:--------| | `url:` | Standalone | Tokenized match on URL (matches `url` or `expanded_url` fields) | `url:"https://developer.twitter.com"` | + +Following the May 4, 2026 migration of the search endpoints to the new search index, `url:` queries can miss some original Posts that link to a matching URL. Affected Posts return the URL in `entities.urls.expanded_url` on `GET /2/tweets/:id`, but are absent from both search results and counts. This is a known indexing issue. See the [developer community discussion](https://devcommunity.x.com/t/274073) for details. To confirm whether a specific Post links to a URL, retrieve it directly with `GET /2/tweets/:id`. + + --- ## Context and entity operators