glossary

Lista operatorów zaawansowanego wyszukiwania X: co przyjmuje wyszukiwarka webowa, a co odrzuca API

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •9 min czytania
Lista operatorów zaawansowanego wyszukiwania X: co przyjmuje wyszukiwarka webowa, a co odrzuca APILista operatorów zaawansowanego wyszukiwania X: co przyjmuje wyszukiwarka webowa, a co odrzuca API

TL;DR

9 min czytania

X ma dwa oddzielne zestawy operatorów, a zapytanie napisane dla jednego zostaje odrzucone przez drugi. Wyszukiwarka webowa na x.com przyjmuje since:, until:, near:, within:, min_faves: i min_retweets:, a API wyszukiwania v2 przyjmuje start_time, end_time, place:, point_radius:, min_likes: i min_reposts:, a na nazwy webowe odpowiada błędem 400. Większość poradników w internecie miesza oba zestawy, dlatego połowa podanej w nich składni nic nie zwraca.

Jak wygląda pełna lista operatorów zaawansowanego wyszukiwania X?

Listę operatorów zaawansowanego wyszukiwania X tworzą dwa udokumentowane zestawy: pola, które centrum pomocy X udostępnia przez formularz wyszukiwania zaawansowanego na x.com, oraz operatory zdefiniowane w dokumentacji dla programistów dla endpointów wyszukiwania v2. Zestawy pokrywają się w zakresie słów kluczowych, kont i języka, a rozchodzą przy datach, progach zaangażowania i geografii, bo wyszukiwarka webowa zachowała składnię wycofanego API standard v1.1, a v2 dostało nowe nazwy operatorów. Zanim napiszesz choć jeden znak, sprawdź, po której stronie tego podziału jesteś.

ZadanieOperatorCo dopasowujeWyszukiwarka webowaX API v2
TreśćkeywordSłowo (token) w treści postaTakTak
Treść"exact phrase"Słowa w tej kolejnościTakTak
Treść#hashtagHashtag, dopasowanie ścisłeTakTak
Treść$cashtagSymbol giełdowyNiezweryfikowaneTak
Treśćurl:Token w linku lub rozwiniętym linkuNiezweryfikowaneTak
Treśćlang:enJęzyk przypisany postowi przez XTakTak, wymaga koniunkcji
Treść-term, OR, ( )Wykluczanie, alternatywa, grupowanieTakTak
Kontafrom:handlePosty napisane przez to kontoTakTak
Kontato:handleOdpowiedzi skierowane do tego kontaTakTak
Konta@handlePosty wspominające to kontoTakTak
Kontalist:idPosty członków ListyNiezweryfikowaneTak
Kontaretweets_of:handleReposty tego kontaNieTak
Kontais:verifiedPosty zweryfikowanego autoraNiezweryfikowaneTak, wymaga koniunkcji
Kontabio:, bio_name:Tekst w profilu autoraNieTylko Enterprise Powerstream
Zaangażowaniemin_faves:25Co najmniej 25 polubieńTakOdrzucane z błędem 400
Zaangażowaniemin_retweets:10Co najmniej 10 repostówTakOdrzucane z błędem 400
Zaangażowaniemin_likes:25Co najmniej 25 polubieńNieTak
Zaangażowaniemin_reposts:10Co najmniej 10 repostówNieTak
Zaangażowaniemin_replies:3Co najmniej 3 odpowiedziNiezweryfikowaneTak
Datysince:2026-08-01Posty od tego dniaTakNie, użyj start_time
Datyuntil:2026-09-01Posty sprzed tego dniaTakNie, użyj end_time
Datystart_time, end_timeGranice w formacie ISO 8601NieTak, parametry żądania
Datysince_id, until_idGranice według ID postaNieTak, parametry żądania
Multimediahas:media, has:images, has:videos, has:linksZałącznik lub linkNiezweryfikowaneTak, wymaga koniunkcji
Multimediahas:hashtags, has:cashtags, has:mentions, has:geoObecność danego elementuNiezweryfikowaneTak, wymaga koniunkcji
Multimediais:retweet, is:reply, is:quoteTyp postaNiezweryfikowaneTak, wymaga koniunkcji
Multimedia-is:nullcastPomija posty wyłącznie promowaneNieTak, negacja obowiązkowa
Geonear:"San Francisco, CA"Posty oznaczone w pobliżu miejscaTakNie
Geowithin:15miPromień, działa z near:TakNie
Geoplace:seattleOznaczone miejsceNieTak
Geoplace_country:USKod kraju ISONieTak
Geopoint_radius:[2.355128 48.861118 16km]Okrąg wokół współrzędnejNieTak
Geobounding_box:[-105.30 39.96 -105.17 40.09]Prostokąt ze współrzędnychNieTak
Wątkiconversation_id:1334987486343299072Wszystkie posty w jednym wątkuNieTak
Wątkiin_reply_to_tweet_id:, quotes_of_tweet_id:, retweets_of_tweet_id:Odpowiedzi, cytaty i reposty jednego postaNieTak
Wątkicontext:, entity:Adnotacje tematyczne XNieTak, entity: tylko w recent search

