Telegram Channel Search
Telegram Channel Search scorre ogni post pubblicato da un canale pubblico alla ricerca di una parola o di una frase e restituisce i post corrispondenti con testo, data di pubblicazione, visualizzazioni e reazioni. Trovare queste menzioni, per quanto vecchie, mostra se un canale influente ha mai parlato di un progetto, quanto spesso torna su un tema e quanta attenzione ha ricevuto ogni menzione.
Funzionalità della Telegram Channel Search API
- Ricerca in tutto lo storicoquery copre tutti i post del canale, così una menzione di anni fa emerge con la stessa facilità di una di oggi.
- Fino a 100 post corrispondentiresults_limit stabilisce quanti risultati restituire, da 1 a 100 con 20 come valore predefinito.
- Visualizzazioni e reazioni per risultatoOgni post corrispondente riporta metrics.views_count e metrics.likes_count, che mostrano quanta attenzione ha ricevuto la menzione.
- Paghi solo i risultatiOgni post corrispondente costa 0,5 crediti, e una ricerca senza risultati non costa nulla.
Parametri della Telegram Channel Search API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | Un link al canale Telegram pubblico in cui cercare, come https://t.me/durov; funzionano anche i link t.me/s/, telegram.me e telegram.dog. |
query | Obbligatorio | Parola o frase da cercare nei post del canale, come TON. |
results_limit | Facoltativo | Numero di post corrispondenti da restituire. Intero da 1 a 100; il valore predefinito è 20. |
Come usare la Telegram Channel Search API
Invia il link di un canale e un termine di ricerca, poi leggi i post corrispondenti.
- Invia con POST {"url": "https://t.me/durov", "query": "TON", "results_limit": 20} a /v1/telegram/channel-search.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- Leggi i post corrispondenti da results.items e, finché has_more è true, passa results.next_cursor per caricare la pagina successiva.
curl -X POST "https://api.socq.ai/v1/telegram/channel-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://t.me/durov","query":"TON","results_limit":20}'Casi d’uso della Telegram Channel Search API
- Verificare se un canale ha parlato di un progetto: Cerca il nome del tuo token, prodotto o brand in un canale di influencer o di notizie prima di proporre una collaborazione.
- Raccogliere la copertura di un lancio: Riunisci in un elenco tutti i post che un canale ha dedicato a un lancio di prodotto o a un evento, per un resoconto.
- Verifiche prima di acquistare uno spazio: Cerca in un canale vecchie promozioni di un concorrente o di un tema per conoscerne lo storico prima di acquistare un posizionamento.
- Ricerca su un tema in più canali: Esegui la stessa ricerca su più canali e confronta quante volte ognuno ne parla e quante visualizzazioni hanno ottenuto quei post.
Consigli degli esperti per la Telegram Channel Search API
- Fai ricerche separate per un ticker e per il nome completo del progetto, così copri entrambi i modi in cui un canale può scriverlo.
- Le foto nei risultati rimandano al post che le mostra; invia l’url di quel post a Telegram Post Detail API se ti servono i file delle immagini.
- Ogni ricerca riguarda un canale; per scoprire altri canali su un tema, parti da uno che conosci con Telegram Similar Channels API.
API correlate
Oltre alla Telegram Channel Search API, usa queste API quando ti serve un altro tipo di dati pubblici di Telegram.
- Telegram Channel Info API — Interroga fino a 50 canali Telegram pubblici tramite link e restituisce titolo, descrizione, avatar, badge di verifica e numero di iscritti come intero.
- Telegram Channel Scraper API — Raccoglie fino a 1.000 post di un canale Telegram pubblico a partire dal più recente, con testo, data, visualizzazioni, reazioni, foto e video.
- Telegram Post Detail API — Recupera fino a 50 post Telegram specifici tramite link, da qualsiasi canale pubblico, con testo completo, data, visualizzazioni, reazioni e media.
- Telegram Comments API — Raccoglie fino a 100 commenti sotto un post di un canale Telegram dal suo gruppo di discussione, con autore, testo, data, reazioni e commento a cui risponde.
- Telegram Similar Channels API — Trova i canali che Telegram consiglia accanto a un canale pubblico, di solito una decina, con titolo, badge di verifica e numero esatto di iscritti.