{"uid":"cap_6oMmN9hoQeOYWN-E3QRso","slug":"deeptrawler-telegram-search-6496132f","name":"DeepTrawler Telegram 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","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."},"to":{"type":"string","description":"Upper time bound, default now. ISO-8601 or a relative value such as now-7d."},"from":{"type":"string","description":"Lower time bound. ISO-8601 or a relative value such as now-7d."},"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."},"filter[chat]":{"type":"string","description":"Shorthand for filter[chat][eq]."},"filter[message_type]":{"enum":["any","photo","video","photo_video","document","url","gif","voice","music","round_video","geo","contact","poll","pinned"],"type":"string","description":"Shorthand for filter[message_type][eq]."}}}},"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.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_m3wMgXRhEPTCq5ZOtRkC9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Telegram messages globally or within specific chats by keyword, time range, message type, and chat filter","exampleAgentPrompt":"Search Telegram globally for messages mentioning 'Bitcoin ETF approval' from the last 7 days, limit to 20 results, and only include messages with URLs.","exampleUseCases":null,"resultDescription":"Returns a paginated list of Telegram messages matching the query, each containing the message text, URL, message ID, timestamp, chat details (id, title, username, verified status), view count, forward count, and message type. Also includes a next_cursor token for pagination and query metadata.","failureModes":["Missing required 'q' or 'query' parameter returns an error","Invalid time format for 'from' or 'to' parameters","Invalid cursor token causes pagination failure","filter[chat] references a private or non-existent chat, returning empty results","Exceeding limit maximum of 100 returns a validation error","Payment failure via x402 protocol blocks the request","Rate limiting if too many requests are made in quick succession"],"whenToPreferThis":"Use this endpoint when you need to search Telegram message content at scale — either across all public Telegram chats globally or scoped to a specific channel or group. It is the right choice when you need keyword search with time-range filtering, message-type filtering (photos, videos, documents, polls, etc.), and cursor-based pagination. Prefer this over general web search when the target content is specifically on Telegram.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:30:59.814Z","isFirstParty":false}