Ostatnia weryfikacja: 8 września 2026 r.

Źródła: X Help Center, How to use advanced search, stopka z oznaczeniem 2026 X Corp, odczyt 8 września 2026 r. Dokumentacja X dla programistów, Search Operators i Build a query, odczyt 8 września 2026 r.

Które operatory działają w darmowej wyszukiwarce webowej bez klucza API?

Czternaście operatorów ma w kolumnie webowej "Tak", bo potwierdza je centrum pomocy X, a każdy inny wpis w tej kolumnie to wniosek pośredni. Ta strona opisuje pola formularza wyszukiwania zaawansowanego, a następnie linkuje do dwóch gotowych wyszukiwań, których adresy zdradzają składnię: New Years -Resolution lang:en near:"San Francisco, CA" within:15mi since:2013-12-30 until:2014-01-02 oraz #WorldCup lang:en near:"Brazil" within:15mi until:2014-07-31. Traktuj te dwa adresy jako wzorzec dla wersji webowej, a wszystko inne testuj samodzielnie.

X stawia jeden warunek dostępu. Centrum pomocy podaje, że wyszukiwanie zaawansowane "is available when you're logged in to X.com," czyli jest dostępne po zalogowaniu, więc wyszukiwarka webowa jest bezpłatna, ale wymaga konta.

Które operatory X działają tylko przez API?

Wątki, adnotacje i precyzyjna geografia są dostępne wyłącznie przez API, bo te operatory odwołują się do identyfikatorów postów i współrzędnych, dla których formularz webowy nie ma pól. conversation_id: pobiera wszystkie odpowiedzi w wątku, context: dopasowuje adnotacje tematyczne X, a point_radius: przyjmuje długość geograficzną, szerokość geograficzną i promień. Sięgaj po API, gdy pytanie dotyczy kształtu rozmowy, a nie słów, które w niej padają.

Prawdziwym ograniczeniem API jest długość zapytania. Dokumentacja X ogranicza zapytanie recent search w planie self-serve do 512 znaków, full-archive do 1 024, a enterprise do 4 096, i liczy się cały ciąg. Rachunek dla listy słów kluczowych mieści się w jednej linii:

Characters = (variants x average variant length) + (OR joins x 4) + (parentheses x 2)

Dwadzieścia wariantów nazwy produktu o średniej długości 12 znaków, połączonych przez OR w jednej grupie:

(20 x 12) + (19 x 4) + 2 = 240 + 76 + 2 = 318 characters

Zostaje 512 minus 318 = 194 znaki na lang:, -is:retweet i resztę w planie self-serve recent search. Full-archive podwaja miejsce do 1 024. Najpierw zaplanuj filtry, a resztę przeznacz na warianty. Zanim wybierzesz tę drogę, sprawdź, ile kosztuje API X w każdym planie i jak działają jego limity żądań.

