Telegram Post Detail
Telegram Post Detail es el registro completo de una sola publicación de canal, con su texto, fecha de publicación, número de vistas, total de reacciones y las fotos o videos adjuntos. Leer esos valores en publicaciones que ya conoce permite actualizar las cifras de una campaña, dejar constancia de lo que dijo un anuncio y añadir datos de alcance a los enlaces de sus propios registros.
Funcionalidades de la Telegram Post Detail API
- Publicaciones de muchos canales a la vezurls acepta hasta 50 enlaces de publicación con la forma t.me/channel/post_id, y pueden venir de canales distintos en la misma solicitud.
- Vistas y reacciones actualesmetrics.views_count y metrics.likes_count dan como enteros el número de vistas y el total de reacciones en el momento de la recopilación.
- Texto completo y multimediatext contiene todo el cuerpo de la publicación y media enumera cada foto o video con su tipo y la URL del archivo.
- Publicaciones no disponibles omitidas sin costoLas publicaciones eliminadas y las de canales privados quedan fuera y no cuestan nada; la tarea solo falla con reembolso cuando no se puede leer ninguno de los enlaces.
Parámetros de la Telegram Post Detail API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Hasta 50 enlaces de publicaciones de Telegram con la forma https://t.me/channel/post_id, como https://t.me/durov/510. Puede combinar enlaces de distintos canales públicos. |
Cómo usar la Telegram Post Detail API
Envíe los enlaces de las publicaciones que necesita y lea un registro completo por cada publicación encontrada.
- Envíe {"urls": ["https://t.me/durov/510"]} por POST a /v1/telegram/post-detail.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea las publicaciones en results.items y, mientras has_more sea true, pase results.next_cursor para cargar la página siguiente.
curl -X POST "https://api.socq.ai/v1/telegram/post-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://t.me/durov/510"]}'Casos de uso de la Telegram Post Detail API
- Actualizar las cifras de una campaña: Guarde los enlaces de publicaciones patrocinadas o de anuncios y vuelva a recopilarlos periódicamente para seguir la evolución de vistas y reacciones.
- Dejar constancia de una publicación: Guarde el texto exacto y la fecha de una publicación citada en un informe, una disputa o una noticia, junto con collected_at.
- Enriquecer enlaces compartidos: Convierta enlaces de publicaciones reunidos en chats, artículos u hojas de cálculo en registros completos con canal de origen, alcance y multimedia.
Consejos de expertos para la Telegram Post Detail API
- Agrupe los enlaces de muchos canales en una sola solicitud de hasta 50, en lugar de enviarlos uno por uno.
- author.username indica el canal al que pertenece cada publicación, lo que facilita agrupar un lote combinado por canal.
- Para recopilar las publicaciones más recientes de un canal sin conocer sus enlaces, use Telegram Channel Scraper API; Post Detail sirve para publicaciones que ya puede señalar.
APIs relacionadas
Además de la Telegram Post Detail API, use estas APIs cuando necesite otro tipo de datos públicos de Telegram.
- Telegram Channel Info API — Consulta hasta 50 canales públicos de Telegram por enlace y obtiene título, descripción, avatar, insignia de verificación y número de suscriptores como entero.
- Telegram Channel Scraper API — Recolecta hasta 1,000 publicaciones de un canal público de Telegram, de la más reciente a la más antigua, con texto, fecha, vistas, reacciones, fotos y videos.
- Telegram Comments API — Recolecta hasta 100 comentarios bajo una publicación de un canal de Telegram desde su grupo de discusión, con autor, texto, fecha, reacciones y comentario respondido.
- Telegram Similar Channels API — Encuentra los canales que Telegram recomienda junto a un canal público, normalmente unos diez, con título, insignia de verificación y número exacto de suscriptores.
- Telegram Channel Search API — Busca una palabra o frase en todo el historial de un canal público de Telegram y devuelve hasta 100 publicaciones coincidentes con texto, fecha, vistas y reacciones.