> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram Channel Info

> Get the title, description, avatar, verification badge and subscriber count of public Telegram channels.

# Telegram Channel Info

Look up public Telegram channels by their t.me link and get back the name, description, avatar, verification badge and subscriber count. It suits channel vetting before a sponsorship, keeping a watchlist of crypto or news channels up to date, or enriching a list of channel links collected elsewhere. The raw result file also carries the number of photos, videos and links each channel has shared.

```json theme={"dark"}
{
  "urls": [
    "https://t.me/durov",
    "https://t.me/tginfo"
  ]
}
```

Provide up to 50 public Telegram channel links in urls (t.me/name or t.me/s/name). Each channel found returns one row and costs 0.5 credits; links to channels that are not public are skipped, and the task fails with a refund only when none of them can be read.

## Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use `fields` for MCP queries, `_result_fields` for typed tools, or `--result-fields` in the CLI. Declared fields remain present when their value is `null`.

| Field | Type | Nullable | Description |
| - | - | - | - |
| `id` | `string` | Yes | Unique identifier for this result item. |
| `platform` | `string` | No | Platform the result belongs to, such as `instagram` or `linkedin`. |
| `resource` | `string` | No | SocQ resource represented by the result, such as `videos` or `comments`. |
| `type` | `string` | No | Category of the result item, such as `video`, `post`, or `comment`. |
| `url` | `string` | Yes | Public URL of the result item when available. |
| `published_at` | `string` | Yes | Time the source item was published, in ISO 8601 format when available. |
| `collected_at` | `string` | No | Time SocQ collected or processed this result, in ISO 8601 format. |
| `username` | `string` | Yes | Public username or handle of the account. |
| `name` | `string` | Yes | Display name of the account or profile. |
| `text` | `string` | Yes | Biography or description of the account or profile. |
| `avatar_url` | `string` | Yes | URL of the account avatar image. |
| `cover_url` | `string` | Yes | URL of the cover image. |
| `website` | `string` | Yes | Website associated with the account, company, or advertiser. |
| `is_verified` | `boolean` | Yes | Whether the account is verified on the platform. |
| `is_private` | `boolean` | Yes | Whether the account is private. |
| `location` | `object` | Yes | Geographic location associated with the result. |
| `location.name` | `string` | Yes | Human-readable location name. |
| `location.city` | `string` | Yes | City name. |
| `location.region` | `string` | Yes | Region, state, or province name. |
| `location.country` | `string` | Yes | Country or territory name or code. |
| `location.latitude` | `number` | Yes | Latitude in decimal degrees. |
| `location.longitude` | `number` | Yes | Longitude in decimal degrees. |
| `metrics` | `object` | Yes | Counters and measurements available for the result item. |
| `metrics.followers_count` | `integer` | Yes | Number of followers. |
| `metrics.following_count` | `integer` | Yes | Number of accounts followed. |
| `metrics.posts_count` | `integer` | Yes | Number of posts or posts associated with the trend. |

The following example shows the response format for a completed task. Actual data depends on your query.

## Completed Task Response

```json theme={"dark"}
{
  "code": 200,
  "data": {
    "task_id": "example-telegram-channel-info",
    "status": "succeeded",
    "public_id": "telegram/channel-info",
    "result_count": 1,
    "credits_amount": 0.5,
    "results": {
      "limit": 50,
      "next_cursor": null,
      "has_more": false,
      "schema_id": "account",
      "schema_version": "1.0",
      "items": [
        {
          "id": "durov",
          "platform": "telegram",
          "resource": "channel-info",
          "type": "channel",
          "url": "https://t.me/durov",
          "published_at": null,
          "collected_at": "2026-11-17T23:54:08.268852Z",
          "username": "durov",
          "name": "Pavel Durov",
          "text": "Founder of Telegram.",
          "avatar_url": "https://cdn4.telesco.pe/file/R3apiW_FfdEZ-QxrznoIlubSq-u342xJH9mJcrYLm_nBzXv4jKagyJtfHUWZZpOY36xoxYa5EGLm5mn3E5vPeb4KLyRIGJ6l4oGifS_3OrSMftSvA2BjBQrNDaPTA168cmG542BBicmUZMdheNvWrdRM-8UUpzsZlO5T0od09vQ_xSKuHJm5LV2Qf0JJIh1qbrkKxpGDrOxj224clzqUo2lFSh7mRsaPlXfvAd_2CN_xnLtpNPUocUNE9ecXYynnJh0G5Gcp4nUsD3mInJT0YRa76iRMsZNSXQ2nynOSeMDuzD3Gr0var4gmgC2cJv4HkPRwWYR-1cDIGyiogCvexw.jpg",
          "cover_url": null,
          "website": null,
          "is_verified": true,
          "is_private": null,
          "location": null,
          "metrics": {
            "followers_count": 9950000,
            "following_count": null,
            "posts_count": null
          }
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml api-manual/agent-api/agent-api.json POST /v1/telegram/channel-info
openapi: 3.1.0
info:
  title: SocQ Agent API
  version: v1-87892a6484c2
  description: Asynchronous social data API generated from the SocQ Capability Registry.
servers:
  - url: https://api.socq.ai
security: []
paths:
  /v1/telegram/channel-info:
    post:
      tags:
        - telegram
      summary: Telegram Channel Info API
      description: >-
        Collect the title, description, verification and subscriber count of
        public Telegram channels.
      operationId: socq_telegram_channel_info
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              additionalProperties: false
              properties:
                callback_url:
                  type: string
                  format: uri
                urls:
                  type: array
                  items:
                    type: string
                    minLength: 1
                  minItems: 1
                  description: >-
                    Links to public Telegram channels, up to 50, such as
                    https://t.me/durov.
                  maxItems: 50
              required:
                - urls
              description: >-
                Provide up to 50 public Telegram channel links in urls. Each
                channel that exists returns one row with its title, description,
                avatar, verification and subscriber, photo, video and link
                counts.
      responses:
        '200':
          description: Task accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSubmitResponse'
        '422':
          description: Input validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentValidationErrorResponse'
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  schemas:
    AgentSubmitResponse:
      type: object
      properties:
        code:
          type: integer
          const: 200
        data:
          type: object
          properties:
            task_id:
              type: string
            status:
              type: string
            created_time:
              type:
                - string
                - 'null'
          required:
            - task_id
            - status
    AgentValidationErrorResponse:
      type: object
      properties:
        code:
          type: integer
          const: 422
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            details:
              type: object
          required:
            - message
            - type
      required:
        - code
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.