Osoba pisząca na laptopie, co ilustruje ustawianie progów zaangażowania przy filtrowaniu wyników wyszukiwania.

Na co idzie 512 znaków zapytania recent search
Warianty (20 x 12 znaków)240
Łączenia OR (19 x 4)76
Nawiasy2
Zostaje na filtry194
Grupa OR z 20 wariantami zużywa 318 z 512 znaków limitu self-serve recent search i zostawia 194 na lang:, -is:retweet i resztę.

Jak ustawić progi zaangażowania w wyszukiwarce X?

X używa różnych nazw dla tego samego progu w każdym miejscu, a jego dokumentacja operatorów mówi o tym w ramce z ostrzeżeniem: "The equivalent operators on X web search are named min_faves: and min_retweets:. Those names are not valid in the X API and will be rejected with a 400 error. Use min_likes: and min_reposts: instead." Czyli odpowiedniki w wyszukiwarce webowej to min_faves: i min_retweets:, w API są niepoprawne i kończą się błędem 400, więc trzeba użyć min_likes: i min_reposts:. min_replies: ma tę samą nazwę po obu stronach. Każdy z nich przyjmuje nieujemną liczbę całkowitą i działa zarówno w recent search, jak i w full-archive.

Progi ograniczają szum, ale jednocześnie ucinają intencję zakupową. Osoba prosząca o polecenie narzędzia zbiera dwa polubienia, a nie dwieście, więc min_faves:50 usuwa dokładnie te posty, na które warto odpowiedzieć. Ustawiaj wysokie progi przy śledzeniu konkurencji i kryzysów, a gdy szukasz intencji, ustaw je na zero lub pomiń.

Jak wyszukać dokładny zakres dat na X?

Wyszukiwarka webowa przyjmuje since: i until: z datami YYYY-MM-DD, a API żadnego z nich. since:2026-08-01 until:2026-09-01 zwraca w wersji webowej sierpień, a ten sam zakres w API to parametry żądania start_time i end_time w formacie ISO 8601, z since_id i until_id jako odpowiednikami opartymi na ID posta. Centrum pomocy X potwierdza, że archiwum webowe sięga pierwszego publicznego posta z 2006 roku, a API dzieli je na recent search z 7 dniami dla każdego programisty i full-archive sięgające 2006 roku w planach płatnych.

RedReplier
RedReplier

Rozpocznij

Reddit, X, Bluesky i HN

Alerty o intencjach w czasie rzeczywistym

Nielimitowane odpowiedzi AI

Ocena według intencji zakupowej

Zakresy w wyszukiwarce webowej są lewostronnie domknięte, więc until:2026-09-01 kończy się przed 1 września i nie obejmuje tego dnia. Jeśli raport ma uwzględniać ostatni dzień, dodaj jeden dzień do daty końcowej.

Smartfon z pinezką na mapie, co ilustruje omawiane w tej części operatory geograficzne.

Które operatory multimediów i geolokalizacji nadal działają?

Każdy operator has: i is: jest udokumentowany dla API, a żaden dla wyszukiwarki webowej, więc to właśnie przy multimediach myli się większość poradników. Tabela migracji X przypisuje stare nazwy standard v1.1 do nowych: filter:links stało się has:links, filter:media stało się has:media, filter:images i filter:twimg stały się has:images, a filter:retweets stało się is:retweet. Wyszukiwarka webowa wywodzi się z tej starszej rodziny, dlatego składnia filter: wciąż krąży w sieci, choć nie ma jej w aktualnej dokumentacji X.

Dokumentacja X jest też niespójna w kwestii wideo. Strona Search Operators wymienia has:video_link dla natywnych filmów X, a wprowadzenie do Search Posts i tabela migracji podają has:videos. Spróbuj najpierw has:videos, a w razie potrzeby przejdź na drugi wariant, bo jedna z tych stron jest nieaktualna, a X nie mówi która.

Geografia dzieli się czysto. near: i within: należą do wyszukiwarki webowej, place:, place_country:, point_radius: i bounding_box: do API, a żadna z tych grup nie działa po drugiej stronie.

