{"uid":"cap_6yacYCYwqTDci-1RviyL4","slug":"deeptrawler-telegram-public-post-search-faf0d493","name":"DeepTrawler Telegram Public Post Search","description":"Live, multi-platform search API for the deep conversation layer. Pay per call with x402 or MPP — no API keys, no signup.","url":"https://deeptrawler.com/v1/telegram/search/public-posts","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"q":{"type":"string","description":"Telegram search query (alias: query). Required."},"limit":{"type":"integer","default":20,"maximum":100,"minimum":1},"query":{"type":"string","description":"Alias of 'q'; provide one of the two."},"cursor":{"type":"string","description":"Opaque continuation token from a previous response's next_cursor."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"meta":{"order":"telegram"},"query":"coffee","results":[{"id":"-1001234567890:842","url":"https://t.me/somechannel/842","chat":{"id":"-1001234567890","title":"Some Channel","username":"somechannel","verified":false},"text":"Coffee prices are changing...","views":15200,"forwards":48,"timestamp":"2026-07-07T10:30:00Z","message_id":842,"message_type":"photo"}],"platform":"telegram","next_cursor":"eyJ2Ijox..."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oUh2STaxB7v_yj4lCg_6G","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search public Telegram messages and posts in real time using a keyword query, returning paginated results with message metadata.","exampleAgentPrompt":"Search Telegram public posts for 'Bitcoin ETF' and give me the top 20 results — I want to see which channels are talking about it right now, with view counts and timestamps.","exampleUseCases":[{"title":"Brand mention monitoring on Telegram","prompt":"Search Telegram public posts for mentions of 'OpenAI' and show me the most recent 20 results — I want to track what channels are talking about them and how much engagement those posts are getting."},{"title":"Breaking news discovery across channels","prompt":"Look up what people on Telegram are saying about the earthquake in Turkey right now — give me the top 50 public posts and sort them so I can see which ones are spreading fastest."},{"title":"Crypto community sentiment tracking","prompt":"Search public Telegram for posts about 'Solana airdrop' and return up to 30 results with view counts and which channels posted them — I want to see if this is gaining traction."}],"resultDescription":"A JSON object containing the original query string, platform identifier ('telegram'), an array of matching message objects (each with a composite ID, direct URL, chat info including title/username/verified status, message text, view count, forward count, ISO-8601 timestamp, and message type), plus an opaque next_cursor string for pagination (null if no further pages), and a meta field with ordering info.","failureModes":["Missing or empty 'q'/'query' parameter returns an error since it is required","Providing both 'q' and 'query' simultaneously may cause ambiguity or conflict","Invalid cursor token from a different session or expired token may return an error or empty results","limit values outside 1–100 are rejected by schema validation","No results found for obscure or very specific queries returns an empty results array","Rate limiting or payment failure (x402/MPP) results in payment-required or access-denied responses","Telegram platform outages or indexing delays may cause stale or missing results"],"whenToPreferThis":"Choose this endpoint when you need real-time, unauthenticated, pay-per-call search across public Telegram posts without managing API keys or subscriptions. It is ideal for agents that need to search Telegram specifically (not Reddit, Twitter, or other platforms), require live indexing of the 'deep conversation layer', and need structured metadata like view counts, forward counts, and verified channel status. Prefer it over scraping solutions when you need clean structured output and pagination support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T06:37:08.322Z","isFirstParty":false}