https://garenal1v3.github.io/tgs-cli/reference/commands/search/Recent content in Search on tgsHugoenhttps://garenal1v3.github.io/tgs-cli/reference/commands/search/messages/Mon, 01 Jan 0001 00:00:00 +0000https://garenal1v3.github.io/tgs-cli/reference/commands/search/messages/<h1 id="tgs-search-messages">tgs search messages<a class="anchor" href="#tgs-search-messages">#</a></h1> <p>Search messages within one or more chats, channels, or groups.</p> <h2 id="usage">Usage<a class="anchor" href="#usage">#</a></h2> <pre tabindex="0"><code>tgs search messages [query] [flags]</code></pre><p>The <code>query</code> argument is required and specifies the text to search for.</p> <h2 id="flags">Flags<a class="anchor" href="#flags">#</a></h2> <table> <thead> <tr> <th>Flag</th> <th>Short</th> <th>Type</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>--chat</code></td> <td><code>-c</code></td> <td>string[]</td> <td></td> <td>Chat to search (username, phone, ID; repeatable, comma-separated). Required unless <code>--folder</code> is set.</td> </tr> <tr> <td><code>--folder</code></td> <td></td> <td>string</td> <td><code>&quot;&quot;</code></td> <td>Search all chats inside this folder (id or name); peers are additive to any <code>--chat</code> values</td> </tr> <tr> <td><code>--from</code></td> <td><code>-f</code></td> <td>string</td> <td></td> <td>Filter by sender (username, phone, or ID)</td> </tr> <tr> <td><code>--filter</code></td> <td></td> <td>string</td> <td></td> <td>Message type filter (see <a href="#filter-values">filter values</a>)</td> </tr> <tr> <td><code>--after</code></td> <td></td> <td>string</td> <td></td> <td>Only messages after date (YYYY-MM-DD or unix timestamp)</td> </tr> <tr> <td><code>--before</code></td> <td></td> <td>string</td> <td></td> <td>Only messages before date (YYYY-MM-DD or unix timestamp)</td> </tr> <tr> <td><code>--topic</code></td> <td></td> <td>int</td> <td><code>0</code></td> <td>Forum topic ID</td> </tr> <tr> <td><code>--limit</code></td> <td><code>-l</code></td> <td>int</td> <td><code>50</code></td> <td>Max messages to return (1-100)</td> </tr> <tr> <td><code>--cursor</code></td> <td></td> <td>string</td> <td></td> <td>Pagination cursor from previous response</td> </tr> <tr> <td><code>--max-wait</code></td> <td></td> <td>int</td> <td><code>60</code></td> <td>Max seconds to wait on FLOOD_WAIT</td> </tr> <tr> <td><code>--no-cache</code></td> <td></td> <td>bool</td> <td><code>false</code></td> <td>Disable peer resolution cache</td> </tr> <tr> <td><code>--include-comments</code></td> <td></td> <td>bool</td> <td><code>false</code></td> <td>Also search the linked discussion group of each channel</td> </tr> <tr> <td><code>--profile</code></td> <td><code>-p</code></td> <td>string</td> <td></td> <td>Account profile name</td> </tr> </tbody> </table> <p>Profile resolution order when <code>--profile</code> is not set: <code>TGS_PROFILE</code> env -&gt; <code>.tgs.yaml</code> file -&gt; <code>&quot;default&quot;</code>.</p>https://garenal1v3.github.io/tgs-cli/reference/commands/search/global/Mon, 01 Jan 0001 00:00:00 +0000https://garenal1v3.github.io/tgs-cli/reference/commands/search/global/<h1 id="tgs-search-global">tgs search global<a class="anchor" href="#tgs-search-global">#</a></h1> <p>Search messages globally across all chats, channels, and groups.</p> <h2 id="usage">Usage<a class="anchor" href="#usage">#</a></h2> <pre tabindex="0"><code>tgs search global [query] [flags]</code></pre><p>The <code>query</code> argument is required and specifies the text to search for.</p> <h2 id="flags">Flags<a class="anchor" href="#flags">#</a></h2> <table> <thead> <tr> <th>Flag</th> <th>Short</th> <th>Type</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>--channels-only</code></td> <td></td> <td>bool</td> <td><code>false</code></td> <td>Search only in channels; incompatible with <code>--folder</code></td> </tr> <tr> <td><code>--groups-only</code></td> <td></td> <td>bool</td> <td><code>false</code></td> <td>Search only in groups; incompatible with <code>--folder</code></td> </tr> <tr> <td><code>--users-only</code></td> <td></td> <td>bool</td> <td><code>false</code></td> <td>Search only in private chats; incompatible with <code>--folder</code></td> </tr> <tr> <td><code>--archived</code></td> <td></td> <td>bool</td> <td><code>false</code></td> <td>Search in the archive folder (folder ID 1); ignored when <code>--folder</code> is set</td> </tr> <tr> <td><code>--folder</code></td> <td></td> <td>string</td> <td><code>&quot;&quot;</code></td> <td>Search only in this folder (id or name), archived chats included; incompatible with <code>--channels-only</code>, <code>--groups-only</code>, <code>--users-only</code></td> </tr> <tr> <td><code>--filter</code></td> <td></td> <td>string</td> <td></td> <td>Message type filter (see <a href="https://garenal1v3.github.io/tgs-cli/en/reference/commands/search/messages/#filter-values">filter values</a>)</td> </tr> <tr> <td><code>--after</code></td> <td></td> <td>string</td> <td></td> <td>Only messages after date (YYYY-MM-DD or unix timestamp)</td> </tr> <tr> <td><code>--before</code></td> <td></td> <td>string</td> <td></td> <td>Only messages before date (YYYY-MM-DD or unix timestamp)</td> </tr> <tr> <td><code>--limit</code></td> <td><code>-l</code></td> <td>int</td> <td><code>50</code></td> <td>Max messages to return (1-100)</td> </tr> <tr> <td><code>--cursor</code></td> <td></td> <td>string</td> <td></td> <td>Pagination cursor from previous response</td> </tr> <tr> <td><code>--max-wait</code></td> <td></td> <td>int</td> <td><code>60</code></td> <td>Max seconds to wait on FLOOD_WAIT</td> </tr> <tr> <td><code>--profile</code></td> <td><code>-p</code></td> <td>string</td> <td></td> <td>Account profile name</td> </tr> </tbody> </table> <p>Profile resolution order when <code>--profile</code> is not set: <code>TGS_PROFILE</code> env -&gt; <code>.tgs.yaml</code> file -&gt; <code>&quot;default&quot;</code>.</p>https://garenal1v3.github.io/tgs-cli/reference/commands/search/counters/Mon, 01 Jan 0001 00:00:00 +0000https://garenal1v3.github.io/tgs-cli/reference/commands/search/counters/<h1 id="tgs-search-counters">tgs search counters<a class="anchor" href="#tgs-search-counters">#</a></h1> <p>Get message counts grouped by filter type (photo, video, document, etc.) for one or more chats.</p> <h2 id="usage">Usage<a class="anchor" href="#usage">#</a></h2> <pre tabindex="0"><code>tgs search counters [flags]</code></pre><p>This command takes no positional arguments.</p> <h2 id="flags">Flags<a class="anchor" href="#flags">#</a></h2> <table> <thead> <tr> <th>Flag</th> <th>Short</th> <th>Type</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>--chat</code></td> <td><code>-c</code></td> <td>string</td> <td></td> <td>Chat to query (username, phone, or ID). Required unless <code>--folder</code> is set.</td> </tr> <tr> <td><code>--folder</code></td> <td></td> <td>string</td> <td><code>&quot;&quot;</code></td> <td>Query all chats inside this folder (id or name); results include per-chat breakdowns plus aggregated totals</td> </tr> <tr> <td><code>--topic</code></td> <td></td> <td>int</td> <td><code>0</code></td> <td>Forum topic ID</td> </tr> <tr> <td><code>--filters</code></td> <td></td> <td>string[]</td> <td></td> <td>Filter types to count (comma-separated; default: all). See <a href="https://garenal1v3.github.io/tgs-cli/en/reference/commands/search/messages/#filter-values">filter values</a></td> </tr> <tr> <td><code>--max-wait</code></td> <td></td> <td>int</td> <td><code>60</code></td> <td>Max seconds to wait on FLOOD_WAIT</td> </tr> <tr> <td><code>--no-cache</code></td> <td></td> <td>bool</td> <td><code>false</code></td> <td>Disable peer resolution cache</td> </tr> <tr> <td><code>--profile</code></td> <td><code>-p</code></td> <td>string</td> <td></td> <td>Account profile name</td> </tr> </tbody> </table> <p>Profile resolution order when <code>--profile</code> is not set: <code>TGS_PROFILE</code> env -&gt; <code>.tgs.yaml</code> file -&gt; <code>&quot;default&quot;</code>.</p>https://garenal1v3.github.io/tgs-cli/reference/commands/search/calendar/Mon, 01 Jan 0001 00:00:00 +0000https://garenal1v3.github.io/tgs-cli/reference/commands/search/calendar/<h1 id="tgs-search-calendar">tgs search calendar<a class="anchor" href="#tgs-search-calendar">#</a></h1> <p>Get message search results grouped by date for one or more chats and a filter type.</p> <h2 id="usage">Usage<a class="anchor" href="#usage">#</a></h2> <pre tabindex="0"><code>tgs search calendar [flags]</code></pre><p>This command takes no positional arguments.</p> <h2 id="flags">Flags<a class="anchor" href="#flags">#</a></h2> <table> <thead> <tr> <th>Flag</th> <th>Short</th> <th>Type</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>--chat</code></td> <td><code>-c</code></td> <td>string</td> <td></td> <td>Chat to query (username, phone, or ID). Required unless <code>--folder</code> is set.</td> </tr> <tr> <td><code>--folder</code></td> <td></td> <td>string</td> <td><code>&quot;&quot;</code></td> <td>Query all chats inside this folder (id or name); results include per-chat arrays plus aggregated totals</td> </tr> <tr> <td><code>--filter</code></td> <td></td> <td>string</td> <td></td> <td>Message type filter (see <a href="https://garenal1v3.github.io/tgs-cli/en/reference/commands/search/messages/#filter-values">filter values</a>). <strong>Required.</strong></td> </tr> <tr> <td><code>--max-wait</code></td> <td></td> <td>int</td> <td><code>60</code></td> <td>Max seconds to wait on FLOOD_WAIT</td> </tr> <tr> <td><code>--no-cache</code></td> <td></td> <td>bool</td> <td><code>false</code></td> <td>Disable peer resolution cache</td> </tr> <tr> <td><code>--profile</code></td> <td><code>-p</code></td> <td>string</td> <td></td> <td>Account profile name</td> </tr> </tbody> </table> <p>Profile resolution order when <code>--profile</code> is not set: <code>TGS_PROFILE</code> env -&gt; <code>.tgs.yaml</code> file -&gt; <code>&quot;default&quot;</code>.</p>