Trzy zapytania, które marketer uruchamia na X

Intencja zakupowa, wyszukiwarka webowa, tylko zweryfikowane operatory:

("looking for" OR "recommend a" OR "alternative to" OR "switching from") (CRM OR "help desk" OR helpdesk) lang:en since:2026-08-25 -from:YourBrand

Sygnały odchodzenia od konkurenta, wyszukiwarka webowa, z włączonymi progami, by pokazać tylko posty z odzewem:

(@Competitor OR Competitor) (cancelled OR canceling OR "switching to") lang:en min_faves:5 since:2026-06-01 until:2026-09-01

To samo szukanie intencji przez API, gdzie zmieniają się wszystkie nazwy operatorów:

("looking for" OR "any recommendations" OR "alternative to") ("project management" OR "task tracker") lang:en -is:retweet -is:nullcast -has:links min_likes:2

O tym, co zwróci każde z nich, decyduje kolejność działań. X łączy AND przed OR, więc apple OR iphone ipad jest liczone jako apple OR (iphone ipad), a nawiasy w trzech powyższych zapytaniach pełnią realną funkcję, a nie ozdobną. Ogólna logika wykracza poza ten tekst i należy do zasad działania AND, OR i NOT, a ta strona trzyma się składni specyficznej dla X.

Których operatorów nie udało się zweryfikować?

Dziesięć rodzin operatorów występuje w dokumentacji X tylko jako wycofane nazwy standard v1.1, co czyni je niezweryfikowanymi, a nie działającymi: cała rodzina filter:, source:, card_name:, card_domain:, include:antisocial, include:sensitive_content, filter:follows, filter:has_engagement, filter:trusted oraz parametr żądania geocode. Przegląd migracji X wymienia każdą z nich w kolumnie Standard przy pustej kolumnie v2, a endpoint standard v1.1 już nie istnieje.

Wyszukiwarka webowa nigdy nie przeszła na nazewnictwo v2, więc odziedziczyła całą tę starszą rodzinę, a X nie publikuje listy tego, co przetrwało. Uruchom każdy operator na zapytaniu, o którym wiesz, że zwraca wyniki, i porównaj liczby. Jeśli dostajesz niefiltrowany zbiór, operator jest ignorowany, a nie stosowany.

RedReplier śledzi X razem z Redditem, Bluesky, Facebookiem i Hacker News w jednym miejscu, szereguje znalezione wpisy według intencji zakupowej i wyjaśnia za pomocą AI, dlaczego każda wzmianka została oznaczona. Jego monitoring X przyjmuje słowa kluczowe i adres witryny zamiast ciągu zapytania, a do tego udostępnia API i serwer MCP dla Claude Code, Cursora i każdego standardowego klienta MCP. Szerszą praktyką, do której to należy, jest social listening, a wersją tego pytania w stylu "zbudować czy kupić" jest samodzielne prowadzenie API do social listeningu.

RedReplier
RedReplier

Rozpocznij

Reddit, X, Bluesky i HN

Alerty o intencjach w czasie rzeczywistym

Nielimitowane odpowiedzi AI

Ocena według intencji zakupowej

Najczęściej zadawane pytania

Czy zaawansowane wyszukiwanie X działa bez logowania?

Nie. Centrum pomocy X podaje, że wyszukiwanie zaawansowane jest dostępne po zalogowaniu na X.com. Wyszukiwanie nic nie kosztuje, ale wymaga konta, więc przeglądarka bez logowania lub scraper bez uwierzytelnienia nie dostanie wyników z wyszukiwarki webowej.

Dlaczego min_likes: nie działa w wyszukiwarce webowej?

Wyszukiwarka webowa i API używają innych nazw dla tego progu. Dokumentacja operatorów X podaje, że min_likes: i min_reposts: to nazwy z API, min_faves: i min_retweets: to nazwy webowe, a nazwy webowe zwracają w API błąd 400. Zamieniaj parę zależnie od tego, gdzie wysyłasz zapytanie.

