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