> ## Documentation Index > Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt > Use this file to discover all available pages before exploring further. # Get recent posts from a Telegram channel or group > Fetches the recent public posts of a Telegram channel/group by handle — each with its text, date, view count, author, media (photos/videos with thumbnails + durations), link preview, and reactions. Paginated (older posts) via a numeric `cursor`. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/telegram/channel/posts openapi: 3.0.3 info: title: Scraperize API version: 1.0.0 description: >- Extract public data from social media platforms as clean JSON. Endpoints are split by platform and by what they return, e.g. `GET /v1/twitter/tweet`. ## Authentication Send your API key in the `x-api-key` header (or `Authorization: Bearer `). Create keys in your dashboard. ## Credits Each successful live scrape costs **1 credit**. Credits are prepaid and never expire. ## Caching Every endpoint accepts an optional `cache_max_age` (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for **0 credits**. ## Responses Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return `{ "error": { "code", "message", "requestId" } }` with a matching HTTP status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`, `cached`, and (on a hit) `cachedAt`. ## Rate limits Requests are limited per team per minute; over the limit returns `429` with a `Retry-After` header. servers: - url: https://api.scraperize.com description: Production security: - ApiKeyAuth: [] tags: - name: Twitter description: Twitter / X scraping endpoints - name: Facebook description: Facebook scraping endpoints - name: Linkme description: Linkme (link.me) scraping endpoints - name: Amazon description: Amazon (creator shop / storefront) scraping endpoints - name: Linkbio description: Linkbio (lnk.bio) scraping endpoints - name: Pillar description: Pillar (pillar.io) scraping endpoints - name: Komi description: Komi (komi.io) scraping endpoints - name: Linktree description: Linktree (linktr.ee) scraping endpoints - name: Kick description: Kick (kick.com) scraping endpoints - name: Snapchat description: Snapchat (snapchat.com) scraping endpoints - name: Telegram description: Telegram (t.me) scraping endpoints - name: Google description: Google Search scraping endpoints paths: /v1/telegram/channel/posts: get: tags: - Telegram summary: Get recent posts from a Telegram channel or group description: >- Fetches the recent public posts of a Telegram channel/group by handle — each with its text, date, view count, author, media (photos/videos with thumbnails + durations), link preview, and reactions. Paginated (older posts) via a numeric `cursor`. parameters: - name: handle in: query required: true description: >- A public Telegram handle or t.me URL, e.g. telegram or https://t.me/telegram. schema: type: string example: telegram - name: cursor in: query required: false description: >- Numeric cursor from a previous response's `paging.cursor` (pages to older posts). schema: type: string - name: cache_max_age in: query required: false description: >- Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. schema: type: string enum: - 1d - 3d - 7d - 14d - 30d example: 7d responses: '200': description: A page of posts (newest first). content: application/json: schema: type: object properties: data: type: object properties: posts: type: array items: type: object count: type: integer paging: type: object properties: cursor: type: string nullable: true hasMore: type: boolean fetchedAt: type: string format: date-time meta: type: object description: >- requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt). required: - data - meta example: data: posts: - id: 460 url: https://t.me/telegram/460 handle: telegram channelId: -1005640892 date: '2026-08-26T19:12:34.000Z' text: >- For all the info from today's update and a look back at 13 years of Telegram features — check out our blog: https://telegram.org/blog/welcome-messages-buttons-TG-13 August Features 1 • 2 • 3 • 4 • 5 • More views: 1160000 author: Telegram News authorUrl: https://t.me/telegram authorPhotoUrl: >- https://cdn1.telesco.pe/file/qiLgJ9jp-i6JY5vDXmW2nFjWG3ZnnFoyifbztHx-hQP-_o6a6cUMY_naYKIUhTlKFDTpyzjTjocQeNWR5TFAwx47YQ36sC8siY0cRxqvGXDluS74sJgdSvVOazyvlfG_73Y6lQlGYDaRBDZCUplMVHQlOF5O19r3JrBrWDToxrsqGdzCy-v7JYosUKlzFRcJcxY0Xs3nWzwaQ3waOX6nVA4jWttQy3-ZrGu3y4mo17TDEAQjXg5EUnMImq6dewmTHiVLWlpWQAXTOLtqe_f1Ijwwpm5wwL1PmGBZKZaUSuVXWte9L_gQIy0pk1jVx3TT7arfAE3uBMVacGhIp--ZIA.jpg verified: false edited: false forwardedFrom: null replyToUrl: null media: [] linkPreview: url: >- https://telegram.org/blog/welcome-messages-buttons-TG-13 siteName: Telegram title: Welcome Messages, Buttons in Messages and Signed Gifts description: >- Introducing Welcome Messages to greet new members of groups or channels, Buttons in Messages to make any text interactive, Inline Documents in Messages and much more. imageUrl: >- https://cdn4.telesco.pe/file/Hm0oiqWmOdvVJZnDTu-5Oporg5lXLRegzo_yNBPsLR8qjsdDSVXOPGk5Ad5LXgFsfpLsotH5d_WvcBn7UPFL0H3YhFHP8wj0ROuxI_Y0hnkWnf3Qpiv0IVzRK1QPk_KND51ZkcjYscq6vHK_Ii6YX_G1eypAZfKHjUJFXC1FspFb8lpXg6CfqRV69ADDlHdp8yfmGgHRq0VekqjRHXoMTWDY9_OuxYEHTTEWdetWg7sLiKikVLqKZ1537MQ1xKdXwxS_NtCRfgAn_1M_9C2s37JX7QQ4qTmwimS6JQGpu_UFWFIjbjZZsyo602npIj42OVrcJkk_KAReVYArYiIUVw.jpg reactions: [] - id: 459 url: https://t.me/telegram/459 handle: telegram channelId: -1005640892 date: '2026-08-26T19:12:24.000Z' text: >- Signed Gifts. You can now add your signature and a comment to gifts you buy via the gift marketplace. August Features 1 • 2 • 3 • 4 • 5 • More views: 1030000 author: Telegram News authorUrl: https://t.me/telegram authorPhotoUrl: >- https://cdn1.telesco.pe/file/qiLgJ9jp-i6JY5vDXmW2nFjWG3ZnnFoyifbztHx-hQP-_o6a6cUMY_naYKIUhTlKFDTpyzjTjocQeNWR5TFAwx47YQ36sC8siY0cRxqvGXDluS74sJgdSvVOazyvlfG_73Y6lQlGYDaRBDZCUplMVHQlOF5O19r3JrBrWDToxrsqGdzCy-v7JYosUKlzFRcJcxY0Xs3nWzwaQ3waOX6nVA4jWttQy3-ZrGu3y4mo17TDEAQjXg5EUnMImq6dewmTHiVLWlpWQAXTOLtqe_f1Ijwwpm5wwL1PmGBZKZaUSuVXWte9L_gQIy0pk1jVx3TT7arfAE3uBMVacGhIp--ZIA.jpg verified: false edited: false forwardedFrom: null replyToUrl: null media: - type: video url: >- https://cdn1.telesco.pe/file/6efb59a075.mp4?token=Mp8wYHzBRmQJrNqbtMWI5lgEkw9y55dKc65A4gxDhheBu36MO_6JfMCSFvQAY6FW0ECOk1Z5JoieEbQFgJ9k_ZX17TTwpHlBO4FkogDf-jzTqf0-vxOp_a2im0EFGpWeDYdCjsL1czVW8TcjnGIFlq-lncXwcCUBDZCtcKHqpPgo-mUMuKfLmxry9hDj-gM-c7N2dqc1WD-NQsXkfk00e-21T1gn7WEH7vlgbhXEb6PjIt5ffPDb58cDEAfduKrGR7Yr40pjk4eP9XJU3DyqJjfrhDnc4kMjOcAYEXTj53pImqjTXyfxJlq3fGlbJXtkfq-sOk9i870ALenDtywMAw thumbnailUrl: >- https://cdn1.telesco.pe/file/plXiZXTLCnNgLWbomr6_t_x4DvqWOq-0VxjGFS3wJ52-e7xfPlJ2lVwQE3IiqxKFNP8dQBxqwUUh2nrIiGXyMdPnsVSwrZugIuGjfS4Ytg46n8VkzfdYZ5DKiPq1gTebgessVz-ST5xK7idzVZYT7-BMjjYBccUz8U9RUB_mqewVxCzuiycPpGKWfLd4dtylYbvmKZJJ7cLPT-6xXEavQZ72lkAe-qHbg6k9V9gwlbJOBmycDAWp6gTXHwM2S_gtvo-uhWVyzuuS6LqT6Uub2P306HI23sJINxXgYdGehhy8Gq59govii_e2mTLnsbTPXYuJPr0X6OYYMxMUZ-rtXQ duration: '0:12' linkPreview: null reactions: [] - id: 458 url: https://t.me/telegram/458 handle: telegram channelId: -1005640892 date: '2026-08-26T19:12:04.000Z' text: >- Placeholders for App Updates. If a user with an outdated app encounters a new feature, they can now instantly tap to download the latest update. August Features 1 • 2 • 3 • 4 • 5 • More views: 688000 author: Telegram News authorUrl: https://t.me/telegram authorPhotoUrl: >- https://cdn1.telesco.pe/file/qiLgJ9jp-i6JY5vDXmW2nFjWG3ZnnFoyifbztHx-hQP-_o6a6cUMY_naYKIUhTlKFDTpyzjTjocQeNWR5TFAwx47YQ36sC8siY0cRxqvGXDluS74sJgdSvVOazyvlfG_73Y6lQlGYDaRBDZCUplMVHQlOF5O19r3JrBrWDToxrsqGdzCy-v7JYosUKlzFRcJcxY0Xs3nWzwaQ3waOX6nVA4jWttQy3-ZrGu3y4mo17TDEAQjXg5EUnMImq6dewmTHiVLWlpWQAXTOLtqe_f1Ijwwpm5wwL1PmGBZKZaUSuVXWte9L_gQIy0pk1jVx3TT7arfAE3uBMVacGhIp--ZIA.jpg verified: false edited: false forwardedFrom: null replyToUrl: null media: - type: photo url: >- https://cdn1.telesco.pe/file/g1Lxu_K1sEq4MksNdTbEMfTQiPfnsgdaHS2guVzZ4nE1OJO6bAskOTBi_HUhRo_4oZY43cVVdKsxzZfJ3yeFTGKIS39G-R0gGAiGn4mEa_tUGTfRyoOaPgoWJlsrxZMwpw0e_T-6UTbQ_pqbv44wthrZ3Q8swCjgEDxQB9FS9bvED2T6bPsehUk19tB6CEOtd9-EEDhCOGr-PktY5AzoeaZF06bf5g-ilxSOHSyLBiSUNcP9l2BG-q78MV_Zl8HP0OMEYa7wkp3Unjm-X3e2giiVgcCZm6XcyXfUmsirGQwYmSLOMOHVJUa3u1Bkn3H6kLj18ZM5HPq4uffXFlwT1w.jpg thumbnailUrl: null duration: null linkPreview: null reactions: [] count: 20 paging: cursor: '441' hasMore: true fetchedAt: '2026-09-14T12:14:56.940Z' meta: requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f creditsCharged: 1 creditsRemaining: 4999 cached: false '401': description: Missing, invalid, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: API key required — pass it in the `x-api-key` header. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '402': description: Not enough credits for this request. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_CREDITS message: >- This request costs 1 credit, but your balance is 0. Top up to continue. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '404': description: Channel not found / private / no public preview. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: >- The requested content was not found (it may not exist, be deleted, or be private). requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '422': description: Invalid query parameters (bad handle or non-numeric cursor). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: VALIDATION_ERROR message: Request validation failed requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: - path: url message: Required '429': description: Over the per-minute rate limit — honour `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMITED message: >- Rate limit exceeded — max 100 requests per 60s. Retry in ~30s. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '502': description: Upstream block. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UPSTREAM_BLOCKED message: >- The source was temporarily unavailable. Please try again shortly. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f components: schemas: Error: type: object properties: error: type: object properties: code: type: string example: NOT_FOUND message: type: string example: The requested content was not found. requestId: type: string example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: type: array items: type: object description: Present on validation errors. required: - code - message - requestId required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your API key. Send it in the `x-api-key` header (or `Authorization: Bearer `). Create and manage keys from your dashboard. ````