Jak daleko wstecz sięga wyszukiwarka X?

Według centrum pomocy X wyszukiwarka webowa sięga pierwszego publicznego posta z 2006 roku. API dzieli to archiwum: recent search obejmuje ostatnie 7 dni dla każdego programisty, a full-archive search sięga 2006 roku dla klientów pay-per-use i enterprise.

Czy mogę używać near: i within: z API X?

Nie. near: i within: to operatory wyłącznie wyszukiwarki webowej. Odpowiedniki w API to place:, place_country:, point_radius:[longitude latitude radius] i bounding_box:.

X dokumentuje oba. Strona Search Operators wymienia has:video_link dla natywnych filmów X, a wprowadzenie do Search Posts i tabela migracji z v1 do v2 podają has:videos. Przetestuj oba na zapytaniu, o którym wiesz, że zwraca posty z wideo, i zostaw ten, który zmienia liczbę wyników.

Dlaczego moje zapytanie zwraca mniej postów, niż oczekuję?

Zwykle przyczyną są operatory wymagające koniunkcji. Dokumentacja X podaje, że operatory takie jak has:media, is:retweet i lang: nie mogą występować w zapytaniu samodzielnie, więc potrzebują obok co najmniej jednego operatora samodzielnego, na przykład słowa kluczowego lub from:. Druga przyczyna to kolejność działań: AND wiąże silniej niż OR, więc każdą grupę OR ujmuj w nawiasy.

Czy limit zapytania w API X liczy znaki, czy tokeny?

API X liczy znaki, a nie tokeny, i do limitu wlicza się cały ciąg zapytania razem z operatorami. Self-serve recent search kończy się na 512 znakach, full-archive podwaja to do 1 024, a enterprise ma 4 096. Jeśli najpierw zaplanujesz operatory wymagające koniunkcji, takie jak lang: i -is:retweet, zostanie więcej znaków na warianty słów kluczowych.

Dlaczego przed -is:nullcast musi stać minus?

Samo is:nullcast nie jest poprawnym operatorem API X, bo dokumentacja wymaga negacji -is:nullcast. W tej postaci usuwa posty wyłącznie promowane i zostawia w wynikach organiczne. Nie istnieje forma pozytywna, która pobierałaby bezpośrednio posty nullcast.

Jak sprawdzić, czy niezweryfikowany operator X, taki jak source: lub filter:trusted, nadal działa?

Przetestuj go na zapytaniu, o którym wiesz, że zwraca wyniki, raz z operatorem i raz bez niego, a potem porównaj liczby. Jeśli liczba się nie zmienia, X ignoruje operator, zamiast go stosować. Ten test jest ważny, bo X nie publikuje listy wycofanych operatorów standard v1.1, które przetrwały przejście na v2.

Dlaczego starsze poradniki o wyszukiwarce X podają operatory, które dziś nic nie zwracają?

Wiele poradników kopiuje wycofane nazwy standard v1.1, w tym całą rodzinę filter:, source: i card_name:, bo kiedyś działały, a większość stron, które je wymieniają, nigdy nie oznaczyła ich jako przestarzałych. Tabela migracji X przypisuje tylko część z nich do nazw v2, takich jak has:links czy is:retweet, a dla reszty zostawia kolumnę v2 pustą. Każdy niepewny operator przetestuj, zanim zbudujesz na nim zapytanie.

Więcej naszych treści w Google

Jedno kliknięcie oznacza RedReplier jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.

Jeszcze chwila...

RedReplier

RedReplier

Żaden kupujący pytający o ofertę nie umknie

RedReplier śledzi Reddita, X, Bluesky i Hacker News w czasie rzeczywistym, ocenia każdy wątek pod kątem intencji zakupowej i przygotowuje odpowiedź, by dotrzeć tam jako pierwszy.

Reddit, X, Bluesky i HN

Alerty o intencjach w czasie rzeczywistym

Nielimitowane odpowiedzi AI

Ocena według intencji zakupowej

Powiązane artykuły