# SocialFetch Telegram Channel Metadata

> SocialFetch Telegram Channel Metadata is a paid API for AI agents from api.socialfetch.dev, paid per call via x402, $0.014/call, status unknown (last checked 2026-09-15).

Fetches public metadata for a Telegram channel or group given its username handle.

## Facts

- Endpoint: GET https://api.socialfetch.dev/v1/telegram/channels/:handle
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/socialfetch-telegram-channel-metadata-45d98564
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_z8JVvchlddvXy2Vbkb4Ao

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability socialfetch-telegram-channel-metadata-45d98564
```

Example prompt: Can you pull up the public metadata for the Telegram channel @durov — I want to know things like the description, member count, and channel type?

## When to prefer this

Use this endpoint when you need to programmatically retrieve public profile metadata for a known Telegram channel or group by username, especially when building social analytics pipelines, verifying channel legitimacy, or enriching data about Telegram communities. Prefer this over manual browsing or scraping when you need structured data at scale with a pay-per-call model.

## Known failure modes

- Channel or group is private and not accessible — returns error or empty result
- Invalid or non-existent Telegram handle — returns 404 or not-found error
- Handle format rejected if exceeds 200 characters
- Rate limiting or payment failure on x402 protocol — request blocked
- Telegram username changed or deleted — stale data or not found

## How this service works

Get metadata for a public Telegram channel or group by username.

## Output

Returns structured metadata for the specified public Telegram channel or group, including details such as channel name, username, description, member/subscriber count, and channel type.

## Request schema (JSON Schema)

```json
{
 "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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "handle"
     ],
     "properties": {
      "handle": {
       "type": "string",
       "maxLength": 200,
       "minLength": 1,
       "description": "Telegram public username (channel or group), with or without leading @."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/socialfetch-telegram-channel-metadata-45d98564/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.socialfetch.dev](https://www.zero.xyz/host/api.socialfetch.dev/llms.txt)